logo
icon

RustDesk Server

セルフホスト型の RustDesk リモートデスクトップサーバー。公式の hbbs/hbbr(ランデブー・リレー)に加え、 ユーザーとデバイスを管理するための自作 Rust API と Web 管理ダッシュボードを含みます。

template cover
展開済み1
発行者zeaburd1FG
作成日2026-08-06
タグ
Remote DesktopNetworking

RustDesk Server

セルフホスト型の RustDesk リモートデスクトップサーバーです。構成:

  • hbbs / hbbr — 公式の RustDesk ID/ランデブーサーバーとリレーサーバー(rustdesk-server、GPL-3.0)。
  • api — ユーザー/デバイス管理用の自作 Rust API サーバー(MySQL を使用)。
  • web — Web 管理ダッシュボード(nginx + 静的 SPA)。ユーザー、デバイス、アドレス帳を管理。
  • mysql — API サーバー用データベース。

デプロイ後の設定

  1. https://<あなたのドメイン> を開いて web 管理ダッシュボードにアクセスし、api サービスの環境変数にある ADMIN_USER / ADMIN_PASS でログインします(デフォルトユーザーは admin、パスワードは自動生成された ${PASSWORD}api サービスの変数タブで確認してください)。
  2. hbbshbbr サービスの「ネットワーク」タブで、外部に転送されているホスト/ポート (hbbs は 21115/21116、hbbr は 21117)を確認します。 3.(任意・推奨)hbbs/hbbr は生の TCP/UDP を使用するため、Zeabur は直接ドメインを紐付けられません ——外部ホストは生の IP で、再デプロイ時に変わることがあります。ID_SERVER_DOMAIN / RELAY_SERVER_DOMAIN を設定した場合は、それぞれのドメインの DNS A レコードを手順 2 で 確認したホストへ向けて作成してください。以降は下記ポートに固定ドメインで接続できます。
  3. RustDesk クライアントの「設定 → ネットワーク」で以下を設定します:
    • ID サーバー: <ID_SERVER_DOMAIN、または hbbs の外部ホスト>:<hbbs 21116 の外部ポート>
    • リレーサーバー: <RELAY_SERVER_DOMAIN、または hbbr の外部ホスト>:<hbbr 21117 の外部ポート>
    • API サーバー: https://<あなたのドメイン>web サービスが /api/api へリバースプロキシします)
    • キー: hbbs は初回起動時に Ed25519 鍵ペアを自動生成し、自身のデータボリュームに (id_ed25519.pub / id_ed25519 として)永続化します。hbbs サービスでシェルを開き (Zeabur の Shell/exec 機能)、cat id_ed25519.pub を実行すると値を取得できます。 必須項目です——一致するキーを持たないクライアントは拒否されます。

セキュリティに関する注意

hbbs は初回起動時に自身の Ed25519 鍵ペアを自動生成し、マウントされたデータボリュームに永続化 するため、再起動や再デプロイをしても失われず、手動設定も不要です。クライアントは対応する公開鍵 (id_ed25519.pub、取得方法は上記参照)を使って hbbs に登録する必要があります。

hbbr はキーを設定せずに起動します。これは RustDesk 本家のデフォルト動作で、クライアントはそもそも hbbs のキーがないとセッション登録できないため、hbbr 側ではキー検証を行いません。hbbr でも リレーキーの検証を有効にしたい場合は、hbbsid_ed25519 / id_ed25519.pubhbbr の データボリュームにコピーし、hbbr の起動コマンドに -k <そのキー> を自分で追加してください。

キーをローテーションするには、hbbs サービスのデータボリュームから id_ed25519 / id_ed25519.pub を削除して hbbs を再起動すれば、新しい鍵ペアが自動生成されます。

ライセンス

  • hbbs/hbbr は公式の RustDesk サーバーバイナリで、GPL-3.0 ライセンスです。ソース: https://github.com/rustdesk/rustdesk-server
  • apiweb はこのデプロイ用に作成された独自コンポーネントです。