首次連線
收到交付資訊，但尚未進入桌面
先核對節點位址、遠端存取方式、初始憑證與用戶端版本。確認鍵盤配置與解析度後，再傳輸程式碼、憑證或媒體素材。
查看連線流程
先定位，再處理
將雲端 Mac 問題拆解成可執行的排查步驟
先確認問題屬於連線、建置、權限、磁碟、帳單還是服務狀態，再依序收集節點資訊與錯誤輸出。已有訂單的技術問題可登入控制台提交工單。
- 排查入口
- 6 類問題
- 服務目標
- 99.9% 可用率
- 人工支援管道
- 控制台工單與支援信箱
工作登記板
先記錄現象，再變更環境
可執行清單
CONNECT
無法首次連線
核對節點位址、遠端方式、憑證狀態與用戶端相容性
路徑 01
BUILD
Xcode 或自動化工作失敗
保留完整指令、結束碼、工具鏈版本與簽署階段輸出
路徑 02
BILLING
費用或續訂資訊不明
核對訂單週期、附加項數量、付款狀態與 USD 應付金額
路徑 03
問題分流
依現象選擇第一條排查路徑
不要同時修改網路、工具鏈與權限。每次只變更一個條件，並記錄變更前後的結果，才能判斷真正原因。
連線中斷
工作階段卡頓、黑畫面或重新連線後狀態異常
記錄用戶端名稱、網路類型、發生時間，以及是否能透過命令列存取。先排除本地網路抖動，再調整顯示參數或重新建立工作階段。
查看連線排查
Xcode 建置
編譯、封存或簽署階段失敗
保留執行指令與完整結束碼，依序核對磁碟容量、憑證有效性、Keychain 權限、相依項快取與 Xcode 版本。
查看建置排查
自動化工作
Runner、指令碼或打包流程執行異常
確認執行使用者、工作目錄、環境變數、金鑰讀取範圍與清理指令碼。比較互動式 shell 與自動化程序實際使用的環境。
查看指令範例
磁碟擴充
容量不足或附加儲存空間尚未確認
先用系統指令確認磁碟區容量與可用空間，再核對訂單中的 +1TB SSD 或 +2TB SSD 附加項。不要只依專案目錄大小判斷剩餘容量。
查看附加項計費
帳單問題
付款狀態、續訂週期或應付金額不一致
準備訂單編號、租用週期、機型、節點、附加項數量與付款方式。應付金額與實際可用付款閘道以控制台即時回傳為準。
查看帳單說明
交付後第一步
先完成五項核對，再遷移工作內容
交付資訊可用於確認節點與連線方式，但專案能否穩定建置，仍取決於工具鏈、權限與相依項是否一致。
-
01
核對節點資訊
確認訂單編號、節點區域、主機位址與交付的遠端存取方式屬於同一台雲端 Mac。
-
02
確認帳戶權限
檢查目前使用者是否擁有專案目錄、建置目錄與必要系統設定的存取權限，避免直接擴大權限範圍。
-
03
驗證遠端工作階段
檢查鍵盤映射、顯示縮放、剪貼簿需求與工作階段重新連線行為，確認安全結束後再執行長時間工作。
-
04
記錄系統與工具版本
保存 macOS、Xcode、命令列工具與套件管理器版本，後續排查時以這組基準重現環境。
-
05
小批次驗證相依項
先擷取最小專案或測試分支，驗證相依項安裝與建置目錄，再遷移憑證、快取或大型素材。
指令輸出範例
保留指令、階段與結束結果
工單只寫「建置失敗」不足以定位問題。請複製失敗指令前後的關鍵輸出，並說明相同指令是否能在互動式工作階段中重現。
$ ssh build-user@node-address
Last login: current session
$ sw_vers
ProductName: macOS
ProductVersion: [目前系統版本]
$ xcodebuild -version
Xcode [目前安裝版本]
Build version [目前建置編號]
$ xcodebuild -workspace Project.xcworkspace \
-scheme Project \
-configuration Release \
-destination "generic/platform=iOS" \
archive
note: Resolving package dependencies
note: Compiling target Project
error: Build input file cannot be found
** ARCHIVE FAILED **
exit status: 65
$ bundle exec fastlane ios build
[fastlane] Loading configuration
[fastlane] Running build lane
[fastlane] Step failed: archive
[fastlane] Preserve the complete log and exit code
SSH 驗證
證明節點可連線，並記錄目前執行使用者。
Xcode 輸出
保留 scheme、configuration、destination 與結束碼。
Fastlane 輸出
說明失敗的 lane、具體 step 與同次執行的完整日誌位置。
建置故障
依相依關係從底層條件開始檢查
磁碟空間不足會引發快取、相依項解壓縮與封存異常；工具鏈不一致也會放大簽署問題。建議嚴格依照以下順序執行。
-
01
磁碟容量
執行
驗證結果：建置目錄具有足夠可用空間df -h查看系統磁碟區與工作磁碟區的實際可用空間，再檢查 DerivedData、封存檔、套件管理器快取與舊產物。 -
02
簽署憑證
確認專案選擇的簽署身分、佈建描述檔、Bundle Identifier 與建置設定彼此相符，不要只檢查憑證檔案是否存在。
驗證結果：目標設定能找到對應的簽署身分 -
03
Keychain 權限
比較互動式工作階段與自動化程序的執行使用者，確認工作能讀取所需簽署資料，並記錄權限失敗發生在哪個階段。
驗證結果：自動化使用者能讀取必要項目 -
04
相依項快取
先保留鎖定檔與失敗日誌，再依專案工具清理對應快取。不要同時刪除所有快取，否則無法判斷損壞來源。
驗證結果：相依項解析可重複且版本一致 -
05
Xcode 版本
記錄
驗證結果：圖形介面與命令列使用相同工具鏈xcodebuild -version與xcode-select -p，確認命令列工作實際使用的版本與專案要求一致。
先複製錯誤，再執行清理
清理 DerivedData、相依項快取或封存目錄會改變現場。提交工單時應同時說明清理前的錯誤、清理動作與清理後的結果。
遠端存取
區分本地網路、用戶端與節點工作階段
遠端畫面異常不代表節點離線。先判斷命令列是否可連線，再檢查用戶端相容性與顯示設定，最後處理工作階段重新連線。
| 觀察到的現象 | 優先檢查 | 驗證結果 |
|---|---|---|
| 用戶端無法建立工作階段 | 核對節點位址、用戶端版本、網路出口限制與交付的遠端方式 | 同一節點能透過支援的方式建立連線 |
| 畫面間歇卡頓或輸入延遲 | 記錄本地網路類型、抖動發生時間、是否使用代理伺服器及當時的傳輸工作 | 降低並行傳輸後可判斷是否為本地連線問題 |
| 解析度或縮放異常 | 檢查用戶端縮放策略、目標解析度與工作階段內的顯示設定 | 文字與互動區域可完整顯示且不被裁切 |
| 快捷鍵與預期不一致 | 確認本地鍵盤配置、修飾鍵映射與用戶端快捷鍵攔截設定 | 常用組合鍵在測試編輯器中輸出一致 |
| 重新連線後停留在舊畫面 | 確認舊工作階段是否仍在執行，記錄命令列可連線狀態並重新建立用戶端工作階段 | 新工作階段顯示目前系統狀態且輸入可回應 |
| 工作結束後仍保留工作階段 | 保存工作、停止敏感程序、鎖定螢幕並從用戶端安全登出 | 工作階段已關閉，後續連線需要重新驗證 |
工單中應附上什麼
用戶端名稱與版本、本地網路類型、節點、發生時間、畫面現象、命令列是否可連線，以及已嘗試的重新連線步驟。
工單中不要附上什麼
不要提交密碼、私密金鑰正文、存取權杖或未脫敏的簽署資料。需要說明憑證問題時，只描述錯誤類型與發生階段。
服務狀態與 SLA
透過目標、記錄範圍與申請條件了解可用率
SetMini 採用 99.9% 可用率目標。節點全年 365 天正常運作，不安排定期停機；實際事件記錄與節點狀態以控制台回傳為準。
帳單說明
先核對租用期、附加項與付款狀態
所有訂單均以 USD 結算。實際可用付款閘道與訂單狀態以控制台即時回傳為準，提交帳單工單時請附上訂單編號。
依日、週、月或季確認續訂
續訂金額取決於所選機型、租用週期、節點與附加項。不要用日租價直接換算其他週期，四種週期均有獨立目錄價格。
查看完整價格兩類管道，統一使用 USD
- USDT-TRC20依訂單頁回傳的資訊完成付款
- 銀行卡Visa / Mastercard / Amex，透過 Stripe 處理
付款狀態、可用付款閘道與應付金額以控制台即時回傳為準。
| 附加項 | 每天 | 每週 | 每月 | 每季 |
|---|---|---|---|---|
| +1TB SSD | $2.4 | $6.4 | $11.8 | $32.1 |
| +2TB SSD | $4.8 | $12.8 | $23.6 | $64.2 |
| Thunderbolt 5 並聯，每台 | $1.5 | $4.1 | $7.6 | $20.7 |
01
訂單編號
用於確認機型、週期與附加項。
02
節點
填寫區域代碼與主機識別碼。
03
發生時間
註明時區，並提供開始與結束時間範圍。
04
錯誤輸出
附上完整指令、結束碼與關鍵日誌。
05
已執行步驟
依序說明每次變更及其結果。