遠端連線指南

三種方式，
連線至你的雲端 Mac

需要圖形介面，請使用 VNC 或 macOS 螢幕共享；只需執行建置與腳本，則使用 SSH。你連線的是獨享 Apple Silicon 實體節點，不是虛擬機器。

立即租用雲端 Mac 查看首次使用指南

已有訂單？請在控制台的執行個體詳細資料中確認 IP、使用者名稱與連線埠，再依下方步驟連線。本文中的主機位址與連接埠僅供設定示範。

AV / ACCESS / 03 一台節點，兩種工作方式
GUI

查看桌面並進行互動操作

本機 VNC 用戶端或 macOS 螢幕共享

SSH 通道 → 節點圖形桌面
CLI

不傳輸畫面，執行建置工作

本機終端機或 CI 執行器

SSH → 命令列與建置程序
交付方式
獨享實體機
連線資訊
控制台執行個體詳細資料
連接埠範例
SSH 22 / VNC 5900
建議方式
金鑰登入 + 圖形通道

連接埠請以執行個體實際交付資訊為準。VNC 與螢幕共享通常使用同一項圖形服務，並非兩套獨立桌面。

先依工作選擇協定

桌面操作與自動化，各自選用合適方式

圖形介面 / 跨平台

VNC

適合 Windows、Linux 與 iPad 使用者。可遠端開啟 Xcode、檢查建置設定，或處理需要點選確認的系統對話框。

  • 填入主機位址、連接埠，以及圖形服務要求的驗證資訊。
  • 建議透過 SSH 通道連線；一般 VNC 連線不等於已加密。
  • 用戶端必須支援節點啟用的驗證方式；若協定不相容，請先更換驗證設定。

適用情境：本機不是 Mac，但需要完整的 macOS 圖形介面。

圖形介面 / Mac 用戶端

macOS 螢幕共享

本機使用 Mac 時的首選。直接使用 macOS 內建的螢幕共享用戶端，不必另外安裝桌面檢視器。

  • 在 Finder 中選擇「前往 → 連接伺服器」，然後輸入 VNC 位址。
  • 使用節點提供的帳戶資訊，而非本機 Mac 的登入密碼。
  • 使用通道時，請改連本機轉送位址；遠端主機位址仍填在 SSH 指令中。

適用情境：本機也是 Mac，想減少用戶端設定步驟。

命令列 / 自動化

SSH

適合執行 xcodebuild、查看日誌、同步專案與管理執行器。不會持續傳輸桌面畫面，更適合長時間建置。

  • 先確認主機指紋，再使用密碼或金鑰驗證。
  • 互動式 SSH 工作階段中斷後，不適合作為可靠的背景工作管理方式。
  • 常駐工作請使用執行器服務或受管理的背景程序，並保存建置日誌。

適用情境：工作可寫成指令，或需要整合 CI 流水線。

依表格填寫連線資訊

四種本機系統，共用同一份節點資訊

下表以 SSH 連接埠 22、VNC 服務連接埠 5900 為例。若實際連接埠不同，請替換相應數字。圖形服務密碼是否與 SSH 使用者密碼相同，請以交付說明及節點目前設定為準，勿混用密碼。

用戶端選擇與連線欄位對照
本機系統 建議的圖形用戶端 圖形位址與連接埠設定 SSH 連線
Windows TigerVNC Viewer，請先確認支援節點目前使用的 VNC 驗證方式。 直接連線時，使用用戶端的 Host / Port 欄位。依下文建立通道後，Host 填入 127.0.0.1，Port 填入 15900。 在 Windows Terminal 使用 OpenSSH 用戶端，執行 ssh -p 22 build@HOST_IP。
Linux 使用 Remmina 的 VNC 模式，或支援相容驗證方式的 TigerVNC Viewer。 透過通道連線至 127.0.0.1:15900；若用戶端設有獨立連接埠欄位，請分別填寫，不要填入顯示編號。 使用終端機中的 OpenSSH。先完成一般 SSH 登入，再建立本機連接埠轉送。
macOS 使用系統內建的「螢幕共享」。 直接連線位址為 vnc://HOST_IP:5900；透過通道連線時則使用 vnc://127.0.0.1:15900。 在終端機使用 ssh。也可使用 open 指令開啟螢幕共享位址。
iPad 使用支援 macOS 驗證與 SSH 通道的 VNC 用戶端。 在用戶端設定 SSH 主機與驗證方式，再將圖形目標設為節點端的 127.0.0.1:5900；實際欄位名稱請以用戶端為準。 使用支援匯入金鑰的 SSH 用戶端。先確認金鑰登入成功，再啟用用戶端內建的轉送功能。
首次登入後先完成這些設定

先建立安全的連線，再開始工作

  1. 01

    確認位址與指紋

    從控制台取得節點 IP、SSH 連接埠與使用者名稱。首次連線時請確認主機指紋；若控制台未顯示指紋，請透過工單確認。重新安裝後指紋可能改變，請先核實再更新本機紀錄，不要使用停用主機驗證的參數略過警告。

  2. 02

    變更初始密碼

    首次登入後執行 passwd 變更目前使用者的密碼，並確認圖形服務採用哪種驗證方式。若使用獨立的 VNC 密碼，也請另外更新。請勿將密碼寫入程式碼儲存庫、建置日誌或共用腳本。

  3. 03

    確認金鑰登入

    將本機產生的公開金鑰加入節點的 ~/.ssh/authorized_keys，私密金鑰只留在可信任的用戶端。另開一個終端機確認登入成功後，再考慮收緊密碼驗證；先保留原有連線，避免一次變更就把自己鎖在節點外。

  4. 04

    限制圖形服務的對外連線

    只在需要桌面操作時啟用圖形服務。在 macOS 中檢查「系統設定 → 一般 → 共享 → 螢幕共享」，並限制可存取的使用者。若要關閉或調整服務，請先確認 SSH 可正常使用；SSH 通道加密不代表遠端連接埠已停止對外開放。

在本機產生金鑰，節點僅保存公開金鑰

請在本機執行下列指令。build 與 HOST_IP 都要替換為交付資訊；產生金鑰時，請為私密金鑰設定密語。

ssh-keygen -t ed25519 -f ~/.ssh/armvnc_build
cat ~/.ssh/armvnc_build.pub
ssh -p 22 build@HOST_IP

登入節點後建立目錄、編輯公開金鑰檔案並設定權限。將上一個指令輸出的完整公開金鑰單獨貼在一行，切勿貼上私密金鑰。

mkdir -p ~/.ssh
chmod 700 ~/.ssh
nano ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

返回本機並驗證：ssh -i ~/.ssh/armvnc_build -p 22 build@HOST_IP

透過 SSH 通道開啟圖形桌面

本機連接埠使用 15900，遠端目標使用 5900。轉送僅綁定本機迴圈位址，不會對同一網路中的其他裝置開放。

ssh -i ~/.ssh/armvnc_build -p 22 \
  -N -T \
  -o ExitOnForwardFailure=yes \
  -o ServerAliveInterval=30 \
  -o ServerAliveCountMax=3 \
  -L 127.0.0.1:15900:127.0.0.1:5900 \
  build@HOST_IP

指令持續執行且沒有錯誤時，請在圖形用戶端連線至本機 15900 連接埠。macOS 可另開一個終端機執行：

open 'vnc://127.0.0.1:15900'

SSH 通道不會略過 VNC 驗證。使用完畢後，請退出圖形用戶端，再於通道終端機按下 Ctrl + C 關閉轉送。

先降低畫質，再檢查網路

依工作調整畫質，不必持續傳送完整畫面

以下是問題排查的起始設定，並非頻寬或延遲保證。用戶端能否調整色彩深度與壓縮，取決於協定實作。每次只變更一項，並以同一操作比較，例如拖動 Xcode 視窗、捲動日誌或輸入一段文字。

日常修改程式碼與檢查建置

建議起始解析度
1440 × 900
建議起始色彩深度
24 位元
建議起始壓縮
自動或中等

優先確保文字清晰。若用戶端視窗太小，請先啟用等比例縮放；不要同時提高遠端解析度與本機縮放比例。

適用情境：Xcode 設定、檢查日誌、偶爾操作圖形介面。

跨區域或受限網路

建議起始解析度
1280 × 800
建議起始色彩深度
16 位元（若支援）
建議起始壓縮
高壓縮

先關閉桌面動畫與不必要的預覽。高壓縮可能降低畫面細節；雖可減少傳輸量，但無法消除網路往返延遲。

適用情境：距離較遠的節點、行動網路，或偶爾封包遺失時的臨時操作。

長時間 archive 與自動化工作

主要連線方式
SSH
桌面工作階段
需要時啟用
工作管理方式
執行器服務

不需要查看畫面時，直接保存建置日誌與產物。圖形用戶端中斷連線不代表已登出 macOS，也不應以此停止工作。

適用情境：常駐 CI、無人值守腳本、重複執行的建置工作。

選擇節點時也要考量用途：互動式桌面體驗較受你與節點之間的網路路徑影響；純建置則還需考量程式碼儲存庫下載、相依套件下載與產物上傳的路徑。不要以一次滑鼠操作是否流暢來推斷編譯效能。

依症狀縮小排查範圍

先判斷問題出在網路、驗證或桌面工作階段

先測試 SSH，再測試圖形連線。若 SSH 正常但 VNC 失敗，請優先檢查圖形服務與通道目標；若兩者都失敗，請先確認執行個體狀態、位址、本機網路與連接埠。不要一開始就重新安裝系統。

連線一再中斷，重新連線後需要重開工作嗎？

先確認是連線中斷還是工作已結束。重新建立 SSH 或圖形連線後，檢查原有程序與日誌；不要立刻再次提交 archive，以免多個工作爭用資源或重複發布產物。

使用上文的 SSH 保活參數有助判斷連線是否失效，但無法修復持續的封包遺失。請改用本機有線網路或另一個可信任的網路測試，再比較同一節點的連線狀況。長時間工作應交由執行器服務或受管理的背景程序處理，不要仰賴始終開啟的終端機。

pgrep -fl xcodebuild
tail -n 80 ~/build.log

第二個指令僅適用於你已將日誌儲存在該路徑的情況。若沒有此檔案，請查看建置腳本中設定的日誌位置。

鎖定螢幕後出現黑畫面，需要重新啟動節點嗎？

先中斷圖形用戶端連線，再重新連線，並確認沒有啟用「僅檢視」模式。檢查用戶端是否仍能顯示驗證畫面；完成驗證後出現黑畫面，與完全無法連線是兩種不同問題。

若 SSH 可用，請保留連線，並確認螢幕共享設定、可存取的使用者及目前工作階段。不要反覆強制結束系統圖形程序，也不要在建置仍在執行時直接重新啟動。若問題仍未排除，請在控制台提交工單，說明黑畫面是在鎖定螢幕之前或之後發生，並附上用戶端名稱與版本。

看得到桌面，但剪貼簿內容沒有同步

確認用戶端允許剪貼簿共享，並關閉「僅檢視」限制。先以一小段純文字測試雙向複製；圖片、檔案與格式化文字不一定能透過同一個剪貼簿通道傳輸。

確認用戶端是否需要另外傳送剪貼簿內容；必要時先中斷連線，再重新建立工作階段。傳輸專案檔案請使用 SCP 或 SFTP；不要將密碼、私密金鑰或完整簽署資料放進共用剪貼簿測試功能。

SSH 連線逾時，或出現驗證失敗

逾時通常發生在驗證之前。請確認 IP 與連接埠，檢查本機網路是否限制該連接埠，再使用詳細記錄檢視連線停在哪個步驟。若出現 Permission denied ，請優先檢查使用者名稱、公開金鑰內容、檔案權限，以及用戶端選用的私密金鑰。

ssh -v -i ~/.ssh/armvnc_build -p 22 build@HOST_IP

提交日誌前，請刪除使用者名稱、IP 與本機敏感路徑等非必要資訊，絕不可傳送私密金鑰或密碼。若主機指紋變更，請先確認是否曾重新安裝系統或變更執行個體，不要直接刪除驗證紀錄。

畫面尺寸不正確，或鍵盤符號與本機不同

畫面遭裁切時，請先檢查用戶端的視窗配合或縮放設定，再查看節點的「系統設定 → 顯示器」。只調整用戶端視窗大小，不一定會改變遠端桌面的解析度。

鍵盤輸入不正確時，請檢查本機鍵盤配置、用戶端按鍵對應與遠端輸入法。先在一般文字編輯器測試字母、數字與符號，再輸入密碼或指令；Windows 的 Ctrl / Alt 與 macOS 的 Command / Option 可能需要個別設定對應。

連線成功後，開始第一次建置

依使用指南準備環境；若遇到開通、連線或計費問題，請查看說明中心。尚未租用時，可先在下單頁選擇機型與節點。

僅支援 USDT-TRC20 與 Visa / Mastercard / Amex（透過 Stripe），以 USD 計價。實際可用的付款閘道以結帳時顯示為準。

立即租用雲端 Mac 開始第一次建置 前往說明中心