無法連線
先確認裝置狀態、存取方式、本地對外網路與系統時間，再區分逾時、權限拒絕、指紋變更或圖形工作階段中斷。
查看連線檢查步驟先重現，再升級處理
發生問題時，先完整記錄雲端 Mac 的現場狀況
這裡不按部門分流，而是依序檢查無法連線、建置失敗、磁碟空間、效能波動、帳單與節點狀態。完成基礎診斷後，工單就能直接進入有效排查。
6
類故障入口
99.9%
目標可用率
6
個可租用節點
診斷處理單
等待資訊
把現象轉成可核對的紀錄
故障範圍
單次工作 / 單台裝置 / 團隊範圍
必要時間
發生時間、時區、最近正常時間
環境基線
macOS、Xcode、指令與結束代碼
安全界線
僅提交去識別化日誌，不提交完整金鑰
證據完整時，支援團隊可以先判斷問題出在節點、裝置、系統存取，還是專案環境。
依現象進入
先選擇最接近目前情況的入口
不要先猜原因。記錄直接觀察到的現象、影響範圍與發生順序，再進入對應的檢查路徑。同一個問題涉及多種現象時，以最早發生的項目為主。
建置失敗
保留完整指令、結束代碼與第一個有效錯誤，核對 Xcode、macOS、依賴鎖定檔和專案分支是否與成功基線一致。
進入建置排查磁碟空間
檢查系統卷剩餘容量、衍生資料、建置快取、模型檔案與暫存產物，避免只看專案目錄大小而忽略系統卷壓力。
查看儲存空間判斷路徑效能波動
同時收集 CPU、記憶體壓力、磁碟剩餘空間與長時間工作，確認問題是資源達到上限、工作競爭，還是專案輸入發生變化。
進入效能診斷帳單問題
準備控制台中的訂單識別碼、計費週期和付款結果。訂單統一以 USD 結算，支援 USDT-TRC20 與 Visa / Mastercard / Amex（透過 Stripe）。
進入控制台查看帳單節點狀態
先判斷是單台裝置、單一節點，還是多個地點同時受到影響，並記錄實際節點與最近一次正常存取時間，不要以地理位置取代節點名稱。
查看服務狀態標準連線前核對
五項基礎資訊，缺一項都可能造成誤判
連線問題經常由狀態、憑證範圍、本地網路或時間偏差引起。依序檢查可以避免反覆嘗試而覆蓋原始現場。
-
01
確認控制台中的裝置狀態
核對訂單識別碼、目前節點與裝置狀態。不要把瀏覽器快取中的舊截圖當作目前結果；實際可用狀態以控制台即時回傳為準。
-
02
確認帳號與存取資料屬於同一台裝置
複製主機、使用者與連接埠時逐項核對，避免混用另一台裝置或舊工作階段的資料。工單只需說明使用哪種資料，不要貼上完整秘密內容。
-
03
確認存取方式與工作一致
命令列工作優先驗證 SSH；需要 Xcode 圖形介面時再驗證遠端桌面。兩條路徑分別記錄結果，不要用一個失敗結論取代另一項測試。
-
04
檢查本地對外網路
記錄目前網路類型、是否經過代理伺服器或企業防火牆，並使用另一條受控網路進行一次對照。只回報測試結果，不要傳送完整的內部網路設定。
-
05
核對本地與遠端系統時間
明顯的時間偏差會影響憑證、簽章與存取驗證。記錄時區，並確保工單中的發生時間與日誌時間可以對應。
建置故障排查
先找出第一個有效錯誤，再判斷是環境還是專案
建置輸出末尾的失敗摘要通常不是根因。保存完整日誌，找出最早出現的明確錯誤，並將相同輸入與最近一次成功的基線進行對照。
環境採集指令
唯讀檢查
sw_vers
xcodebuild -version
git rev-parse --short HEAD
git status --short
df -h /
xcodebuild -scheme App -configuration Release執行前確認指令不會輸出秘密值。如果專案使用依賴管理工具，也請記錄鎖定檔摘要與安裝指令結果。
無關專案同時失敗
最小測試專案與正式專案在相同階段失敗，或系統指令也出現異常時，記錄 macOS、Xcode、磁碟剩餘空間與完整結束代碼。
只有特定分支或依賴組合失敗
同一台裝置上的最小專案可以成功，而目標分支在更新鎖定檔、建置參數或資源後失敗，優先回頭檢查專案變更。
版本、指令、結束代碼、日誌節錄
提交 Xcode 與 macOS 版本、依賴鎖定檔摘要、完整 xcodebuild 指令、結束代碼，以及第一個有效錯誤前後的去識別化輸出。
1
固定分支與輸入
排查過程中避免繼續更新依賴或切換設定。
2
保存完整輸出
單獨保留原始日誌，分享前製作去識別化副本。
3
執行最小工作
使用最小 scheme 或測試專案驗證環境基線。
4
對照最近成功紀錄
比較版本、參數、快取狀態與工作輸入。
效能與儲存空間
將「變慢」拆解成 CPU、記憶體、磁碟與工作持續時間
單次耗時增加不能直接證明裝置異常。至少記錄相同輸入的基準耗時、資源峰值與並行工作，再判斷清理、擴充或更換設定。
採樣清單
四類指標
以活動監視器與命令列交叉核對
CPU
持續使用率、程序名稱、並行工作數
top -l 1 -o cpu
記憶體
記憶體壓力、交換空間使用量、峰值階段
memory_pressure
磁碟
系統卷剩餘空間、快取與產物增長
df -h /
長時間工作
啟動時間、輸入規模、執行時間
ps -axo pid,etime,command
HopVM M4 16
M4 · 16GB · 256GB
適合單一專案編譯、短時間測試與低並行自動化工作。若記憶體壓力長期偏高，先減少並行工作，再與 HopVM M4 24 比較。
HopVM M4 24
M4 · 24GB · 512GB
適合同時執行開發工具、模擬器與自動化工作。若大型模型或重型建置持續使用交換空間，可考慮 HopVM M4 Pro 64。
HopVM M4 Pro 64
M4 Pro · 64GB · 2TB
適合大型模型推論、重型建置與高記憶體工作流程。升級前仍應記錄輸入規模與峰值，避免將網路等待誤判為運算能力不足。
先清理可再生資料
確認衍生資料、舊建置產物、無用的模擬器資料與下載快取是否可以重新產生。刪除前先確認專案是否依賴本機唯一產物。
容量持續增加時擴充儲存空間
專案原始檔案較小，但模型、媒體素材或建置封存檔持續增加時，可以評估既定的 +1TB SSD 或 +2TB SSD 附加項目。
分開記錄峰值與基線
分別記錄閒置、一般工作與高峰並行三個階段。只有持續的資源壓力才適合作為升級依據，偶發峰值應先找出觸發工作。
服務可用率
99.9%
目標可用率
所有節點均以全年 365 天持續運作為設計目標，不安排例行停機時段。近 90 天的狀態按日記錄，以下 30 段用於彙整每三個曆日的運作結果。
近 90 天運作摘要
綠色表示正常運作，黃色僅用於標示已關閉的事件，不代表目前異常。
正常運作
已關閉事件
統計標準：近 90 天每日狀態記錄
工單證據範本
一次寫清六項資訊，避免來回追問
工單應讓未參與現場的人也能依照相同步驟重現問題。請使用控制台中的真實訂單識別碼與節點，不要以裝置暱稱或團隊內部簡稱取代。
建議正文結構
複製後填寫
訂單識別碼：
實際節點：SG / JP / KR / HK / US-E / US-W
問題時間與時區：
最近一次正常時間：
影響範圍：
重現步驟：
1.
2.
3.
預期結果：
實際結果：
結束代碼或錯誤類型：
去識別化日誌節錄：六個節點分別為新加坡、日本（東京）、韓國（首爾）、香港、美國東部、美國西部。只保留實際使用的一個節點代碼。
訂單與節點
訂單識別碼用於關聯裝置；節點必須從 SG、JP、KR、HK、US-E、US-W 中選擇實際值。
時間與時區
寫明首次出現時間、最近正常時間與時區，讓狀態記錄與使用者日誌可以對齊。
重現步驟
從已知正常狀態開始，逐步寫出指令、輸入與操作順序，不要省略失敗前的關鍵操作。
預期與實際
分別描述應該發生什麼與實際發生什麼，避免只寫「無法使用」或「速度很慢」。
錯誤與結束代碼
優先提供第一個有效錯誤、結束代碼與發生階段，而不是只複製日誌最後一行。
去識別化輸出
保留呼叫關係、時間與錯誤類型，移除密碼、完整金鑰、權杖、付款憑證與專案秘密。
支援範圍
支援團隊先確認服務界線，再提供下一步
不同問題需要不同證據。在完成影響範圍與環境核對前，不會對無法驗證的具體恢復時間作出承諾。
| 問題類型 | HopVM 可核對範圍 | 使用者應提供 | 判斷結果 |
|---|---|---|---|
| 節點連通性 | 節點狀態、網路可達性、影響範圍與狀態記錄 | 實際節點、來源網路、時間與時區、對照測試 | 區分單一出口、單台裝置或節點層級的影響 |
| 裝置狀態 | 裝置運作狀態、資源交付記錄與控制台關聯資訊 | 訂單識別碼、最近正常時間、受影響工作數量 | 確認裝置狀態是否與控制台結果一致 |
| 系統存取 | 存取資料範圍、工作階段入口與系統層級連線現象 | 存取方式、錯誤類型、指紋或權限結果的去識別化資訊 | 區分逾時、權限、時間偏差與本地網路限制 |
| 開發工具 | 協助確認裝置環境與系統資源是否正常 | Xcode、macOS、依賴版本、完整指令、結束代碼與最小重現 | 判斷是否需要轉向專案依賴或第三方工具排查 |
| 帳單與訂單 | 訂單狀態、計費週期、付款結果與帳務記錄 | 訂單識別碼、付款方式類別、發生時間與控制台結果 | 以控制台即時回傳的訂單與閘道狀態為準 |
可以直接核對
節點連通性、裝置狀態、系統存取入口、訂單關聯與服務端狀態記錄。
需要共同重現
效能波動、間歇性連線、特定建置階段失敗，以及僅在特定輸入下出現的問題。
需要由專案端繼續處理
第三方依賴缺陷、專案程式碼錯誤、建置指令碼邏輯與未經驗證的工具相容性問題。
升級處理入口
完成基礎診斷後，將處理單交給支援團隊
現有訂單、連線與裝置狀態問題，請透過控制台提交工單，以便關聯實際資源。緊急事件應優先寫明影響範圍、實際節點、問題時間與最近一次正常時間。
無法進入控制台時，可寄送電子郵件至 support@hopvm.com，正文仍應使用本頁的證據範本，並刪除所有秘密值。