中繼連線服務的用途
裝置優先直接連線;無法直連時,中繼服務轉送已授權連線的畫面、聲音和操作資料。將自己的中繼伺服器加入 Mac 和 iPad 的「連線服務」,即可作為備用連線通道。本手冊的下載、設定和啟動步驟均用於中繼服務。
下載與準備
按伺服器架構選擇 Linux x86_64 或 ARM64 套件。交付檔案應包含 remoscreen-service、remoscreen-setup、設定範本、本手冊、版本與原始碼識別碼、SHA256SUMS。下載後先核對發布頁提供的總和檢查碼,再解壓縮到新的版本目錄,保留上一版本。
準備 Linux 伺服器、可解析到它的網域,以及與網域一致的有效 HTTPS 憑證。為服務建立獨立的低權限執行使用者和持久資料目錄。服務程式應有執行權限;狀態目錄僅執行使用者可存取,產生的金鑰檔案應為 0600。
下面範例使用 connect.example.com、HTTPS 8443 和中繼 TCP 9443。它們只是新伺服器上的範例,請先確認所用連接埠、網域、防火牆及雲端安全性群組。已有服務佔用連接埠時,應先規劃反向代理或獨立監聽位址,不要覆蓋現有服務。
初始化備用中繼
在服務執行使用者下執行初始化工具。把範例網域改成實際位址,把資料目錄改成該使用者擁有的獨立目錄:
./remoscreen-setup -directory /var/lib/remoscreen/relay \
-role relay -name RemoScreen \
-control-url https://connect.example.com:8443/v2/control \
-relay-host connect.example.com -relay-tcp-port 9443
初始化會產生服務身分、用戶端存取金鑰和所需設定。重複初始化必須沿用 relay 參數與原位址;工具不會覆蓋現有身分。不要為了更新程式而刪除資料目錄或重新產生金鑰。
啟動備用中繼
將憑證路徑替換為執行使用者可讀的實際 PEM 檔案,使用前一步的同一個資料目錄:
./remoscreen-service -service-role=relay \
-control-listen=:8443 \
-control-tls-certificate=/etc/remoscreen/fullchain.pem \
-control-tls-key=/etc/remoscreen/privkey.pem \
-service-info-config=/var/lib/remoscreen/relay/service-info.json \
-relay-control-config=/var/lib/remoscreen/relay/relay-control.json \
-relay-access-keys=/var/lib/remoscreen/relay/relay-access-keys.json \
-control-revocation-store=/var/lib/remoscreen/relay/revocations.json \
-control-primary-lock=/var/lib/remoscreen/relay/primary.lock \
-account-deletion-journal=/var/lib/remoscreen/relay/deletion-journal.json \
-usage-ledger-store=/var/lib/remoscreen/relay/usage.jsonl \
-public-host=connect.example.com -tcp-relay-listen=:9443 \
-tcp-require-local-control-allocation=true \
-relay-node-id=self-hosted -relay-region=self-hosted \
-require-commercial-subscription=false
先在前景檢查啟動結果,再交給 Linux 服務管理器管理。服務單元須使用獨立使用者、絕對程式路徑、相同參數、私有資料目錄,以及失敗重新啟動原則。憑證續期後重新啟動服務以載入新憑證。
加入 Mac 和 iPad
在伺服器本機讀取私有的 client-connection.json,取得服務位址和用戶端存取金鑰。透過可信管道提供給需要連線的使用者。在每台裝置的「連線服務」中選擇「新增伺服器」,填入位址與存取金鑰,檢查服務身分後儲存。
可匯入的用戶端設定應由應用程式的「匯出設定」功能產生。client-connection.json 是管理員讀取的初始化結果,不要把它誤當作應用程式設定匯入檔案。不要傳送 service-info.json、relay-control.json、TLS 私密金鑰或完整伺服器資料目錄。
連線優先嘗試直連,允許中繼且直連不可用時才使用此備用服務。
部署後檢查
從另一網路檢查 HTTPS 憑證與 /v2/service-info 的簽章服務身分,再在應用程式內執行伺服器連線檢查。使用已有授權的裝置,在直連不可用的測試網路中連線,確認實際使用該中繼伺服器;檢查服務日誌,確認請求正常且沒有憑證或存取金鑰錯誤。
僅處理程序執行或健康頁傳回成功不代表完整可用。檢查實際遠端畫面、鍵盤滑鼠、檔案傳輸和斷線恢復;同時核對伺服器回報版本與交付版本一致。
更新、還原和解除安裝
更新前備份服務設定、完整持久資料和上一版本程式,記錄目前版本。停止對應服務後切換到新版本,保留原資料目錄與身分,再重複部署後的檢查。失敗時停止新版本、恢復上一版本與相符的備份;涉及資料格式遷移時遵循該版本遷移說明。
解除安裝先停用並移除對應服務單元,再由管理員明確決定是否刪除程式與資料。預設保留持久資料和備份;不得連帶清理其他服務或應用程式資料。