訂單與設備
確認訂單對應的 Mac、機型與執行個體識別碼。若管理多台設備，請先確認要操作哪一台，避免將專案檔案傳到錯誤的設備。
連線與建置支援
從訂單資料出發，連上你的雲端 Mac。
先確認設備、區域與存取權限，再建立 SSH 連線並檢查建置環境。本清單適用於首次設定與問題排查；連線位址、使用者名稱和金鑰請以你的訂單資料為準。
已經下單了嗎？先在控制台開啟對應訂單，再依右側順序逐項確認。
連線檢查清單
01 / 03
確認無誤再連線
一筆訂單，對應一台設備。
- 設備
- 確認訂單中的機型與執行個體識別碼
- 區域
- 確認所選節點與連線路徑
- 權限
- 使用該訂單提供的連線資料
公開範例不含實際位址、私鑰或存取權杖。實際可用資料請以控制台顯示為準。
區域與連線資料
確認訂單所選區域，並從該設備的管理資訊中取得連線位址、連接埠與使用者名稱。請勿將本頁的示範位址當作實際連線入口。
帳戶與存取權限
確認目前帳戶是否能查看該訂單及其連線資料。請將私鑰留在受控的本機環境中，不要傳送到支援單、程式碼儲存庫或公開頁面。
請勿提交敏感憑證。排查問題時可以提供已去除敏感資訊的錯誤訊息，但請勿傳送私鑰、完整權杖、憑證內容或含個人資料的原始記錄。
連線流程
依照三個步驟建立安全連線。
先取得這筆訂單的實際參數，再處理本機金鑰及首次主機身分確認。網路連通、帳戶授權與主機身分是三項不同的檢查，不要只因出現登入提示就略過確認。
-
01
查看連線資訊
登入控制台，開啟目標訂單，記下該設備提供的位址、連接埠、使用者名稱與連線說明。如果訂單尚未顯示可用的連線資料，請先確認訂單狀態，不要自行猜測位址。
-
02
準備 SSH 金鑰
在本機確認私鑰檔案的存取權限，並依訂單說明設定對應的公開金鑰。請為 CI 規劃獨立且權限受限的憑證；不要將個人開發電腦的私鑰直接複製到建置儲存庫。
-
03
驗證主機身分
首次連線時，請比對主機指紋與可信的設備資料。如果指紋不符或突然變更，請先停止連線，確認是否選錯設備、位址或連線路徑，不要直接忽略警告。
指令範例
連線後，使用最精簡的指令確認環境。
以下輸出僅用於說明檢查順序，不代表任何設備的實際系統版本、建置結果或已設定的專案。示範使用的 192.0.2.10 不是訂單的連線位址；執行前請替換為控制台提供的資料。
先確認能否進入目標設備，再查看 Xcode 命令列工具的指向，最後在專案目錄中執行建置工作。每個步驟都可以個別排查，不必一次將整套 CI 流程搬上去測試。
連線與建置檢查 · 範例
$ ssh -i ~/.ssh/id_ed25519 operator@192.0.2.10
示例輸出：已進入目標設備，請核對主機身分
$ xcodebuild -version
示例輸出：顯示設備目前安裝的 Xcode 版本
$ fastlane build
示例輸出：檢查專案設定後傳回建置結果範例指令不含實際憑證。fastlane build 僅適用於專案已定義對應工作時；實際指令請以專案設定為準。
首次建置
先記錄版本與相依項目，再比對建置結果。
「連線成功」只代表已進入設備，不代表開發環境符合專案需求。請先完成以下檢查，再設定 Runner 或上傳大量專案檔案；實際系統與工具版本請以租用設備的環境為準。
系統與 Xcode
記錄 macOS 版本、目前的 Xcode 版本，以及 xcode-select -p 所指向的開發者目錄。如果專案要求特定 SDK，請先確認可用版本，再開始建置。
檢查項目：系統版本、Xcode 版本、命令列工具路徑。
專案相依項目
依照儲存庫中的鎖定檔安裝相依項目，並確認套件管理工具、指令碼執行環境與專案所需外掛程式。請分開管理工具安裝、專案設定與簽署資料，避免因一次建置失敗就判定是設備故障。
檢查項目：鎖定檔、安裝記錄、相依項目版本。
最小化建置
先在專案目錄中執行一個可重現的檢查或建置指令，並記錄指令、結束狀態與第一個錯誤的位置。確認本機手動建置成功後，再將相同工作整合至 CI。
檢查項目：執行目錄、完整指令、第一個失敗步驟。
自動化整合
讓 Runner 重現已驗證的手動建置流程。
整合 CI/CD 的目的不是換成一套無法追蹤的環境，而是將已成功的指令、相依項目與權限需求記錄為可重複執行的工作。註冊方式與執行器設定依 CI 系統而異；請勿在公開設定中貼上實際註冊權杖。
A
註冊與隔離
在使用的 CI 系統中為目標設備註冊 Runner，並確認它只接收預期的專案與工作。檢查執行使用者、工作目錄與同時執行工作的安排。
B
金鑰與簽署資料
將存取金鑰與簽署資料存入 CI 系統提供的受控機密儲存空間，不要寫入儲存庫、建置指令碼輸出或快取。只授予工作所需的權限。
C
快取與產出物
明確設定相依項目快取路徑與清理條件，並將建置產出物存放在團隊指定的位置。若遇到無法重現的錯誤，請先停用舊快取重新建置，以便比對結果。
D
結束工作階段
工作完成後，請檢查暫存檔案、背景程序與工作階段狀態。交接設備或調整權限時，請撤銷不再需要的存取權，並確認工作目錄中沒有留下憑證。
問題排查
從第一個失敗的步驟開始排查。
先記下問題發生的步驟，再保留相關指令、結束狀態與已去除敏感資訊的記錄。不要只傳送顯示「失敗」的最後一張截圖：最早出現的錯誤通常比最後一行摘要更有參考價值。
SSH 無法連線
先確認訂單與目標設備，再檢查位址、連接埠及本機網路是否可連通；接著確認使用者名稱、金鑰權限與主機身分提示。請分開記錄連線逾時與權限遭拒：前者先檢查連線路徑，後者先檢查授權。
簽署設定異常
檢查專案使用的簽署設定、建置目標與 CI 執行使用者是否一致。請勿將憑證或私鑰內容貼到支援請求中；提供已去除敏感資訊的錯誤行及觸發錯誤的建置步驟即可。
建置失敗
比對手動執行與 CI 工作所使用的 Xcode 路徑、相依項目版本、工作目錄及環境變數來源。先找出第一個實際編譯或指令碼錯誤，再判斷是否需要清除快取並重新執行。
磁碟空間不足
查看可用空間，並區分專案檔案、建置產出物、相依項目快取與暫存檔案。清理前請確認檔案用途；如果工作負載長期需要更多容量，可前往方案頁確認儲存空間加購選項。
提交支援請求時：請附上訂單對應的設備型號與區域、問題發生時間、執行的指令、第一個錯誤的位置，以及已嘗試的步驟。傳送前請移除權杖、憑證、私鑰與個人資料。
尋求協助
自行排查後仍有問題？請提供訂單資訊。
若問題與既有訂單有關，請先登入控制台確認設備資料並提交支援單，讓問題與對應訂單連結。購買前的機型選擇或尚未下單的問題，請參閱聯絡頁面的郵件準備清單。提交支援請求時不需要提供帳戶密碼或完整金鑰。
準備開始
選好設備，依清單完成連線。
三種 Apple Silicon 獨享實體機方案，可選擇按日、週、月或季租用。先確認機型與租期，下單後即可在控制台取得連線資料。