SSH 命令列
適合簽出專案、檢查相依套件、執行 xcodebuild、查看記錄，以及連接 macOS CI runner。
- 先準備 SSH 用戶端與獲授權的帳戶。
- 首次連線時請核對主機指紋，勿略過身分驗證。
連線指南
連線至雲端 Mac，依需求選擇命令列或桌面。
執行建置指令碼，先使用 SSH；檢查 Xcode 圖形介面，則使用遠端桌面。UDPMac 提供獨享實體 Mac，連線位址、帳戶權限與可用方式皆以控制台提供的資訊為準。
已有執行個體？請先前往控制台確認裝置狀態與連線參數，再依照下方步驟操作。
連線方式
流程示意
01
執行指令與 CI 工作SSH · 終端機、指令碼、建置記錄
02
檢視 macOS 桌面VNC · 圖形操作與顯示檢查
03
檢查 Xcode 專案開啟專案 → 檢查工具鏈 → 測試建置
此示意圖僅說明操作順序，不會顯示執行個體狀態或實際連線憑證。
選擇連線方式
依工作需求選擇連線方式。
命令列與圖形桌面各有用途；執行自動化指令碼不必維持桌面工作階段，需要目視確認的 Xcode 操作也不必以終端機取代。
VNC 遠端桌面
適合檢視 macOS 圖形介面、確認顯示設定，以及處理必須在桌面上完成的操作。
- 使用控制台提供的連線參數與核准的用戶端。
- 請勿在共用裝置上儲存連線位址以外的存取憑證。
Xcode 圖形工作流程
先透過遠端桌面開啟專案，再確認 Xcode 版本、專案設定與簽署所需資料，最後執行測試建置。
- 專案相容性取決於相依套件、工具鏈與設定。
- 建置結果以實際輸出與記錄為準。
連線前檢查
先確認四項條件，再輸入連線參數。
請勿將密碼、私密金鑰、簽署憑證或完整連線資訊貼到公開頁面、聊天記錄或故障截圖中。
01裝置狀態
在控制台確認執行個體已就緒，並核對目前訂單所對應的機型與節點；請勿沿用其他裝置的舊位址。
02帳戶權限
確認使用的是該執行個體授權的帳戶。若團隊分工不同，請先確認誰可以登入、誰可以修改工具鏈或專案檔案。
03網路連線
確認本機網路與目標連線所需連接埠皆可連通；發生逾時時，先判斷是網路問題還是身分驗證失敗。
04本機用戶端
SSH 工作請準備終端機用戶端；桌面工作請準備適用的 VNC 用戶端，並確認本機裝置允許建立相應連線。
SSH 操作流程
建立工作階段、驗證主機，再執行指令。
以下主機名稱與使用者名稱僅用於說明指令格式。實際位址、帳戶與驗證資訊請以控制台提供的資料為準。
01
取得參數並開始連線
在控制台確認主機、帳戶與所需的驗證方式，並將範例中的佔位內容替換為此執行個體的資訊；請勿重複使用其他執行個體的連線記錄。
02
完成首次身分確認
首次連線出現主機指紋提示時，請先根據可信的執行個體資訊核對，再繼續操作。若指紋與已確認的記錄不符，請停止連線並進一步檢查。
03
執行工作並離線
先確認目前目錄、Xcode 工具鏈與磁碟空間，再執行專案指令；儲存所需產物與記錄後，輸入 exit 結束工作階段。
指令格式範例非實際憑證
ssh USER@HOST.example.invalid
xcode-select -p
xcodebuild -version
exit範例網域無法用於連線。專案建置指令、工作目錄與簽署設定應依據實際專案確認，請勿直接套用此範例。
圖形桌面
四個步驟完成遠端桌面工作階段。
僅在需要圖形操作時建立桌面工作階段。SSH 與 VNC 的連線參數可能不同，請分別以控制台顯示的資訊為準。
01取得連線參數
確認執行個體已就緒後，在控制台查看該裝置目前的遠端桌面位址、存取方式與帳戶要求。請勿從舊郵件或他人截圖抄錄憑證。
02建立工作階段
在本機 VNC 用戶端輸入相應參數。若需要身分驗證，請使用獲授權的資訊；請勿關閉用戶端的連線安全提示來略過錯誤。
03調整顯示設定
連線後依螢幕大小調整縮放比例或解析度，先確認輸入焦點與鍵盤配置，再修改專案或系統設定。
04安全離線
儲存工作並關閉含有敏感資料的視窗，然後從用戶端中斷連線。請勿在共用裝置上儲存存取憑證。
Xcode 檢查清單
首次進行圖形介面建置，逐項記錄以便核對。
雲端 Mac 提供執行環境，但不代表專案無須調整就能順利建置。請先進行小規模測試，再決定如何納入日常建置流程。
開啟正確的專案入口
簽出或移入專案後，確認分支、相依套件檔案與專案入口一致。記錄缺少的相依套件及首次開啟時顯示的設定提示，勿直接在主分支上嘗試修改。
檢查完成：可辨識專案與預期分支。
確認版本與權限
檢查 Xcode 版本、所選命令列工具與專案目標設定；若建置涉及簽署資料，請團隊依自身安全規範保管並授權，勿將資料寫入記錄。
檢查完成：已記錄工具鏈與建置目標。
執行一次測試建置
從明確的目標開始建置，記錄失敗步驟、關鍵錯誤與產物位置。確認輸出後，才能判斷下一步該修正相依套件、設定或連線。
檢查完成：可重新檢視結果與已遮蔽敏感資訊的記錄。
連線問題排查
先找出問題發生在哪個環節。
向團隊回報時，請記錄發生時間、使用的連線方式、執行個體訂單識別碼與已遮蔽敏感資訊的錯誤內容；勿傳送完整憑證或含有專案機密的螢幕截圖。
| 狀況 | 優先檢查項目 | 應記錄資訊 |
|---|---|---|
| 驗證失敗 | 確認帳戶、驗證方式與執行個體是否相符；首次連線也應核對主機身分提示。 | 用戶端錯誤原文、連線方式；請遮蔽使用者名稱以外的敏感欄位。 |
| 連線逾時 | 確認執行個體狀態、本機網路、目標位址與連線所需連接埠，並區分逾時與密碼錯誤。 | 發生時間、所選節點、網路環境與發生逾時的步驟。 |
| 畫面延遲 | 檢查本機網路穩定性，並嘗試降低遠端桌面的顯示負載；確認終端機操作是否也受影響。 | 發生時間、用戶端顯示設定與可重現的操作。 |
| 工作階段中斷 | 檢查本機網路變化、用戶端提示與執行個體狀態；重新連線前，先確認沒有尚未完成的檔案操作。 | 中斷前的最後操作、用戶端提示與重新連線結果。 |
安全收尾
中斷連線不代表交接完成。
結束 SSH 或遠端桌面工作階段後，請再檢查帳戶、工作檔案與後續存取安排。租用期間結束前，主動匯出團隊需要保留的專案資料與建置產物。
檢查帳戶
確認是否仍有不需要的工作階段或臨時授權，並依團隊流程處理。
整理檔案
確認產物已封存；清理不再需要的暫存檔案前，先確認不會影響下次建置。
保管憑證
移除共用裝置上儲存的連線資訊，避免將私密金鑰、簽署資料或含有敏感欄位的記錄留在共用位置。
如需了解網站與服務資訊的處理方式，請閱讀隱私權政策。
立即開始
選好節點，將建置工作交由雲端 Mac 執行。
先確認機型、租期與節點；開通後，從控制台取得實際連線資訊，再依本指南選擇 SSH 或圖形桌面。