從 Linux 執行檔到遠端畫面

本教學帶你下載 rdp-cli、連線 Windows RDP 並檢查真實桌面。適用版本為 0.1.0，依據既有發布證據：Linux x86_64 組建 2026092203 通過十個系統的軟體驗收，ARM64 組建 2026092301 通過包括樹莓派 4 與 DGX Spark 的十二個環境。本文不代表新一輪實測，也不宣稱所有 Linux 發行版均已驗證。

選擇架構並核對檔案

在將要執行 rdp-cli 的 Linux 電腦輸入：

uname -m

結果是 x86_64 時，從下載頁選 Linux x86_64；是 aarch64 時選 Linux ARM64。ARM 硬體執行 32 位元系統不在此 ARM64 版本範圍；執行 macOS 的 Mac 請選 macOS 套件。只需下載執行檔，獨立原始碼與授權材料並非執行必要附件。

執行前，將 SHA-256 輸出與下載頁同架構檔案詳情核對。x86_64 使用：

sha256sum ./rdp-cli-linux-x86_64

摘要完全一致後，再設定執行權限並查看版本：

chmod u+x ./rdp-cli-linux-x86_64
./rdp-cli-linux-x86_64 --version

ARM64 使用：

sha256sum ./rdp-cli-linux-arm64

摘要完全一致後，再設定執行權限並查看版本：

chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --version

--version 應回傳 JSON 版本資料。產品是單一靜態 ELF，可用一般使用者執行，不需要管理員安裝；原生檢視器仍使用目前桌面的顯示服務。已驗證的範圍不表示所有桌面、核心及音效裝置都已通過。

在 Bash 中連線

Windows 伺服器須已啟用 RDP，允許該帳號遠端登入，且可透過預定網路或 VPN 從本機連線。安裝用戶端不會替你啟用 Windows 服務。

在執行檔目錄使用 Bash 執行下文。ARM64 請將第一行改為 rdp_cli=./rdp-cli-linux-arm64，並將 192.0.2.20、USER 替換成獲授權的目標與帳號。密碼輸入不會顯示字元。

rdp_cli=./rdp-cli-linux-x86_64
IFS= read -r -s -p 'Password: ' rdp_password
printf '\n'
printf '%s' "$rdp_password" | "$rdp_cli" connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password

後續保持同一終端，讓 rdp_cli 變數有效。管線傳送密碼後會結束標準輸入。網域帳號可加 --domain DOMAIN，不要合併多種密碼來源。RDP 目前預設 --cert-policy ignore；請查 connect --help 並依環境設定憑證驗證。憑證原則不能修復網路不通或帳密錯誤。

閱讀 JSON，失敗時檢查 error.code 與 error.message；成功則把回傳的 data.session 儲存為 SESSION。

檢查狀態與第一張 PNG

"$rdp_cli" status --session SESSION
"$rdp_cli" screenshot --session SESSION --out first-screen.png

核對連線及控制狀態，使用影像工具開啟 first-screen.png，認清實際畫面後再決定下一步。已連線仍可能顯示登入、歡迎畫面或忙碌的應用程式。保留畫面回應的 data.observation，供後續依據此畫面的輸入使用；它不是永久工作階段 ID。

畫面擷取及輸入不要求本機視窗。人要從 Linux 桌面觀看同一工作階段時執行：

"$rdp_cli" watch --session SESSION --viewer window

視窗預設唯讀，人工接管須明確操作。關閉唯讀檢視器會保留連線；持有控制權的視窗失去連線後，輸入維持暫停。重新連線或交還控制後，先取得新畫面並遵守目前控制狀態。

按照具體錯誤處理

  • 執行檔格式錯誤： 核對 uname -m 與下載架構；x86_64 與 ARM64 不能互換。
  • 權限不足： 檢查執行權限與檔案系統是否允許執行。選擇合適的使用者目錄，不要用提權代替檢查。
  • 連線或認證錯誤： 檢查路由、連接埠、Windows RDP 服務、帳號權限與回傳錯誤。不要反覆輸入密碼，也不要因無關錯誤啟用舊版 TLS。
  • 無桌面時出現 SDL_INIT_FAILED： 原生檢視器需要顯示工作階段；無圖形介面的 CLI 畫面擷取仍可使用。檢視器失敗不等於 RDP 失敗。
  • CREDENTIAL_STORE_FAILED： 儲存憑證需用到本機 Secret Service。服務不可用時，可改用適合的支援來源如 --password-stdin，不能宣稱憑證已儲存。

下一步閱讀快速入門、命令參考或 RDP 檔案上傳與下載。檔案交換另須伺服器允許磁碟機重新導向與呼叫端的檔案權限。