rdp-cli

Windows、Mac 與 Linux 的 RDP 命令列入門

連接一次,觀察畫面,執行命令,再檢查結果。本機查看視窗按需打開。
看看 rdp-cli 如何運作

你需要哪種 RDP 指令?

讓 AI Agent 自動操作桌面

rdp-cli 可在 Windows、macOS 和 Linux 上執行。Agent 無須開啟檢視視窗,就能連線、讀取截圖、傳送滑鼠與鍵盤操作及檔案。你可以透過 GUI 或 Web 檢視器加入同一工作階段並接管。

逐步連線 →依任務尋找指令 →

開啟遠端桌面視窗

在 Windows 上,mstsc 會開啟系統內建的遠端桌面應用程式。將 desktop.example.net 換成遠端電腦位址,再於視窗中登入。

mstsc /v:desktop.example.net

從你的電腦開始

選擇平台。
開始遠端任務。

選擇執行 rdp-cli 的電腦。
為你的 Agent 準備好遠端操作工具。

01 / 安裝與檢查

下載 EXE,打開 PowerShell。

ARM 處理器的 Windows 10 或 11 請選擇 ARM64;Intel 或 AMD 處理器的 64 位元 Windows 請選擇 x64,32 位元 Windows 請選擇 x86。下載對應的 rdp-cli.exe,在 PowerShell 中執行。

每種架構分別提供一個獨立的單檔 EXE。

PowerShell
.\rdp-cli.exe --help
02 / 連接遠端電腦

先在遠端啟用 RDP。替換 192.0.2.20 和 USER;通過不回顯的提示輸入密碼,密碼從標準輸入送入命令。儲存返回 JSON 中的 data.session。

PowerShell
$secret = Read-Host '密碼' -AsSecureString
$savedEncoding = $OutputEncoding
try {
  $OutputEncoding = [System.Text.UTF8Encoding]::new($false)
  [System.Net.NetworkCredential]::new('', $secret).Password |
    .\rdp-cli.exe connect --host 192.0.2.20 --user USER --password-stdin
} finally {
  $OutputEncoding = $savedEncoding
  $secret.Dispose()
}
03 / 獲取畫面

將 SESSION 換成連接返回的值。打開 before.png,查看目標應用和輸入位置,並儲存截圖結果中的 data.observation。

PowerShell
.\rdp-cli.exe screenshot --session SESSION --out ./before.png
04 / 操作並檢查

先從截圖確定可輸入位置,再替換 X、Y 和 OBSERVATION。點擊後重新截圖,用新的觀察值輸入;最後查看 after.png,確認遠端實際結果。

PowerShell
.\rdp-cli.exe click --session SESSION --desktop --x X --y Y --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./focused.png
.\rdp-cli.exe type --session SESSION --text "遠端任務已完成。" --observation NEW_OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./after.png
05 / 按需觀看

人想看進度時再打開同一會話,預設只讀。視窗中可暫停、接管和交還;Agent 的普通命令操作不依賴這個視窗。

PowerShell
.\rdp-cli.exe watch --session SESSION --viewer window
.\rdp-cli.exe watch --session SESSION --viewer web
01 / 安裝與檢查

打開 DMG,啟用命令行。

將 rdp-cli 拖入“應用程式”,然後在 macOS 終端(zsh)執行下面的命令。

依 Mac 的晶片選擇 DMG:Apple silicon 需 macOS 13 或以上,Intel 需 macOS 12 或以上。各版本是否可下載,以下載頁為準。

zsh
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
02 / 連接遠端電腦

先在遠端啟用 RDP。替換 192.0.2.20 和 USER;通過不回顯的提示輸入密碼,密碼從標準輸入送入命令。儲存返回 JSON 中的 data.session。

zsh
read -r -s "rdp_password?密碼: "
printf '\n'
printf '%s' "$rdp_password" | rdp-cli connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
03 / 獲取畫面

將 SESSION 換成連接返回的值。打開 before.png,查看目標應用和輸入位置,並儲存截圖結果中的 data.observation。

zsh
rdp-cli screenshot --session SESSION --out ./before.png
04 / 操作並檢查

先從截圖確定可輸入位置,再替換 X、Y 和 OBSERVATION。點擊後重新截圖,用新的觀察值輸入;最後查看 after.png,確認遠端實際結果。

zsh
rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out ./focused.png
rdp-cli type --session SESSION --text "遠端任務已完成。" --observation NEW_OBSERVATION
rdp-cli screenshot --session SESSION --out ./after.png
05 / 按需觀看

人想看進度時再打開同一會話,預設只讀。視窗中可暫停、接管和交還;Agent 的普通命令操作不依賴這個視窗。

zsh
rdp-cli watch --session SESSION --viewer window
rdp-cli watch --session SESSION --viewer web
01 / 安裝與檢查

一個檔案,直接執行

下載 Linux x86_64 檔案,授予執行權限後在終端機執行,無需管理員權限。

x86_64 下載適用於下列 Linux 系統,其他系統版本的相容性尚未驗證。

目標系統 →

Bash
chmod u+x ./rdp-cli-linux-x86_64
./rdp-cli-linux-x86_64 --help
02 / 連接遠端電腦

先在遠端啟用 RDP。替換 192.0.2.20 和 USER;通過不回顯的提示輸入密碼,密碼從標準輸入送入命令。儲存返回 JSON 中的 data.session。

Bash
IFS= read -r -s -p '密碼: ' rdp_password
printf '\n'
printf '%s' "$rdp_password" | ./rdp-cli-linux-x86_64 connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
03 / 獲取畫面

將 SESSION 換成連接返回的值。打開 before.png,查看目標應用和輸入位置,並儲存截圖結果中的 data.observation。

Bash
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./before.png
04 / 操作並檢查

先從截圖確定可輸入位置,再替換 X、Y 和 OBSERVATION。點擊後重新截圖,用新的觀察值輸入;最後查看 after.png,確認遠端實際結果。

Bash
./rdp-cli-linux-x86_64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./focused.png
./rdp-cli-linux-x86_64 type --session SESSION --text "遠端任務已完成。" --observation NEW_OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./after.png
05 / 按需觀看

人想看進度時再打開同一會話,預設只讀。視窗中可暫停、接管和交還;Agent 的普通命令操作不依賴這個視窗。

Bash
./rdp-cli-linux-x86_64 watch --session SESSION --viewer window
./rdp-cli-linux-x86_64 watch --session SESSION --viewer web
01 / 安裝與檢查

一個檔案,直接執行

為 64 位元 ARM Linux 系統下載 Linux ARM64 檔案,加入執行權限後,以一般使用者執行。

同一個靜態 ARM64 ELF 支援列出的 Linux 系統、樹莓派 4 和 DGX Spark。不支援 32 位元樹莓派系統。

目標系統 →

Bash
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help
02 / 連接遠端電腦

先在遠端啟用 RDP。替換 192.0.2.20 和 USER;通過不回顯的提示輸入密碼,密碼從標準輸入送入命令。儲存返回 JSON 中的 data.session。

Bash
IFS= read -r -s -p '密碼: ' rdp_password
printf '\n'
printf '%s' "$rdp_password" | ./rdp-cli-linux-arm64 connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
03 / 獲取畫面

將 SESSION 換成連接返回的值。打開 before.png,查看目標應用和輸入位置,並儲存截圖結果中的 data.observation。

Bash
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./before.png
04 / 操作並檢查

先從截圖確定可輸入位置,再替換 X、Y 和 OBSERVATION。點擊後重新截圖,用新的觀察值輸入;最後查看 after.png,確認遠端實際結果。

Bash
./rdp-cli-linux-arm64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./focused.png
./rdp-cli-linux-arm64 type --session SESSION --text "遠端任務已完成。" --observation NEW_OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./after.png
05 / 按需觀看

人想看進度時再打開同一會話,預設只讀。視窗中可暫停、接管和交還;Agent 的普通命令操作不依賴這個視窗。

Bash
./rdp-cli-linux-arm64 watch --session SESSION --viewer window
./rdp-cli-linux-arm64 watch --session SESSION --viewer web

示例使用文件地址和佔位帳號。用實際返回的 session 和 observation 替換佔位值;命令發出後,仍需查看新截圖確認結果。

VNC

VNC 桌面

使用你有權存取且網路可達的 VNC 服務,替換主機與連接埠。此例使用傳統 VNC 密碼驗證,連線本身未加密,請在可信任區域網路或 VPN 內使用。密碼由標準輸入提供,完成後結束輸入。將回應中的 data.session 儲存為 SESSION。Windows PowerShell 將 rdp-cli 改為 .\rdp-cli.exe;Linux 若未設定 PATH,請使用下載程式的路徑。

rdp-cli connect --protocol vnc --host 192.0.2.20 --port 5900 --password-stdin

開啟 before.png,依實際畫面選擇座標,將回應中的 data.observation 作為 OBSERVATION。每次動作後重新擷取畫面確認結果。完整連線示例與伺服器條件請見 VNC 教學。

rdp-cli screenshot --session SESSION --out before.png
rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png
以命令連線 VNC 並驗證遠端輸入 →

功能 →

Android · USB / Wi-Fi

讓 AI Agent 操作真正的 Android 手機。

透過 USB 或 Wi-Fi 連接手機。Agent 用指令觀看畫面、點擊、輸入並取回成果,你可隨時從視窗或瀏覽器查看同一工作階段。

Android 手機 · USB / Wi-Fi →

支援 Android 的下載版本: macOS · Apple silicon · macOS · Intel · Windows · x64 · Windows · x86 · Windows · ARM64 · Linux · x86_64 · Linux · ARM64

觀看畫面,再操作

擷取真實畫面,執行點擊、滑動、拖曳與雙指手勢,再以新截圖核對結果。

文字、檔案與應用程式

明確貼上中文與 emoji,傳輸檔案及資料夾,安裝、啟動或停止單一 APK 應用程式。

人與 Agent 共用工作階段

指令、原生視窗與授權瀏覽器共用持續連線;需要時隨時暫停或接管。

支援基準為 Android 12 以上。已實測裝置為執行 Android 12 的 Google Pixel 3,不代表所有品牌或後續系統版本皆已驗證。

準備手機

  1. 開啟開發人員選項與 USB 偵錯,連接資料線,在解鎖的手機上確認偵錯授權。
  2. 無線連線需開啟無線偵錯,使用手機當次顯示的配對碼及配對連接埠;連線連接埠另行讀取,無須先接 USB。
  3. Windows USB 連線需要適合手機及電腦架構的 WinUSB 驅動程式,ARM64 也需相符的驅動程式。rdp-cli 不會自動安裝驅動程式或關閉其他偵錯工具。 Linux (x86_64 / ARM64) 需要透過適當的 udev 規則或裝置群組,讓一般使用者有權存取手機 USB 裝置;以下命令使用 Bash,執行 rdp-cli 時不要加 sudo。macOS 使用系統 USB 介面。

以實際值替換 DEVICE_SERIAL、SESSION、OBSERVATION、PHONE_IP 與兩個連接埠。連線後保留 data.session,每次截圖後使用傳回的 data.observation。以傳回的 wifi: 裝置 ID 替換 wifi:PHONE_GUID;自行為 PHONE_REF 取名,用來在這台電腦儲存配對身分。出現提示時輸入當次六位配對碼,命令會經標準輸入傳送。

macOS / Linux

探索並連線

明確選擇探索結果中的裝置 ID。連線不會開啟視窗或啟用音訊。

rdp-cli android devices
rdp-cli connect --protocol adb --device usb:DEVICE_SERIAL --transport usb

觀察、操作、驗證

先查看 before.png,以該畫面的座標及觀察值操作,再查看 after.png 核對實際結果。

rdp-cli screenshot --session SESSION --out before.png
rdp-cli android touch --session SESSION --kind tap --x 300 --y 900 --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

無線連線

Wi-Fi 是 USB 的替代連線方式。如果同一手機已有 USB 工作階段,先執行 disconnect --session SESSION。明確配對,再用傳回的裝置 ID 與目前連線連接埠連線。儲存新的 data.session,重新截圖後再操作。

printf '%s' '配對碼: '
IFS= read -r -s rdp_pair_code
printf '\n'
printf '%s' "$rdp_pair_code" | rdp-cli android pair --host PHONE_IP --port PAIR_PORT --code-stdin --save-device-auth PHONE_REF
unset rdp_pair_code
rdp-cli connect --protocol adb --device wifi:PHONE_GUID --transport wifi --host PHONE_IP --port CONNECT_PORT --device-auth-ref PHONE_REF

結束工作階段

關閉手機音訊並中斷連線。已完成的檔案與使用者安裝的應用程式留在手機上。

rdp-cli audio android --session SESSION --source off
rdp-cli disconnect --session SESSION
Windows · PowerShell

探索並連線

明確選擇探索結果中的裝置 ID。連線不會開啟視窗或啟用音訊。

.\rdp-cli.exe android devices
.\rdp-cli.exe connect --protocol adb --device usb:DEVICE_SERIAL --transport usb

觀察、操作、驗證

先查看 before.png,以該畫面的座標及觀察值操作,再查看 after.png 核對實際結果。

.\rdp-cli.exe screenshot --session SESSION --out before.png
.\rdp-cli.exe android touch --session SESSION --kind tap --x 300 --y 900 --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out after.png

無線連線

Wi-Fi 是 USB 的替代連線方式。如果同一手機已有 USB 工作階段,先執行 disconnect --session SESSION。明確配對,再用傳回的裝置 ID 與目前連線連接埠連線。儲存新的 data.session,重新截圖後再操作。

$pairingCode = Read-Host '配對碼' -AsSecureString
try {
  [System.Net.NetworkCredential]::new('', $pairingCode).Password |
    .\rdp-cli.exe android pair --host PHONE_IP --port PAIR_PORT --code-stdin --save-device-auth PHONE_REF
} finally {
  $pairingCode.Dispose()
}
.\rdp-cli.exe connect --protocol adb --device wifi:PHONE_GUID --transport wifi --host PHONE_IP --port CONNECT_PORT --device-auth-ref PHONE_REF

結束工作階段

關閉手機音訊並中斷連線。已完成的檔案與使用者安裝的應用程式留在手機上。

.\rdp-cli.exe audio android --session SESSION --source off
.\rdp-cli.exe disconnect --session SESSION

使用範圍

讓 AI Agent 操作遠端裝置,你隨時加入。

連接裝置、查看畫面、傳送一小組操作,再核對成果。保留工作階段 ID;人接手並交還後,重新觀察再操作。

依作業系統和 CPU 架構下載一個執行檔。使用下列命令前,先確認下載檔案實際包含的能力。

只看需要看的區域

擷取局部或縮小畫面,與上次觀察比較;沒有變化時不重複傳回圖片。座標仍與遠端畫面對應。

等畫面變化,也等檔案傳完

等待指定區域變化或穩定,或等待連線、操作、檔案傳輸到達指定狀態。繼續前仍需核對實際成果。

一小組操作,停下來核對

組合傳送 Agent 已確定的動作,加入新觀察並停在檢查點。出錯或控制權變更就停止後續步驟;已送出的動作不會復原。

保留進度,中斷後查清再繼續

儲存任務進度、檢查點和選定畫面,匯出本機報告。中斷後先核對已完成的工作,再提交新步驟,不重送結果未知的動作。

多個 Agent 分工,人隨時接手

註冊後的 Agent 明確交接唯一控制權。人透過 GUI 或 Web 接手後,可交還給指定 Agent;Agent 重新觀察再操作。

接入 Agent,也查清連線問題

同一個檔案提供內建 MCP 和命令列。以具名連線設定檔保存參數與憑證參照,用 doctor 分層檢查連線能力。

手機主螢幕或虛擬螢幕,由你選擇

在支援的 Android 裝置上明確建立虛擬螢幕,並在其中啟動應用程式。Agent、GUI、Web 使用同一顯示目標;應用程式行為和系統音訊授權仍依裝置規則執行。

Windows · PowerShell
.\rdp-cli.exe --version
.\rdp-cli.exe --help-json
.\rdp-cli.exe screenshot --session SESSION --max-width 640
.\rdp-cli.exe screenshot --session SESSION --region X,Y,WIDTH,HEIGHT --max-width 640
.\rdp-cli.exe wait --session SESSION --condition changed --region X,Y,WIDTH,HEIGHT --timeout-ms 10000
.\rdp-cli.exe doctor --session SESSION
.\rdp-cli.exe mcp stdio
macOS / Linux
rdp-cli --version
rdp-cli --help-json
rdp-cli screenshot --session SESSION --max-width 640
rdp-cli screenshot --session SESSION --region X,Y,WIDTH,HEIGHT --max-width 640
rdp-cli wait --session SESSION --condition changed --region X,Y,WIDTH,HEIGHT --timeout-ms 10000
rdp-cli doctor --session SESSION
rdp-cli mcp stdio

Linux · X11 / SSH · Wayland RDP / VNC

讓 AI Agent 透過 X11 與 SSH 操作 Linux 應用程式

連接既有 Linux 桌面或轉送單一 X11 應用程式,以螢幕擷取與輸入命令完成任務、取回檔案,並由人加入同一工作階段接管。

下載: macOS · Apple siliconmacOS · IntelWindows · x64Windows · x86Windows · ARM64Linux · x86_64Linux · ARM64

連線前,先選一個遠端已存在且可讀寫的目錄作為 FILE_ROOT。桌面模式的 DISPLAY 與 XAUTHORITY 應從目標使用者已登入的圖形桌面內開啟終端機取得;SSH 終端機的值可能不同。值為空時,請向桌面擁有者或管理員確認。

macOS / Linux

Agent 和你共用同一工作階段

rdp-cli 讓 AI Agent 透過命令觀察並操作 Linux 應用程式。Agent 先擷取畫面,依照畫面操作,再檢查下一張畫面。你可開啟原生視窗或經授權的 Web 檢視器,觀看、暫停或接管同一工作階段。

準備已獲授權的目標

Linux 電腦需已有 SSH 存取入口及已安裝的 X11 相容應用程式。請替換範例位址、帳號、私密金鑰路徑,以及經獨立核實的 known-hosts 檔案。在 Windows PowerShell 中,將 rdp-cli 改成 .\rdp-cli.exe。先確認 --version 的 embedded_ssh、x11_desktop、x11_application 均為 true。

開啟單一應用程式

範例在 rdp-cli 內建的隔離顯示環境開啟既有 Gedit,預設不開啟本機檢視視窗。儲存回應的 data.session,以下以 SESSION 表示。即使主機平常使用 Wayland 桌面,也可如此轉送支援 X11 的應用程式。

rdp-cli connect --protocol x11 --mode application --host 192.0.2.20 --user USER --ssh-key PRIVATE_KEY --ssh-known-hosts KNOWN_HOSTS --linux-file-root FILE_ROOT --application /usr/bin/gedit --app-args '["--standalone","--new-window"]'

或連接既有 X11 桌面

填入實際 display 與既有授權檔案路徑。SSH 帳號必須有權存取該 display;通過 SSH 驗證不代表取得桌面授權。此模式加入既有桌面,不建立另一個登入工作階段。

rdp-cli connect --protocol x11 --mode desktop --host 192.0.2.20 --user USER --ssh-key PRIVATE_KEY --ssh-known-hosts KNOWN_HOSTS --linux-file-root FILE_ROOT --display DISPLAY --xauthority XAUTHORITY_PATH

觀察、操作,再驗證

查看回傳的 PNG,並儲存 data.observation。以畫面上的實際座標取代 X、Y。聚焦輸入欄位後重新擷取畫面,再使用新權杖。明確指定的剪貼簿方法會取代遠端剪貼簿,不改變本機剪貼簿。輸入回應只確認已派送,之後仍須確認畫面結果。

rdp-cli screenshot --session SESSION --out before.png
rdp-cli click --session SESSION --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out focused.png
rdp-cli linux text --session SESSION --method clipboard --text '審核已完成。' --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

取回成果檔案

在 Linux 應用程式開啟上傳結果的 remote_path,編輯、儲存後再下載成果。分別保留各次 transfer_id,等待狀態為 completed 才使用檔案。傳輸前先儲存,預設不覆寫同名檔案;發生錯誤時先查任務狀態,不要盲目重傳。

將 FILE_ROOT 替換為遠端已存在、且此 SSH 帳號可讀寫的目錄。檔案命令只存取該目錄;指定目錄不會建立目錄,也不會增加帳號權限。

rdp-cli files list --session SESSION
rdp-cli files upload --session SESSION --local ./report.txt --path report.txt
rdp-cli files status --session SESSION --transfer-id UPLOAD_TRANSFER
rdp-cli files download --session SESSION --path report.txt --local ./result.txt
rdp-cli files status --session SESSION --transfer-id DOWNLOAD_TRANSFER

讓人加入操作

需要觀看時再開啟此檢視器,它起初為唯讀。接管會停止 Agent 輸入;修正後交還控制,即可繼續同一任務。經授權的 Web 檢視器也加入同一工作階段,同時僅有一個檢視器可持有人工控制權。關閉唯讀檢視器不會中斷背景連線。

rdp-cli watch --session SESSION --viewer window

了解協定範圍

原生 X11 不提供音訊播放或麥克風重新導向。存取完整 Wayland 桌面需已有設定完成的相容 RDP 或 VNC 端點,能力以實際協商結果為準。rdp-cli 不安裝或啟用遠端服務。顯示連線中斷或遺失後,應用程式可能結束,請先儲存,不要假設程式會自動重啟或工作區會被保留。

Wayland 文字輸入取決於既有伺服器。GNOME 46 和 Krfb 23.08 可能無法映射部分 Unicode 按鍵,輸入後須核對結果。僅在該端點實際支援時使用明確的剪貼簿貼上:Plasma Wayland 上的 Krfb 可能公布剪貼簿能力卻未把內容交給應用程式。複雜輸入或快速操作應分步傳送,並檢查下一張截圖。

已實測的桌面端點: Ubuntu 24.04.5 · GNOME 46 / GNOME Remote Desktop 46.3; KDE Plasma 5.27.12 / Krfb 23.08.5.

繼續閱讀快速入門

Windows · PowerShell

Agent 和你共用同一工作階段

rdp-cli 讓 AI Agent 透過命令觀察並操作 Linux 應用程式。Agent 先擷取畫面,依照畫面操作,再檢查下一張畫面。你可開啟原生視窗或經授權的 Web 檢視器,觀看、暫停或接管同一工作階段。

準備已獲授權的目標

Linux 電腦需已有 SSH 存取入口及已安裝的 X11 相容應用程式。請替換範例位址、帳號、私密金鑰路徑,以及經獨立核實的 known-hosts 檔案。在 Windows PowerShell 中,將 rdp-cli 改成 .\rdp-cli.exe。先確認 --version 的 embedded_ssh、x11_desktop、x11_application 均為 true。

開啟單一應用程式

範例在 rdp-cli 內建的隔離顯示環境開啟既有 Gedit,預設不開啟本機檢視視窗。儲存回應的 data.session,以下以 SESSION 表示。即使主機平常使用 Wayland 桌面,也可如此轉送支援 X11 的應用程式。

.\rdp-cli.exe connect --protocol x11 --mode application --host 192.0.2.20 --user USER --ssh-key PRIVATE_KEY --ssh-known-hosts KNOWN_HOSTS --linux-file-root FILE_ROOT --application /usr/bin/gedit --app-args '["--standalone","--new-window"]'

或連接既有 X11 桌面

填入實際 display 與既有授權檔案路徑。SSH 帳號必須有權存取該 display;通過 SSH 驗證不代表取得桌面授權。此模式加入既有桌面,不建立另一個登入工作階段。

.\rdp-cli.exe connect --protocol x11 --mode desktop --host 192.0.2.20 --user USER --ssh-key PRIVATE_KEY --ssh-known-hosts KNOWN_HOSTS --linux-file-root FILE_ROOT --display DISPLAY --xauthority XAUTHORITY_PATH

觀察、操作,再驗證

查看回傳的 PNG,並儲存 data.observation。以畫面上的實際座標取代 X、Y。聚焦輸入欄位後重新擷取畫面,再使用新權杖。明確指定的剪貼簿方法會取代遠端剪貼簿,不改變本機剪貼簿。輸入回應只確認已派送,之後仍須確認畫面結果。

.\rdp-cli.exe screenshot --session SESSION --out before.png
.\rdp-cli.exe click --session SESSION --x X --y Y --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out focused.png
.\rdp-cli.exe linux text --session SESSION --method clipboard --text '審核已完成。' --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out after.png

取回成果檔案

在 Linux 應用程式開啟上傳結果的 remote_path,編輯、儲存後再下載成果。分別保留各次 transfer_id,等待狀態為 completed 才使用檔案。傳輸前先儲存,預設不覆寫同名檔案;發生錯誤時先查任務狀態,不要盲目重傳。

將 FILE_ROOT 替換為遠端已存在、且此 SSH 帳號可讀寫的目錄。檔案命令只存取該目錄;指定目錄不會建立目錄,也不會增加帳號權限。

.\rdp-cli.exe files list --session SESSION
.\rdp-cli.exe files upload --session SESSION --local ./report.txt --path report.txt
.\rdp-cli.exe files status --session SESSION --transfer-id UPLOAD_TRANSFER
.\rdp-cli.exe files download --session SESSION --path report.txt --local ./result.txt
.\rdp-cli.exe files status --session SESSION --transfer-id DOWNLOAD_TRANSFER

讓人加入操作

需要觀看時再開啟此檢視器,它起初為唯讀。接管會停止 Agent 輸入;修正後交還控制,即可繼續同一任務。經授權的 Web 檢視器也加入同一工作階段,同時僅有一個檢視器可持有人工控制權。關閉唯讀檢視器不會中斷背景連線。

.\rdp-cli.exe watch --session SESSION --viewer window

了解協定範圍

原生 X11 不提供音訊播放或麥克風重新導向。存取完整 Wayland 桌面需已有設定完成的相容 RDP 或 VNC 端點,能力以實際協商結果為準。rdp-cli 不安裝或啟用遠端服務。顯示連線中斷或遺失後,應用程式可能結束,請先儲存,不要假設程式會自動重啟或工作區會被保留。

Wayland 文字輸入取決於既有伺服器。GNOME 46 和 Krfb 23.08 可能無法映射部分 Unicode 按鍵,輸入後須核對結果。僅在該端點實際支援時使用明確的剪貼簿貼上:Plasma Wayland 上的 Krfb 可能公布剪貼簿能力卻未把內容交給應用程式。複雜輸入或快速操作應分步傳送,並檢查下一張截圖。

已實測的桌面端點: Ubuntu 24.04.5 · GNOME 46 / GNOME Remote Desktop 46.3; KDE Plasma 5.27.12 / Krfb 23.08.5.

繼續閱讀快速入門

交給你的 Agent 使用

告訴 Agent 程序路徑、獲授權的目標或已有會話,以及期望的遠端結果。可選 rdp-cli-agent 技能記錄了命令工作流,Agent 可以直接閱讀 SKILL.md;連接本身不需要安裝技能。

rdp-cli-agent / SKILL.md ↓

連接與訪問設定

RDP 證書策略目前為相容性預設使用 ignore,請查看 connect --help 並按環境配置驗證方式。官網不轉發會話,也不收集遠端憑據。瀏覽器查看器適用於區域網路/VPN,VNC 傳輸需要可信網路。

rdp-cli@weerocks.com