docs: add explicit client deployment instructions

Signed-off-by: 21pages <sunboeasy@gmail.com>
This commit is contained in:
21pages
2026-06-10 23:52:50 +08:00
parent eda8e95b3f
commit dc11232bad
11 changed files with 418 additions and 0 deletions
@@ -381,3 +381,41 @@ fi
echo "パスワード: $rustdesk_pw"
echo "..............................................."
```
## 新しいデバイスの明示的なデプロイ
既定では、RustDesk クライアントはセルフホストサーバーに初めて接続したときに、そのサーバーへ登録されます。通常モードでは追加のデプロイ手順は不要です。
サーバーの Web コンソールで **設定 → その他 → 新しいデバイスにデプロイを必須にする** を有効にすると、新しいデバイスはこのサーバーに登録する前に明示的にデプロイする必要があります。
サーバーの Web コンソールで管理者アカウントを使用して API トークンを作成し、RustDesk をインストールしてセルフホストサーバーを使用するように設定した後、各新規デスクトップデバイスでデプロイコマンドを実行します。
### Windows、macOS、Linux
Windows では、コマンド プロンプトまたは PowerShell を管理者として実行します。
```bat
rustdesk --deploy --token <api_token>
```
macOS と Linux では、`sudo` を付けてコマンドを実行します。
```sh
sudo rustdesk --deploy --token <api_token>
```
### 任意のカスタム ID
特定の RustDesk ID でデバイスをデプロイするには、`--id <custom_id>` を追加します。
```sh
rustdesk --deploy --token <api_token> --id <custom_id>
```
その ID がすでに別のマシンで使用されている場合、デプロイは失敗し、RustDesk は ID がすでに使用中であることを表示します。
### Android
Android ではコマンドラインのデプロイフローは使用しません。サーバーがデプロイを要求していて Android クライアントがまだデプロイされていない場合、RustDesk は **Deploy** プロンプトを表示します。**OK** をタップし、デプロイダイアログに API トークンを入力し、必要に応じてカスタム ID を入力します。同じダイアログは **設定 → Deploy** から手動で開くこともできます。
デプロイに成功すると、デバイスはサーバーのデバイス一覧に追加され、クライアントは通常どおり登録できます。