--- title: 網頁控制台 weight: 10 description: "RustDesk 的網頁控制台文檔，提供安裝、設定、部署與疑難排解指南。" keywords: ["rustdesk web console", "rustdesk server pro console", "rustdesk port 21114", "rustdesk device management", "rustdesk admin console"] --- ## 快速回答 RustDesk Server Pro Web 主控台是管理使用者、裝置、群組、授權、設定、Relay、日誌與 API Token 的核心位置。新管理員應先處理登入、授權、郵件與存取設定，再做更大範圍的變更。 ## 關鍵重點 - 先確認登入與授權正常 - 然後檢查使用者、裝置、群組與策略 - 只有在基礎存取正常後，再設定郵件、Relay 與 API Token 網頁控制台整合在 RustDesk 伺服器專業版中，由 `21114` 連接埠提供服務。 功能： - 瀏覽裝置 - 新增/修改使用者和使用者群組 - 修改裝置存取權限 - 瀏覽裝置連線記錄和其他記錄 - 更新設定 - 管理客戶端設定同步策略 - 管理共享通訊錄 - 產生自訂客戶端 ## 登入 網頁控制台的預設連接埠是 21114。在瀏覽器中輸入 `http://<伺服器 ip>:21114` 進入控制台頁面，如下圖所示。預設管理員使用者名稱/密碼是 `admin`/`test1234`： ![](/docs/en/self-host/rustdesk-server-pro/console/images/console-login.png) 如果您需要 HTTPS 支援，請安裝如 `Nginx` 的網頁伺服器，或在 Windows 上使用 `IIS`。 登入後請務必變更密碼，在右上角的帳號選單中選擇 `設定` 進入密碼修改頁面，如下圖所示。您也可以建立另一個管理員帳號並刪除這個。建議啟用電子郵件登入驗證。 ![](/docs/en/self-host/rustdesk-server-pro/console/images/console-home.png?v2) 非管理員使用者也可以登入查看他們的裝置和記錄，變更他們的使用者設定。 ## 自動設定 點選 `Windows EXE` 您將能夠取得您自己的 RustDesk 伺服器專業版的設定，這將協助設定您的客戶端。 對於 Windows 客戶端，您可以省略自訂伺服器設定，將設定資訊放在 `rustdesk.exe` 檔案名稱中。如上所示，請進入控制台歡迎頁面並點選 `Windows EXE`。**需要客戶端 ≥ 1.1.9。** 您可以結合[客戶端設定](https://rustdesk.com/docs/zh-tw/self-host/client-configuration/)和[部署腳本](https://rustdesk.com/docs/zh-tw/self-host/client-deployment/)來設定您的客戶端。 ## 建立除預設 `admin` 使用者之外的新使用者 {{% notice note %}} `個人版` 方案沒有此功能。 {{% /notice %}} 1. 點選左側選單的 `使用者`。 2. 建立另一個啟用了 `管理員` 權限的帳號。 3. 使用新的管理員帳號登入。 4. 在 `使用者` 頁面刪除 `admin`。 ## 建立新使用者 1. 點選左側選單的 `使用者`。 2. 建立新使用者。 3. 選擇他們應該所屬的群組（如果需要新增新群組，請繼續閱讀）。 ## 新增新群組 1. 點選左側選單的 `群組`。 2. 建立新群組。 3. 建立後，您可以允許群組之間相互存取，點選 `編輯`。 4. 選擇您想要存取的相關群組（它會自動將它們新增到相應的群組中）。 ## 設定多個中繼伺服器 1. 進入左側選單的 `設定`。 2. 點選子選單的 `中繼`。 3. 點選 `中繼伺服器` 旁邊的 `+`。 4. 在現在顯示的方塊中輸入中繼伺服器 DNS 位址或 IP 位址，然後按 Enter。 5. 如果您有多個中繼伺服器，可以繼續點選 `+` 並根據需要調整地理位置設定（記住並將您的金鑰複製到其他伺服器）。 ## 設定或變更授權 1. 進入左側選單的 `設定`。 2. 點選子選單的 `授權`。 3. 點選 `編輯` 並貼上您的授權碼。 4. 點選 `確定`。 ## 檢視記錄 點選左側的 `記錄`。 ## 設定電子郵件 以 Gmail 為例 1. 進入左側選單的 `設定`。 2. 點選子選單的 `SMTP`。 3. 輸入 SMTP 位址 `smtp.gmail.com`。 4. 在 `SMTP 連接埠` 中輸入連接埠 587。 5. 在 `郵件帳號` 中輸入 Gmail 帳號，例如 `myrustdeskserver@gmail.com`。 6. 輸入您的密碼（您可能需要應用程式專用密碼）。 7. 在 `寄件者` 中輸入您的 Gmail 帳號，例如 `myrustdeskserver@gmail.com`。 8. 點選 `檢查` 儲存。 ## 透過 Web 控制台分配設備使用者/策略/設備群組 使用者是已登入該設備的 RustDesk 使用者，或可透過點擊設備旁的 **編輯**，在 **使用者** 欄位中從下拉選單選擇使用者來分配。 也可以透過在 **使用者列表** 點擊 **更多 → 分配設備**，批次將設備分配給使用者。 若要將設備加入設備群組，可在 **設備列表** 中點擊設備旁的 **編輯**，修改 **群組**，或前往 **設備群組** 列表，點擊群組名稱並調整該群組內的設備。 若要將策略分配給設備，將滑鼠移至 **策略** 列表右側，並在選單中點擊 **編輯設備**、**編輯使用者** 或 **編輯設備群組**，將對應的設備、使用者設備或群組設備加入所選策略。 --- ## API Token 首先，需前往 **設定 → Token → 建立**，並建立擁有所需權限的權杖：**設備、審計日誌、使用者、群組、策略、通訊錄**。 建立後，可透過 **命令列** 或 **Python CLI** 使用這些權杖，執行擁有相應權限的操作。 ### 透過命令列使用Token分配 也可以使用 RustDesk 可執行檔搭配 `--assign` 參數進行分配。 這可直接透過命令列將使用者、策略、通訊錄或設備群組分配給設備。 **範例：** "C:\Program Files\RustDesk\rustdesk.exe" --assign --token --user_name 支援參數 | 參數 | 說明 | RustDesk Server Pro | RustDesk Client | | --------------------------------------- | ---------------------------------------- | ----------------- | --------------- | | `--user_name ` | 將使用者分配給設備 | | | | `--strategy_name ` | 將策略分配給設備 | | | | `--address_book_name ` | 將設備分配給通訊錄 | | | | `--address_book_tag ` | 使用通訊錄標籤進行分配 | | | | `--address_book_alias ` | 使用通訊錄別名進行分配 | 1.5.8 | 1.4.1 | | `--address_book_password ` | 設定通訊錄條目的密碼 | 1.6.6 | 1.4.3 | | `--address_book_note ` | 設定通訊錄條目的備註 | 1.6.6 | 1.4.3 | | `--device_group_name ` | 將設備分配到設備群組 | | | | `--note ` | 為設備添加備註 | 1.6.6 | 1.4.3 | | `--device_username ` | 設定設備使用者名稱 | 1.6.6 | 1.4.3 | | `--device_name ` | 設定設備名稱 | 1.6.6 | 1.4.3 | Windows 命令列預設不會輸出結果。若要查看輸出，可使用： "C:\Program Files\RustDesk\rustdesk.exe" ... | more "C:\Program Files\RustDesk\rustdesk.exe" ... | Out-String 詳情參考 [這裡](https://github.com/rustdesk/rustdesk/discussions/6377#discussioncomment-8094952)。 ### Python CLI 管理工具 #### 使用者管理 (`users.py`) **顯示幫助：** `./users.py -h` **查看使用者：** `./users.py --url --token view [--name ] [--group_name ]` **篩選條件：** - `--name`：使用者名稱（模糊搜尋） - `--group_name`：使用者群組名稱（精確匹配） **範例：** `./users.py --url https://example.com --token view --group_name Default` **基本操作：** - **停用使用者：** `./users.py --url --token disable --name testuser` - **啟用使用者：** `./users.py --url --token enable --name testuser` - **刪除使用者：** `./users.py --url --token delete --name testuser` **使用者建立和邀請：** - **建立新使用者：** `./users.py --url --token new --name username --password 'password123' --group_name Default [--email user@example.com] [--note "備註"]` 必要參數：`--name`、`--password`、`--group_name` 選用參數：`--email`、`--note` - **透過電子郵件邀請使用者：** `./users.py --url --token invite --email user@example.com --name username --group_name Default [--note "備註"]` 必要參數：`--email`、`--name`、`--group_name` 選用參數：`--note` **2FA 和安全操作：** - **啟用 2FA 強制要求：** `./users.py --url --token enable-2fa-enforce --name username --web-console-url ` 必要參數：`--web-console-url` - **停用 2FA 強制要求：** `./users.py --url --token disable-2fa-enforce --name username [--web-console-url ]` 選用參數：`--web-console-url` - **重設 2FA：** `./users.py --url --token reset-2fa --name username` - **停用電子郵件驗證：** `./users.py --url --token disable-email-verification --name username` - **強制登出：** `./users.py --url --token force-logout --name username` **注意事項：** - 當操作多個使用者時（透過篩選器匹配），系統會提示確認 - 如果沒有匹配的使用者，將顯示 "Found 0 users" --- #### 使用者群組管理 (`user_group.py`) **顯示幫助：** `./user_group.py -h` **查看使用者群組：** `./user_group.py --url --token view [--name ]` **範例：** `./user_group.py --url https://example.com --token view --name "銷售團隊"` **群組操作：** - **建立使用者群組：** `./user_group.py --url --token add --name "群組名稱" [--note "描述"] [--accessed-from ''] [--access-to '']` 帶存取控制的範例： `./user_group.py --url --token add --name "工程部" --accessed-from '[{"type":0,"name":"管理層"}]' --access-to '[{"type":1,"name":"開發伺服器"}]'` - **更新使用者群組：** `./user_group.py --url --token update --name "群組名稱" [--new-name "新名稱"] [--note "新備註"] [--accessed-from ''] [--access-to '']` - **刪除使用者群組：** `./user_group.py --url --token delete --name "群組名稱"` 支援逗號分隔的多個群組名稱：`--name "群組1,群組2,群組3"` **群組內使用者管理：** - **查看群組內使用者：** `./user_group.py --url --token view-users [--name ] [--user-name ]` 篩選條件： - `--name`：群組名稱（精確匹配，選用） - `--user-name`：使用者名稱（模糊搜尋，選用） 範例： `./user_group.py --url --token view-users --name Default --user-name john` - **新增使用者到群組：** `./user_group.py --url --token add-users --name "群組名稱" --users "user1,user2,user3"` **存取控制參數：** - `--accessed-from`：定義誰可以存取此使用者群組的 JSON 陣列 - Type 0 = 使用者群組（例如：`[{"type":0,"name":"管理員"}]`） - Type 2 = 使用者（例如：`[{"type":2,"name":"john"}]`） - `--access-to`：定義此使用者群組可以存取什麼的 JSON 陣列 - Type 0 = 使用者群組（例如：`[{"type":0,"name":"支援"}]`） - Type 1 = 設備群組（例如：`[{"type":1,"name":"伺服器"}]`） **注意：** 使用單引號包圍 JSON 陣列以避免 shell 解析問題。 **權限要求：** - `view/add/update/delete/add-users` 命令需要 **使用者群組權限** - `view-users` 命令需要 **使用者權限** --- #### 設備群組管理 (`device_group.py`) **顯示幫助：** `./device_group.py -h` **查看設備群組：** `./device_group.py --url --token view [--name ]` **範例：** `./device_group.py --url https://example.com --token view` **群組操作：** - **建立設備群組：** `./device_group.py --url --token add --name "群組名稱" [--note "描述"] [--accessed-from '']` 範例： `./device_group.py --url --token add --name "生產環境" --accessed-from '[{"type":0,"name":"管理員"}]'` - **更新設備群組：** `./device_group.py --url --token update --name "群組名稱" [--new-name "新名稱"] [--note "新備註"] [--accessed-from '']` - **刪除設備群組：** `./device_group.py --url --token delete --name "群組名稱"` 支援逗號分隔的多個群組名稱：`--name "群組1,群組2,群組3"` **群組內設備管理：** - **查看群組內設備：** `./device_group.py --url --token view-devices [篩選條件]` 可用的篩選條件： - `--name`：設備群組名稱（精確匹配） - `--id`：設備 ID（模糊搜尋） - `--device-name`：設備名稱（模糊搜尋） - `--user-name`：使用者名稱/擁有者（模糊搜尋） - `--device-username`：設備上登入的使用者名稱（模糊搜尋） 範例： ```bash # 查看群組內所有設備 ./device_group.py --url --token view-devices --name 生產環境 # 按設備名稱搜尋 ./device_group.py --url --token view-devices --device-name server # 組合篩選條件 ./device_group.py --url --token view-devices --name 生產環境 --user-name john ``` - **查看可存取的設備群組：** 顯示目前使用者可存取的所有設備群組。 - **新增設備到群組：** `./device_group.py --url --token add-devices --name "群組名稱" --ids "deviceid1,deviceid2"` - **從群組中移除設備：** `./device_group.py --url --token remove-devices --name "群組名稱" --ids "deviceid1,deviceid2"` **存取控制參數：** - `--accessed-from`：定義誰可以存取此設備群組的 JSON 陣列 - Type 0 = 使用者群組（例如：`[{"type":0,"name":"工程師"}]`） - Type 2 = 使用者（例如：`[{"type":2,"name":"admin"}]`） **權限要求：** - `view/add/update/delete/add-devices/remove-devices` 命令需要 **設備群組權限** - `view-devices` 命令需要 **設備權限** --- #### 設備管理 (`devices.py`) **顯示幫助：** ./devices.py -h **查看設備：** ./devices.py --url --token view [--id ] [--device_name ] [--user_name ] [--group_name ] [--device_group_name ] [--offline_days ] **篩選條件：** --id : 設備 ID --device_name : 設備名稱 --user_name : 分配的使用者 --group_name : 使用者群組 --device_group_name : 設備群組 --offline_days : 離線天數 **範例：** ./devices.py --url https://example.com --token view --user_name mike **操作：** `view` 可替換為 `enable`、`disable`、`delete` 或 `assign`。 **範例（分配設備）：** ./devices.py --url https://example.com --token assign --device_name PC01 --assign_to user_name=mike --- #### 通訊錄管理 (`ab.py`) **顯示幫助：** ./ab.py -h **查看共享通訊錄：** ./ab.py --url --token view-ab [--ab-name ] **取得個人通訊錄 GUID：** ./ab.py --url --token get-personal-ab **新增共享通訊錄：** ./ab.py --url --token add-ab --ab-name [--note ] [--password ] **更新或刪除共享通訊錄：** ./ab.py --url --token update-ab --ab-guid [--ab-update-name ] [--note ] ./ab.py --url --token delete-ab --ab-guid **查看通訊錄中的 peer：** ./ab.py --url --token view-peer --ab-guid [--peer-id ] [--alias ] **新增、更新或刪除 peer：** ./ab.py --url --token add-peer --ab-guid --peer-id [--alias ] [--note ] [--tags tag1,tag2] ./ab.py --url --token update-peer --ab-guid --peer-id [--alias ] [--note ] [--tags tag1,tag2] ./ab.py --url --token delete-peer --ab-guid --peer-id **標籤管理：** ./ab.py --url --token view-tag --ab-guid ./ab.py --url --token add-tag --ab-guid --tag-name [--tag-color 0xFF00FF00] ./ab.py --url --token update-tag --ab-guid --tag-name --tag-color 0xFFFF0000 ./ab.py --url --token delete-tag --ab-guid --tag-name **存取規則管理：** ./ab.py --url --token view-rule --ab-guid ./ab.py --url --token add-rule --ab-guid [--rule-type user|group|everyone] [--rule-user ] [--rule-group ] --rule-permission ro|rw|full ./ab.py --url --token update-rule --rule-guid --rule-permission rw ./ab.py --url --token delete-rule --rule-guid **範例（為使用者 "mike" 新增唯讀規則）：** ./ab.py --url https://example.com --token add-rule --ab-guid --rule-user mike --rule-permission ro --- #### 策略管理 (`strategies.py`) **顯示幫助：** `./strategies.py -h` **列出所有策略：** `./strategies.py --url --token list` **查看指定策略：** ```bash # 通過名稱 ./strategies.py --url --token view --name "Default" # 通過 GUID ./strategies.py --url --token view --guid "01983006-fcca-7c12-9a91-b1df483c6073" ``` **啟用或禁用策略：** ```bash ./strategies.py --url --token enable --name "策略名稱" ./strategies.py --url --token disable --name "策略名稱" ``` **分配策略到設備、使用者或設備群組：** ```bash # 分配到設備（使用設備 ID） ./strategies.py --url --token assign --name "Default" --peers "1849118658,1337348840" # 分配到使用者（使用使用者名稱） ./strategies.py --url --token assign --name "Default" --users "admin,user1" # 分配到設備群組（使用群組名稱） ./strategies.py --url --token assign --name "Default" --device-groups "device_group1,Production" # 混合分配 ./strategies.py --url --token assign \ --name "Default" \ --peers "1849118658" \ --users "admin" \ --device-groups "device_group1" ``` **取消分配策略：** ```bash # 取消設備的策略 ./strategies.py --url --token unassign --peers "1849118658,1337348840" # 取消使用者的策略 ./strategies.py --url --token unassign --users "admin" # 取消設備群組的策略 ./strategies.py --url --token unassign --device-groups "device_group1" ``` **注意事項：** - 腳本支援使用者和設備群組的名稱或 GUID - 設備 ID 會自動轉換為 GUID - 所有 assign/unassign 操作都支援同時操作多個目標 **權限要求：** - `list/view/enable/disable/assign/unassign` 命令需要 **策略權限** - `--peers` 需要 **設備權限:r**（用於 ID 到 GUID 的查找） - `--users` 需要 **使用者權限:r**（用於使用者名稱到 GUID 的查找） - `--device-groups` 需要 **設備群組權限:r**（用於群組名稱到 GUID 的查找） --- #### 稽核 (`audits.py`) **顯示幫助：** ./audits.py -h **查看連線稽核：** ./audits.py --url --token view-conn [--remote ] [--conn-type ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **查看檔案稽核：** ./audits.py --url --token view-file [--remote ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **查看警示稽核：** ./audits.py --url --token view-alarm [--device ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **查看控制台稽核：** ./audits.py --url --token view-console [--operator ] [--page-size ] [--current ] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago ] **篩選條件：** --remote : peer ID（連線或檔案稽核用） --conn-type : 0=遠端桌面, 1=檔案傳輸, 2=端口傳輸, 3=觀看攝影機, 4=終端機 --device : 設備 ID（警示稽核用） --operator : 操作者使用者名稱（控制台稽核用） --created-at : 本地時間篩選，例如 "2025-09-16 14:15:57" --days-ago : 篩選 n 天內的紀錄 --page-size / --current : 分頁 **範例：** ./audits.py --url https://example.com --token view-conn --remote 123456789 --days-ago 7 ## 搜尋裝置 1. 進入裝置頁面。 2. 在裝置名稱搜尋欄位中輸入名稱並點選 `查詢` 或按 Enter。 3. 要使用萬用字元，請在搜尋詞的開頭、結尾或兩端新增 `%`。