使用 SSH 金鑰登入
在自己的電腦上產生金鑰組，並將公開金鑰提交至控制台；私密金鑰請妥善保存在自己的裝置上。確認實例已交付且金鑰已綁定後，再使用實例詳細資料中的位址和使用者名稱連線。
ssh-keygen -t ed25519
ssh -i ~/.ssh/id_ed25519 "$USER@$HOST"USER 和 HOST 是需要在本機設定的環境變數。首次連線時請確認主機指紋，切勿略過驗證。
使用文件
遇到問題？先找出對應步驟
從連線到一台獨享實體 Mac mini，到完成建置、管理租期與排除問題。輸入指令或問題關鍵字，即可在本頁查找相關章節。
01 / 首次連線
確認連線位址，再選擇 SSH 或遠端桌面
交付完成後，請在控制台的實例詳細資料中確認主機位址、使用者名稱和連線方式。範例指令中的變數不是實際登入資訊，執行前請先填入本次交付的值。
VNC 遠端桌面
若需操作 Xcode、模擬器或系統設定，請依照控制台實例詳細資料提供的方式連線至遠端桌面。連線前先確認實例狀態，再核對顯示位址和登入資訊。
若畫面延遲明顯，請先降低用戶端解析度或色彩深度，並確認本地網路穩定。請勿將 VNC 登入資訊寫入建置日誌，也不要與 SSH 私密金鑰一併分享。
連接埠與防火牆
請從控制台的實例詳細資料查看實際開放的連接埠，不要假設每台實例使用相同的連接埠。若 SSH 連線逾時，先確認本地網路是否封鎖對外連線，再核對主機位址、連接埠及實例狀態。修改實例防火牆規則前，請保留一條可用的管理連線，以免無法重新連回主機。
02 / 建置工作流程
固定工具鏈，讓建置結果可重現
在獨享實體機上執行命令列建置前，請先確認 Xcode 版本符合專案需求。團隊 CI 應固定專案、Scheme 和簽署素材的來源，避免建置成功仰賴臨時的桌面操作。
Xcode 版本與命令列工具
先列出電腦上已安裝的 Xcode，再選擇專案所需的版本。切換後重新確認命令列工具的路徑與版本；只有在相應版本確實已安裝時，才能使用以下路徑。
ls /Applications | grep Xcode
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
xcode-select -p
xcodebuild -versionxcodebuild 與 fastlane
請先在專案目錄列出可用的 Scheme，確認專案目標後再執行 Release 建置。使用 fastlane 的團隊應將 lane 設定納入版本控制，並在執行前確認憑證和環境變數。
xcodebuild -list
xcodebuild -scheme App -configuration Release build
bundle exec fastlane gymApp 請替換成專案中實際存在的 Scheme；gym 則需要專案中已有對應的 fastlane 設定。
01準備專用帳戶
為執行工作所用的系統帳戶設定必要權限，限制工作目錄，並避免將 SSH 私密金鑰或簽署素材提交至程式碼儲存庫。
02註冊 runner
在 GitHub Actions 或 GitLab 的專案設定中產生註冊所需資訊，再依照平台提供的最新安裝指示，在 Mac 上完成註冊。
03驗證一項工作
先執行會輸出 sw_vers 和 xcodebuild -version 的小型工作，確認執行節點正確後，再接入完整建置流程。
若是第一次使用已交付的實例，可以先按照快速入門步驟完成連線與首次建置。
術語說明
8 個詞，掌握實例與租期
以下術語用於區分租用設備、連線方式與計費單位。選擇方案時，請先評估工作負載需求，再決定租期。
- 實體節點
- 實際部署 Mac mini 的地點。選擇節點時，請考量自己與協作者的網路位置；可在節點說明查看目前提供的地點。
- 獨享實體機
- 每筆訂單對應一台實際的 Mac mini，CPU、記憶體和磁碟不與其他租用者共用。
- 非虛擬機
- 交付的是實體 Mac 的使用權，不是在共用主機上切分出的虛擬實例。
- VNC
- 用來遠端操作 macOS 圖形桌面的連線方式，適合需要圖形介面的開發與除錯工作。
- SSH 金鑰
- 由公開金鑰和私密金鑰組成的身分驗證資訊。提交公開金鑰以取得授權；私密金鑰請自行保管。
- self-hosted runner
- 註冊至 CI 平台後，在租用的 Mac 上執行建置工作的程式。其工作權限取決於執行它的系統帳戶。
- Thunderbolt 5 並聯
- 方案提供的選購擴充項目，按每台設備計費。可在方案頁確認配置與適用的工作負載。
- 租期
- 下單時選擇的日租、週租、月租或季租週期。各週期分別報價，並從交付時間起算。
03 / 計費與續租
租期從交付時間起算
下單時選擇機型、節點、租期和加購項目，並依所選週期一次付清。訂單中的交付時間和到期時間以控制台記錄為準；請勿以付款時間推算可使用期間。
01確認訂單
付款前請確認機型、節點及所選的日租、週租、月租或季租週期。實際供應狀況以控制台即時顯示為準。
02查看到期提醒
交付後可在控制台查看租期記錄和到期資訊。提醒可協助安排工作，但不能取代自行備份。
03續租或升級方案
需要繼續使用時，請從控制台訂單進入續租流程。若要從 Commit 16 升級至 Commit 24，請先確認新配置和資料移轉安排，再依控制台提供的流程操作。
付款與結帳
僅支援 USDT-TRC20，以及透過 Stripe 處理的 Visa、Mastercard、Amex。所有報價與結帳均以美元（USD）計價；結帳時實際可用的付款管道以控制台顯示為準。各機型及四種租期的價格請參閱方案與價格。
04 / 常見問題排除
逐層找出問題所在
請依序排查實例狀態、網路、系統工作階段及專案設定。記下完整錯誤訊息、發生時間和已嘗試的步驟，有助於工單更快聚焦問題。
VNC 已連線，但畫面是黑的
先確認控制台顯示的實例狀態允許連線；中斷後重新建立圖形工作階段，並嘗試降低用戶端解析度。若 SSH 可連線，也可檢查系統是否仍能執行指令。提交工單時請附上用戶端提示訊息、連線時間，以及 SSH 是否可用；請勿附上連線密碼。
SSH 一直逾時，沒有出現驗證提示
逾時通常發生在金鑰驗證之前。請確認控制台提供的位址和連接埠、實例狀態，以及本地網路是否允許對外連線。可改用其他網路測試並記錄結果；尚未確認連接埠規則前，請勿反覆更換私密金鑰。
建置時出現磁碟空間不足
先使用 df -h 確認剩餘空間，再檢查專案產出、DerivedData、封存檔和模型檔案的占用情況。刪除前請確認檔案用途，並備份需要保留的產出。若長期需要更多空間，可在方案頁確認 SSD 加購項目。
鑰匙圈或簽署憑證導致封存失敗
請確認憑證是否有效、描述檔是否與 Bundle ID 相符，以及執行建置的帳戶是否有權存取對應的鑰匙圈。桌面登入帳戶可能與 CI runner 帳戶不同；請先使用同一帳戶重現錯誤。提交工單時可附上已去除敏感資訊的錯誤日誌，請勿傳送私密金鑰或憑證密碼。
離開實例前
到期前匯出資料，別把保留期間當成備份
專案原始碼、建置產出、憑證和模型檔案都應由你自行安排備份。租期結束後，實例存取權將依服務條款處理；資料保留期間及後續清除規則以服務條款和訂單資訊為準。請勿假設到期後仍能登入取回檔案。
01匯出工作成果
將程式碼推送到自己的儲存庫，並將尚未封存的 IPA、日誌或模型結果複製到自己管理的儲存空間。
02檢查敏感資料
確認簽署憑證、金鑰和 CI 變數的使用範圍；必要時在專案端更新憑證，並避免將私密金鑰留在共用建置日誌中。
03確認下一步
若要繼續使用同一台實例，請提早查看續租選項；若準備結束使用，請先確認備份檔案可讀取，再完成後續整理。