遠端連線
預計檢查 5 分鐘
SSH 逾時或無法建立遠端 Mac 桌面工作階段
先在控制台確認執行個體處於可連線狀態,並逐字核對節點位址與連接埠。接著從本機執行連接埠連通性測試;若連接埠無法連線,切換一次本機網路,以區分節點問題與連線線路問題。SSH 首次連線時要核對主機指紋;憑證失敗則確認使用者名稱、金鑰路徑與檔案權限。圖形工作階段已建立但出現黑畫面時,先降低解析度與動態效果,再中斷舊工作階段並重新連線。
- 記錄用戶端系統、連線工具名稱與版本。
- 保留逾時、拒絕連線或驗證失敗的完整錯誤行。
- 高延遲時同時記錄 ping 中位數、抖動與封包遺失,不要只提交單次結果。
開啟遠端 Mac 連線指南
帳戶與權限
預計檢查 4 分鐘
可以登入節點,但命令、目錄或專案操作遭到拒絕
先判斷失敗發生在控制台登入、本機登入,還是某個命令的權限檢查。控制台用於查看訂單、執行個體、帳單與工單;節點內的本機權限則由目前使用者、目錄擁有者與命令要求共同決定。若看到 Permission denied,請記錄目標路徑、執行命令與目前使用者,不要反覆修改整個專案目錄的權限。臨時憑證完成首次登入後應儘快更新,並避免在公用裝置儲存連線資訊。
- 確認目前操作對應正確的執行個體與登入電子郵件。
- 使用
whoami、pwd 與目錄權限資訊確認執行環境。
- 向支援團隊提交資訊時,不得附上密碼、私密金鑰或未去識別化的存取權杖。
進入控制台核對執行個體
Xcode 建置
預計檢查 8 分鐘
xcodebuild 找不到 Scheme、SDK 或目標裝置
先確認命令是在專案根目錄執行,並區分 .xcodeproj 與 .xcworkspace。接著輸出 Xcode 選擇路徑與可用 SDK,再核對 Scheme 是否共用、名稱大小寫是否一致。相依性更新後出現問題時,不要先刪除所有快取;應保留第一次失敗日誌,定位第一個明確錯誤,再決定是否清理 DerivedData 或重新解析相依性。
- 記錄完整命令、工作目錄、Xcode 版本與結束碼。
- 使用清單命令確認工作區、Scheme 與可用 destination。
- 建置突然中斷時,檢查磁碟剩餘空間、暫存目錄與相依性快取大小。
查看首次環境驗證順序
Fastlane
預計檢查 7 分鐘
Fastlane 在載入相依性、執行 lane 或匯出階段停止
先確認專案約定使用系統命令還是 bundle exec fastlane,並檢查 Ruby、Bundler 與 Gemfile.lock 是否相互對應。日誌最後一行往往只是流程終止提示,真正原因通常更早出現。應從第一個錯誤區塊向上保留上下文,標示失敗 lane、action 與參數來源。環境變數只提交名稱與是否存在,不要提交實際值。
- 相依性階段失敗時,記錄 Ruby、Bundler 與 Fastlane 版本。
- 建置 action 失敗時,同時保留底層 xcodebuild 結束碼。
- 重複執行任務時,記錄是否每次都停在同一步,以及清理快取後是否有變化。
依支援清單整理問題
網路診斷
預計檢查 6 分鐘
連線速度變慢、畫面卡頓或檔案傳輸不穩定
遠端體驗同時受延遲、抖動、封包遺失與可用頻寬影響。先從日常使用地點分別測試新加坡、東京、首爾與香港節點,選擇中位延遲較低且抖動較小的路徑。測試時固定本地網路、時段與樣本數;若無線網路結果波動明顯,再以有線或其他連線網路重新測試。圖形工作階段可降低解析度、色彩品質與動態效果;命令與長時間任務則優先透過 SSH 分流。
- 至少保留一組連續樣本,而不是單次最低延遲。
- 分別說明網頁存取、SSH、桌面工作階段與檔案傳輸中哪一項異常。
- 記錄本地連線地區、網路類型、目標節點與異常發生時段。
比較四個節點
儲存空間與帳單
預計檢查 5 分鐘
核對基礎方案、租用週期與附加項目
帳單核對應從訂單確認頁逐行進行:先確認 GPUMini M4 Core 或 GPUMini M4 Plus,再核對按天、週、月或季選擇的週期、目標節點,以及是否新增儲存空間擴充或 Thunderbolt 5 串聯。不要只比較帳單總額;總額相同也可能來自不同的週期與附加組合。所有金額均以美元結算,可用付款方式為 USDT-TRC20,或透過 Stripe 處理的 Visa、Mastercard、Amex,實際可用付款閘道以結算介面回傳為準。
- 記錄訂單編號、帳單項目名稱與需要核對的行,不要提交完整付款憑證。
- 執行個體磁碟空間不足屬於執行問題,應同時提交剩餘空間與主要目錄使用量。
- 帳單項目與預期不一致時,附上訂單確認頁與帳單列的文字資訊。
查看方案與附加項目定義