依任務開始排查

連線、設定、建置或網路問題,從對應檢查清單開始

BerryVM 提供整台獨享的雲端 Mac 實體節點。這裡不讓你在泛泛的說明目錄裡繞圈:先確認故障發生在哪一層,再依序收集結果。多數環境問題都能在提交工單前定位到連線、系統、相依套件、建置或網路其中一層。

服務型態
獨享實體機,非虛擬機
節點範圍
新加坡、東京、首爾、香港、美國東部
支援資料
訂單識別碼、節點、時間、步驟、去識別化日誌
首次接入

先完成四項核驗,再開始安裝專案環境

存取資料僅用於建立初始工作階段。連線成功不代表交付核驗完成;請先更新憑據、確認裝置設定與節點,再將程式碼、金鑰或建置任務放入機器。

交付資料

核對訂單與存取資料

確認訂單識別碼、分配節點、裝置名稱、連線方式與資料更新時間一致。不要將存取資料轉發至公開頻道,也不要把憑據寫入專案儲存庫。

  • 訂單識別碼與控制台記錄一致
  • 節點屬於本次訂單選擇範圍
  • 裝置名稱與交付記錄一致
存取控制

首次進入後更新憑據

使用交付資料建立工作階段後,立即換成團隊自行管理的高強度憑據。不同成員使用各自受控的存取方式,避免長期共用同一份秘密。

  • 更新初始登入憑據
  • 移除不再使用的存取授權
  • 將復原資料放入受控保管系統
裝置核驗

確認實體裝置與系統資訊

檢查晶片、記憶體、儲存容量、macOS 版本、時區與剩餘磁碟空間。基本方案應為 M4、16GB、256GB;高記憶體方案應為 M4 Pro、64GB、2TB。

  • 規格與所選機型逐項一致
  • 時區符合團隊任務安排
  • 系統磁碟保留建置與快取空間
工作階段驗證

建立可復原的安全工作階段

分別驗證圖形介面與命令列路徑,記錄本機網路、連線通訊協定與測試時段。長時間任務應放入可復原的工作階段或 Runner,不要依賴單一前景視窗持續連線。

  • 確認圖形介面與命令列均可使用
  • 確認睡眠與電源策略符合任務需求
  • 中斷後重新連線一次,驗證復原路徑
環境初始化

讓工具鏈可重現,而不是只能在目前工作階段執行

先固定系統與工具版本,再復原相依套件、快取與 Runner。每一步都留下可重複執行的清單,之後遷移、重建或擴充裝置時,不必從個人記憶重新拼湊。

初始化清單

開發環境基線

MAC / BASELINE
Xcode

確認專案要求的主要版本、命令列工具選擇路徑、可用 SDK 與建置目標。升級前先檢查現有流程與相依套件相容性。

先固定版本
命令列工具

檢查編譯器、Git、Shell、Ruby、Python 與 Node.js 的實際路徑,避免互動工作階段與 Runner 讀取到不同環境。

核對路徑
Homebrew

匯出公式、圖形應用程式與私有來源清單,依專案需求分批復原。遷移後逐項驗證版本,不要直接複製來源不明的整個目錄。

復原清單
Swift

對照專案宣告檢查 Swift 與 SDK 組合,使用最小專案驗證編譯、測試與封存路徑,再執行完整專案。

最小驗證
CI Runner

確認執行使用者、工作目錄、環境變數來源、快取位置、並行數與日誌保留策略。敏感值透過受控變數注入。

獨立情境
遷移順序

先宣告,再安裝,最後驗證

  1. 匯出清單:版本、相依套件、來源、Runner 標籤與專案腳本。
  2. 復原基礎層:Xcode、命令列工具與套件管理器。
  3. 復原專案層:鎖定檔、私有來源、快取與環境變數。
  4. 執行驗證:分別執行編譯、測試、封存與產物驗證。
不要直接複製秘密

分開遷移憑據與專案檔案

程式碼儲存庫、建置快取、簽名資料與存取憑據不是同一類資料。依最小權限分別遷移,日誌只保留定位所需欄位,提交支援請求前先去識別化。

檢查安全措施
故障定位

依故障層檢查,不要同時變更所有變數

先重現並保留失敗現場,再只變更一個條件。以下五條路徑涵蓋連線、建置、磁碟、相依套件與節點網路問題;每條都列出提交支援請求前應取得的證據。

A

無法建立遠端連線

先確認訂單仍在有效租期內、存取資料是否已更新、目標節點與通訊協定是否正確。再從另一條本機網路測試,區分用戶端設定、本機出口與節點路徑問題。

  • 保留用戶端完整錯誤內容與發生時間
  • 記錄本機網路類型、通訊協定與目標節點
  • 驗證相同資料在另一個受控用戶端上的結果
輸出:連線層結論
B

建置失敗或封存中斷

使用相同提交、相同工具版本與相同命令再次執行。先關閉與問題無關的並行任務,比較互動工作階段與 Runner 的使用者、路徑、環境變數與權限差異。

  • 附上失敗命令、結束碼與第一個有效錯誤
  • 記錄 Xcode、SDK、Swift 與相依套件版本
  • 說明是否只在 Runner 或只在互動工作階段重現
輸出:工具鏈差異
C

磁碟空間不足

分別檢查專案工作區、建置產物、模擬器資料、套件管理快取與 Runner 快取。不要只看根目錄總量;找出成長最快的目錄,並確認是否可安全重建。

  • 記錄剩餘容量與主要目錄用量
  • 區分原始檔案、可重建快取與最終產物
  • 清理前保留最近一次異常成長的路徑資訊
輸出:空間歸因
D

相依套件安裝或版本解析異常

核對鎖定檔、套件來源、代理伺服器、架構與執行使用者。清除快取前先儲存失敗輸出;無差別刪除所有快取可能讓原本可比較的現場消失,並擴大下載與解析變數。

  • 確認鎖定檔是否隨提交變更
  • 記錄實際讀取的套件來源與工具路徑
  • 使用最小相依套件集合驗證網路與解析能力
輸出:相依套件層結論
E

節點網路出現波動

從相同來源、相同通訊協定、相近時段連續取樣,並與另一個網路出口比較。單次 ping 不能代表建置產物上傳、儲存庫拉取或遠端桌面工作階段的完整路徑。

  • 記錄來源網路、目標節點、通訊協定與樣本次數
  • 同時保留延遲、丟包與應用層錯誤
  • 說明受影響的是連線、儲存庫、相依套件來源還是產物目的地
輸出:路徑比較
服務連續性

如何解讀 99.9% 可用率目標

可用率不是單次連線速度,也不等同於任何第三方網路路徑的品質。判斷服務事件時,應結合節點狀態記錄、訂單有效期、影響範圍與服務條款中的統計標準。

服務可用率目標 99.9% 服務可用率目標

所有節點全年 365 天正常運作。適用範圍、排除情形、申請期限與補償方式以服務條款為準。

查看統計與補償標準
近 90 天每日狀態列 每格代表一個日曆日
正常狀態
第 1–30 天
第 31–60 天
第 61–90 天

狀態格用於快速查看每日記錄;工單判斷仍以可核對的節點記錄、影響時段與條款適用範圍為依據。

知識文章

將常見設定與遷移任務拆解成可重複使用的步驟

文章依發布日期排序,涵蓋 MLX、Homebrew、部署方式比較、React Native 建置、遠端除錯準備與資料保護界線。

新文章整理中

知識庫文章發布後會在此依日期顯示。目前可先從上方檢查清單完成連線、環境、建置與網路排查。

提交支援請求

一張可追蹤的工單,應包含這些資訊

支援人員需要先重現或定位問題層級。完整情境可減少來回詢問,但不要為了「完整」而傳送存取密碼、權杖、私密金鑰或未去識別化的專案資料。

支援請求

問題情境清單

5 個必要欄位
訂單識別碼
填寫控制台中可核對的訂單識別碼,不要用自訂專案代號取代。
節點
新加坡、東京、首爾、香港或美國東部,並說明是否只影響該節點。
故障時間
提供包含時區的開始時間、持續時間與最近一次正常時間。
重現步驟
從初始狀態寫到第一個錯誤,每一步註明命令、工具版本與實際結果。
去識別化日誌
保留錯誤情境、結束碼與元件版本,移除憑據、權杖、個人資料與專案秘密。
控制台工單

執行中的訂單優先使用工單

工單可關聯訂單與節點記錄,適合處理連線異常、裝置狀態、建置環境、帳單與服務事件。提交後可在同一討論串補充去識別化日誌與重現結果。

登入控制台建立工單
聯絡分流

一般諮詢、計費問題與運作故障使用不同管道

先選擇能關聯最多情境的管道。運作中的裝置問題優先進入控制台工單;尚未下單的一般諮詢可透過支援電子郵件聯絡。

一般諮詢

設定、節點與使用界線

說明目標工作負載、候選設定、預計租期與團隊所在區域。不要傳送敏感專案檔案,只需描述任務類型與資源需求。

查看聯絡方式
訂單與計費

付款狀態、帳單或租期問題

登入控制台並關聯具體訂單。BerryVM 全部以 USD 結算,僅支援 USDT-TRC20 與 Visa / Mastercard / Amex(透過 Stripe)。

提交計費工單
運作中故障

連線、裝置或節點異常

附上訂單識別碼、節點、含時區的故障時間、影響範圍、重現步驟與去識別化日誌。不要只提交螢幕截圖,也不要傳送存取憑據。

立即提交故障工單
需要一台可直接開始工作的雲端 Mac

依任務選擇設定與週期,再從五個節點中完成交付

Berry M4 適合輕量建置與日常開發,Berry M4 Pro 面向更高記憶體需求的建置與 MLX 實驗。下單前核對機型、日租/週租/月租/季租週期、節點與額外儲存空間。