使用內建的螢幕共享
開啟「螢幕共享」，輸入提供的 VNC 位址與連接埠；若已建立下方的 SSH 隧道，請改用本機位址與本機連接埠。依照交付資訊完成驗證，不要輸入 SSH 私密金鑰。
適合直接操作 Xcode、Simulator 和系統設定。
連線指南 · 從交付資訊開始
取得連線資訊，三種方式連上你的 Mac mini
先透過 SSH 確認命令列連線，再開啟 VNC 桌面；若要減少對外網路的暴露，可將 VNC 導入 SSH 隧道。租用的是專屬實體機，不是虛擬機。實際位址、連接埠和帳戶資訊以控制台提供的資料為準。
還沒有機器？先選擇機型與節點。已有訂單？登入控制台，找到實例連線資訊後，從下方第一步開始。
連線資訊清單SSH → VNC → CI
先從控制台記下這四項，再開始連線。請勿透過支援工單傳送密碼或私鑰。
- 主機位址
- 實例連線資訊中的位址
- SSH 連接埠
- 實例連線資訊中的連接埠
- 登入帳戶
- 提供給你的使用者名稱
- 桌面連線
- VNC 位址與驗證資訊
先確認 SSH 登入再設定桌面與建置
01 / 命令列
先連線 SSH，再改用金鑰登入
SSH 是加密的命令列連線方式。macOS、Linux 可在終端機執行；Windows 可在 PowerShell 執行。請將範例中的位址、連接埠和使用者名稱換成控制台提供的資料。
首次登入步驟
- 01確認實例與連接埠。在控制台確認機器已交付，再複製 SSH 位址、連接埠和使用者名稱。首次出現主機指紋時，先與交付資訊核對。
- 02準備公開金鑰。在自己的電腦上產生 Ed25519 金鑰組；私密金鑰留在本機，只將以
ssh-ed25519開頭的公開金鑰加入遠端帳戶的~/.ssh/authorized_keys。 - 03開啟第二個終端機進行驗證。保持第一個連線工作階段開啟，使用新終端機確認可以透過公開金鑰登入。驗證成功後，再依照安全政策停用該帳戶的密碼登入；不要先停用密碼，再測試金鑰。
本機終端機請依交付資訊替換尖括號中的內容
ssh -p <SSH連接埠> <使用者名稱>@<主機位址>
ssh-keygen -t ed25519 -C "cloud-mac"
cat ~/.ssh/id_ed25519.pub
ssh -i ~/.ssh/id_ed25519 \
-p <SSH連接埠> <使用者名稱>@<主機位址>如果本機已有金鑰，請先確認檔名，不要覆寫現有的私密金鑰。貼上公開金鑰時請保留完整單行，並將遠端 ~/.ssh 和 authorized_keys 的權限分別設為 700 和 600。
02 / 圖形桌面
需要使用 Xcode 圖形介面時，請開啟 VNC
VNC 是將 Mac 桌面畫面傳送到電腦上的遠端控制方式。請先確認控制台提供的桌面連線位址、連接埠與驗證方式；這些資訊可能與 SSH 不同。
在 VNC 用戶端輸入連線資訊
在用戶端分別輸入主機、連接埠及提供的驗證資訊；若用戶端只接受單一位址，請依其說明使用「主機:連接埠」格式。建議使用 SSH 隧道，並將連線目標設為本機迴送位址。
用戶端協定請選 VNC；不要將 SSH 連接埠當成桌面連接埠。
畫面卡頓時，先調整這兩項
將畫質從最高調低至中等，並降低用戶端要求的影格率；先使用單一顯示器和合適的桌面解析度確認連線穩定。如果鍵盤輸入比畫面反應順暢，請優先檢查你到節點之間的網路路徑，而不是立即重新安裝開發環境。
03 / 安全連線
透過 SSH 隧道轉送 VNC
SSH 隧道會將電腦上的本機連接埠安全地轉送至遠端桌面連接埠。用戶端只需連線至本機，不必為了方便連線而另外對外開放 VNC。執行前請確認交付資訊允許使用此連線方式。
三步完成連接埠轉送
- 01確認連接埠。分別確認 SSH 連接埠與遠端 VNC 連接埠；範例中的
5901是你在本機選用的閒置連接埠，不代表伺服器固定使用這個連接埠。 - 02保持隧道運作。在本機終端機執行轉送命令，並保持終端機開啟。
-N表示只建立轉送，不執行遠端命令。 - 03連線至本機。在螢幕共享或 VNC 用戶端連線至
127.0.0.1:5901。使用完畢後，先退出用戶端，再關閉隧道終端機。
本機終端機遠端連接埠以交付資訊為準
ssh -N \
-L 127.0.0.1:5901:127.0.0.1:<遠端VNC端口> \
-p <SSH連接埠> \
<使用者名稱>@<主機位址>如果本機的 5901 已被占用，只需修改 -L 中的第一個連接埠，並在 VNC 用戶端使用相同的新連接埠。不要為了解決本機連接埠衝突而修改遠端連接埠。
04 / 自動建置
將這台 Mac 註冊為 self-hosted runner
self-hosted runner 是安裝在自有機器上的 CI 工作執行器。請先透過 SSH 登入並確認 Xcode 命令列工具可用，再前往 CI 專案設定建立註冊憑證；不要將一次性權杖寫入儲存庫或建置記錄。
將機器註冊到儲存庫或組織
在專案的 runner 設定中選擇 macOS 執行器，依照頁面提供的最新安裝與設定命令，在雲端 Mac 上完成註冊。請使用能辨識機型、節點和用途的標籤，例如 macos、m4、ios-build；工作流程中的 runs-on 必須與實際標籤相符。
註冊後，先執行一項只執行 xcodebuild -version 的小型工作，再接入正式建置流程。
在專案設定中註冊執行器
取得目前專案的註冊指引，在雲端 Mac 上安裝相符版本的 runner，並依專案需求選擇 shell 執行方式。為 runner 設定清楚的節點與建置標籤；確認受保護的工作允許此 runner 執行後，再提交測試流程。
先確認工作能存取 Xcode、簽署資料和專案相依項目，再提高並行數量。
設定開機自動啟動前，先重新啟動測試一次
依照所用 runner 的官方服務安裝方式，將程序註冊為 macOS 背景服務，並確認服務以哪個帳戶執行。重新啟動後檢查服務狀態，並執行一項測試工作；互動式終端機可以建置，不代表背景服務也能讀取相同的環境變數或鑰匙圈。租期結束前，請撤銷註冊權杖並備份要保留的產出。
05 / 選擇節點
遠端桌面體驗，先看距離
目前提供四個節點：新加坡、日本（東京）、韓國（首爾）、香港。選擇離主要操作人員較近的節點，再透過實際辦公網路測試 SSH 回應速度與桌面操作體驗；跨境網路、封包遺失和本地網路也會影響結果，不能只憑地名推測延遲。
| 節點 | 建議優先考量的團隊所在地 | 連線時先檢查 |
|---|---|---|
| 新加坡 | 東南亞的開發與建置團隊 | 辦公網路至節點的實際往返延遲 |
| 日本（東京） | 日本及周邊地區的開發團隊 | 桌面操作與建置產出傳輸是否穩定 |
| 韓國（首爾） | 韓國及東北亞的開發團隊 | 尖峰時段是否出現封包遺失 |
| 香港 | 華南與東南亞的協作團隊 | 各團隊成員的連線路徑 |
兩種機型在四個節點皆可選擇；下單時的實際供應狀態以控制台即時顯示為準。團隊分布於多個地區時，建議依日常使用桌面的成員所在地選擇節點，再考量 CI 工作的原始碼與產出傳輸路徑。
06 / 多機協作
需要多台機器時，再考慮 Thunderbolt 5 並聯
Thunderbolt 5 並聯適合需要在同一節點協調多台機器的建置工作，或需要頻繁交換大型檔案的工作流程。附加項目按每台機器計費：$1/天是否選用應視工作所需的傳輸效能與並行程度而定，並非連線 VNC 或執行單台 CI 的必要條件。
工作可分配給多台機器執行
例如將多個 App target、測試分片或不同版本的建置工作分配給不同 runner。請先為每台機器設定不同標籤，避免工作被派送到未安裝所需工具的節點。
先測試單機所需時間，再評估並行執行的效益。
傳輸效益是否足以抵銷設定成本
如果建置主要在等待簽署、下載相依項目或呼叫外部介面，並聯連線未必是效能瓶頸。請列出待傳輸檔案的大小、傳輸頻率和機器數量，再於下單設定中確認附加項目。
跨節點協作無法只靠本機並聯連線完成。
07 / 問題排查
無法連線時，依症狀逐步排查
先確認控制台中的實例狀態、位址和連接埠，再判斷問題出在 SSH、VNC 還是本機網路。尚未備份建置產出前，請勿反覆重設環境。
VNC 已連線，但畫面一片黑
先確認 SSH 仍可登入，再中斷並重新連線桌面工作階段。檢查 VNC 驗證資訊、隧道是否仍在運作，以及用戶端連線的是本機轉送連接埠還是交付的直連連接埠。如果 SSH 正常，但多個用戶端持續出現黑畫面，請透過控制台提交支援工單，並附上實例編號、發生時間和截圖。
畫面太小、遭到裁切或解析度不合適
先在用戶端關閉固定縮放，再檢查 macOS 顯示器設定。遠端桌面請先使用單一顯示器和常見解析度進行測試；變更後重新連線，確認問題是由伺服器顯示設定還是用戶端縮放造成。
鍵盤符號或快速鍵對應錯誤
確認本機與遠端的鍵盤配置一致，特別是標點符號、Option 與 Command 鍵。在用戶端設定中檢查輔助鍵對應；先用文字編輯器測試少量字元，再輸入命令或修改簽署設定。
工作階段中斷後，如何恢復工作
先重新建立 SSH 連線；若使用隧道，請重新執行轉送命令，再連線至本機 VNC 連接埠。建置工作盡量交由背景 runner 執行，不要依賴持續連線的桌面終端機。如果 SSH 和 VNC 都無法恢復，請備妥訂單編號、節點編號和錯誤截圖，透過控制台提交支援工單。
準備開始
先租用一天，完成連線與建置測試
從 SSH 小型工作開始，確認桌面與 CI 都符合需求後，再決定是否延長租期或增加機器。需要排查現有實例？請登入控制台提交支援工單。