GPUMini 說明中心

先定位問題,再依證據逐項排查

針對雲端 Mac 獨享實體節點的連線、建置、網路、儲存空間與帳單問題。輸入錯誤訊息、工具名稱或帳單項目,我們會標示最相關的處理路徑。

6 類常見問題入口
5 步標準排查順序
2 種人工聯絡管道
診斷執行單 SUPPORT / 01
A

確認對象節點、帳戶、訂單或建置任務

B

保留證據時間、命令、錯誤行與去識別化日誌

C

縮小範圍網路、憑證、磁碟或工具鏈

適用於 SG · JP · KR · HK 獨享實體節點
知識路徑

從現象開始,而不是從猜測開始

以下六條路徑會同時保留在頁面中。分類按鈕只負責定位與醒目顯示,不會隱藏其他內容,方便交叉核對相鄰問題。

SSH 逾時或無法建立遠端 Mac 桌面工作階段

先在控制台確認執行個體處於可連線狀態,並逐字核對節點位址與連接埠。接著從本機執行連接埠連通性測試;若連接埠無法連線,切換一次本機網路,以區分節點問題與連線線路問題。SSH 首次連線時要核對主機指紋;憑證失敗則確認使用者名稱、金鑰路徑與檔案權限。圖形工作階段已建立但出現黑畫面時,先降低解析度與動態效果,再中斷舊工作階段並重新連線。

  • 記錄用戶端系統、連線工具名稱與版本。
  • 保留逾時、拒絕連線或驗證失敗的完整錯誤行。
  • 高延遲時同時記錄 ping 中位數、抖動與封包遺失,不要只提交單次結果。
開啟遠端 Mac 連線指南

可以登入節點,但命令、目錄或專案操作遭到拒絕

先判斷失敗發生在控制台登入、本機登入,還是某個命令的權限檢查。控制台用於查看訂單、執行個體、帳單與工單;節點內的本機權限則由目前使用者、目錄擁有者與命令要求共同決定。若看到 Permission denied,請記錄目標路徑、執行命令與目前使用者,不要反覆修改整個專案目錄的權限。臨時憑證完成首次登入後應儘快更新,並避免在公用裝置儲存連線資訊。

  • 確認目前操作對應正確的執行個體與登入電子郵件。
  • 使用 whoamipwd 與目錄權限資訊確認執行環境。
  • 向支援團隊提交資訊時,不得附上密碼、私密金鑰或未去識別化的存取權杖。
進入控制台核對執行個體

xcodebuild 找不到 Scheme、SDK 或目標裝置

先確認命令是在專案根目錄執行,並區分 .xcodeproj.xcworkspace。接著輸出 Xcode 選擇路徑與可用 SDK,再核對 Scheme 是否共用、名稱大小寫是否一致。相依性更新後出現問題時,不要先刪除所有快取;應保留第一次失敗日誌,定位第一個明確錯誤,再決定是否清理 DerivedData 或重新解析相依性。

  • 記錄完整命令、工作目錄、Xcode 版本與結束碼。
  • 使用清單命令確認工作區、Scheme 與可用 destination。
  • 建置突然中斷時,檢查磁碟剩餘空間、暫存目錄與相依性快取大小。
查看首次環境驗證順序

Fastlane 在載入相依性、執行 lane 或匯出階段停止

先確認專案約定使用系統命令還是 bundle exec fastlane,並檢查 Ruby、Bundler 與 Gemfile.lock 是否相互對應。日誌最後一行往往只是流程終止提示,真正原因通常更早出現。應從第一個錯誤區塊向上保留上下文,標示失敗 lane、action 與參數來源。環境變數只提交名稱與是否存在,不要提交實際值。

  • 相依性階段失敗時,記錄 Ruby、Bundler 與 Fastlane 版本。
  • 建置 action 失敗時,同時保留底層 xcodebuild 結束碼。
  • 重複執行任務時,記錄是否每次都停在同一步,以及清理快取後是否有變化。
依支援清單整理問題

連線速度變慢、畫面卡頓或檔案傳輸不穩定

遠端體驗同時受延遲、抖動、封包遺失與可用頻寬影響。先從日常使用地點分別測試新加坡、東京、首爾與香港節點,選擇中位延遲較低且抖動較小的路徑。測試時固定本地網路、時段與樣本數;若無線網路結果波動明顯,再以有線或其他連線網路重新測試。圖形工作階段可降低解析度、色彩品質與動態效果;命令與長時間任務則優先透過 SSH 分流。

  • 至少保留一組連續樣本,而不是單次最低延遲。
  • 分別說明網頁存取、SSH、桌面工作階段與檔案傳輸中哪一項異常。
  • 記錄本地連線地區、網路類型、目標節點與異常發生時段。
比較四個節點

核對基礎方案、租用週期與附加項目

帳單核對應從訂單確認頁逐行進行:先確認 GPUMini M4 Core 或 GPUMini M4 Plus,再核對按天、週、月或季選擇的週期、目標節點,以及是否新增儲存空間擴充或 Thunderbolt 5 串聯。不要只比較帳單總額;總額相同也可能來自不同的週期與附加組合。所有金額均以美元結算,可用付款方式為 USDT-TRC20,或透過 Stripe 處理的 Visa、Mastercard、Amex,實際可用付款閘道以結算介面回傳為準。

  • 記錄訂單編號、帳單項目名稱與需要核對的行,不要提交完整付款憑證。
  • 執行個體磁碟空間不足屬於執行問題,應同時提交剩餘空間與主要目錄使用量。
  • 帳單項目與預期不一致時,附上訂單確認頁與帳單列的文字資訊。
查看方案與附加項目定義
命令證據

保留第一處失敗,而不是只複製最後一行

SSH、xcodebuild 與 Fastlane 的末尾都可能只顯示「任務失敗」。真正可用於判斷的資訊通常位於首次報錯位置及其前後數行。

gpumini-diagnostics — zsh read only
$ ssh -v build@node.example
debug1: Connecting to node [port 22]
debug1: Server host key verified
Permission denied (publickey).
↑ 常見失敗位置:使用者名稱、金鑰路徑或金鑰權限

$ xcodebuild -workspace App.xcworkspace -scheme App build
Resolve Package Graph
xcodebuild: error: The workspace does not contain scheme "App".
↑ 常見失敗位置:工作區選擇或 Scheme 未共用

$ bundle exec fastlane build
[build] Running gym
Exit status: 65
↑ 繼續向上尋找第一個 xcodebuild 錯誤區塊
SSH

驗證失敗

提交使用者名稱、目標節點、連接埠、主機驗證結果與完整錯誤行。私密金鑰內容不得放入日誌或工單。

xcodebuild

設定失敗

提交工作目錄、workspace 或 project、Scheme、destination、Xcode 版本與結束碼。

Fastlane

流程失敗

提交 lane、action、相依性版本與第一個錯誤區塊。環境變數只列出名稱及是否存在。

標準順序

五步排查,避免同時變更多個變數

完成一步後再進入下一步,並記錄結果。一次變更多個設定可能讓問題暫時消失,卻無法確認真正原因。

  1. 01

    確認節點狀態

    登入控制台核對執行個體、節點代碼與目前狀態,確認正在查看正確訂單。新加坡、東京、首爾與香港均為常態可訂節點,實際可用狀態以控制台即時回傳為準。

  2. 02

    驗證網路連通性

    檢查網域解析、目標連接埠、延遲、抖動與封包遺失,並使用其他連線網路重新測試。連接埠無法連線與驗證失敗是兩類問題,不應使用相同的處理方式。

  3. 03

    核對登入憑證

    逐字核對使用者名稱、金鑰路徑、檔案權限與主機指紋。不要在多次失敗後盲目替換所有憑證,也不要將密碼或私密金鑰傳送給支援團隊。

  4. 04

    檢查磁碟空間

    檢查系統磁碟區剩餘容量、DerivedData、相依性快取、封存產物與暫存目錄。磁碟壓力可能表現為建置中斷、匯出失敗或工具異常結束。

  5. 05

    讀取建置日誌

    從第一個明確錯誤向前後延伸日誌上下文,記錄命令、目錄、工具版本、結束碼與重現步驟。只提交最後一行通常不足以定位問題。

服務狀態定義

節點全年運作,異常事件依影響範圍更新

GPUMini 的四個節點全年 365 天正常運作,不設定定期停機時段。若發生突發節點事件,狀態資訊會針對受影響節點、開始時間、目前影響、處理進度與恢復結果更新。個別使用者的網路、憑證、磁碟或專案設定問題,不會被誤寫成整站事件。

查看狀態時,先確認節點代碼與執行個體狀態,再比較自己觀察到的時間範圍。問題仍在持續時,不要只提交「無法連線」;應附上本地連線地區、連線方式、完整錯誤、首次發生時間與最近一次重現時間。

診斷資訊最小集合 6 項
節點
SG、JP、KR 或 HK
時間
註明時區的發生時間
入口
SSH、遠端桌面或建置任務
現象
完整錯誤文字與結束碼
重現
可重複的最短操作步驟
日誌
移除密碼、私密金鑰與存取權杖

如何判斷是否需要人工介入:同一問題在完成節點、網路、憑證、磁碟與日誌檢查後仍可穩定重現,或訂單與帳單項目存在明確差異時,應提交工單。一般諮詢也可寄送至 support@gpumini.com

升級至人工支援

讓支援團隊一次取得可判斷的資訊

節點、發生時間、重現步驟與去識別化日誌,是處理技術問題的四項基本資訊。帳單問題還需提供訂單編號與需要核對的帳單列。

控制台工單

適合訂單、執行個體、帳單與持續性故障

工單可關聯目前帳戶中的訂單與執行個體,適合需要核對節點狀態、帳單項目或持續跟進的技術問題。

  • 選擇對應的執行個體或訂單。
  • 寫明節點與含時區的發生時間。
  • 附上重現步驟與去識別化日誌。
登入控制台建立工單
支援電子郵件

適合售前選型與一般諮詢

寄送電子郵件前,先整理工作負載、目標節點、租用週期、並行建置數量、記憶體與儲存空間需求。技術問題同樣不要附上密碼或私密金鑰。

  • 唯一對外電子郵件地址為 support@gpumini.com。
  • 主旨中寫明諮詢類型與目標節點。
  • 內文說明期望結果與目前現象。
查看完整聯絡清單
準備提交問題

先附上證據,再交給人工支援

技術問題請準備節點、時間、重現步驟與去識別化日誌;訂單、執行個體與帳單問題請優先透過控制台工單關聯處理。