雲端 Mac 使用手冊

從訂單欄位到建置記錄，依任務解決使用問題

不必先讀完整本手冊。依目前任務進入對應章節，依序核對租期、節點、連線資訊、開發環境與記錄證據；若仍無法定位，再將完整情境帶入主控台工單。

立即租用雲端 Mac 查看快速入門
5 類任務入口 2 種販售中的配置 5 個可選節點
RUN SHEET

首次使用檢查順序

資料就緒
01
核對訂單 機型、租期、節點與額外儲存空間
ORDER
02
確認連線 位址、帳戶、區域網路與憑證
ACCESS
03
準備工具鏈 Xcode、命令列工具、相依套件與快取
BUILD
04
保留診斷證據 發生時間、錯誤原文與去識別化記錄
TRACE
獨享 Apple Silicon 實體節點 365 DAYS
依目前任務開始

先告訴我們你卡在哪個步驟

輸入任務、狀態欄位或錯誤現象，搜尋結果會直接指向本頁對應的檢查清單。也可以從五類入口開始，不必依章節順序閱讀。

訂單與執行個體欄位

先確認訂單定義了什麼，再判斷執行個體是否異常

訂單決定晶片、記憶體、儲存空間、節點與租用週期。主控台中的狀態欄位描述目前的交付或執行階段，兩者不可混為一談。目錄中組合的實際可用性以主控台即時回傳為準。

訂單核對

五組欄位都必須逐項一致

ORDER PROFILE
租用週期
依日、週、月或季計費。核對目前週期與專案持續時間，不要將不同週期的金額放在同一份預算中。
實體節點
新加坡、日本（東京）、韓國（首爾）、香港、美國東部，共 5 個節點。優先考量團隊存取路徑、程式碼來源位置與資料流向。
基本配置
ArmVMS M4 為 M4、16GB RAM、256GB SSD；ArmVMS Pro（M4 Pro） 為 M4 Pro、64GB RAM、2TB SSD。
額外選項
分別核對 +1TB SSD、+2TB SSD 或 Thunderbolt 5 並聯，確認額外項目與基本配置出現在同一個訂單週期中。
付款方式
僅支援 USDT-TRC20 與 Visa / Mastercard / Amex（透過 Stripe），全部以美元（USD）結算；實際可用的付款閘道以後端回傳為準。
常見狀態

處理中與可連線

「處理中」通常表示訂單資料仍在交付流程中；「可連線」表示連線資訊已產生。狀態變更後，先重新整理訂單詳細資料，再使用詳細資料頁中的最新連線欄位。

定位原則

訂單正確不代表環境已就緒

配置與節點無誤後，還要檢查系統帳戶、磁碟剩餘空間、Xcode 版本與專案相依套件。環境層問題不應透過重複建立訂單處理。

核對配置與價格
管理面板常見欄位與檢查動作
欄位 代表內容 使用者應檢查 不一致時記錄
ORDER ID 訂單的唯一關聯識別碼 工單、帳單與執行個體是否引用相同編號 完整訂單編號
REGION 實體節點所在區域 是否與下單時選擇的節點一致 節點代碼與顯示名稱
TERM 目前租用週期 日、週、月或季及其起訖資訊 週期名稱與訂單截圖
ACCESS 連線資料是否已產生 位址、帳戶與連線方式是否齊全 缺少的欄位名稱
STATE 執行個體目前的執行階段 重新整理後狀態是否變更、連線是否恢復 狀態原文與發生時間
開發環境文件

先讓專案能穩定重複建置，再考慮進一步加速

遷移至雲端 Mac 時，優先恢復工具鏈、相依套件與專案路徑的一致性。不要一開始就複製整套舊環境；先依清單重新建置，有助於減少架構不相容、殘留路徑與快取污染。

01

準備 Xcode 專案

記錄專案要求的 Xcode 主版本、工程或工作區入口、建置 Scheme、目標平台與最低系統版本。首次開啟後先完成相依套件解析，再執行完整建置。

  • 確認工程檔案與子模組完整
  • 檢查 Scheme 是否可用於命令列建置
  • 分開核對簽署配置與程式碼版本
02

命令列工具

先確認目前選取的開發者目錄，再檢查編譯器、版本控制工具與指令碼解譯器。自動化任務應輸出實際工具路徑與版本，避免互動工作階段與執行器使用不同環境。

  • 記錄目前 Xcode 選取結果
  • 確認 shell 初始化檔案沒有互動阻塞
  • 讓指令碼使用明確路徑或可控環境變數
03

相依套件管理

優先依據鎖定檔案與軟體清單恢復相依套件。安裝後檢查 Apple Silicon 架構、二進位檔來源與命令解析路徑，不要預設舊環境中的預編譯檔案仍然適用。

  • 保留相依套件鎖定檔案與安裝記錄
  • 檢查指令碼是否寫死舊機器目錄
  • 將私有相依套件憑證放入受控變數
04

建置快取

快取只保存可重新建置的資料。先以無快取建置驗證基準，再逐步恢復相依套件快取與衍生資料；出現無法解釋的編譯差異時，優先清理目前任務快取，而不是刪除所有專案資料。

  • 區分相依套件快取、編譯快取與最終產物
  • 快取鍵包含工具鏈與相依套件版本
  • 定期檢查快取容量與磁碟剩餘空間
CI/CD 整合

將執行器視為可稽核的實體節點使用

自動化任務應能說明由誰觸發、使用哪個程式碼版本、讀取哪些憑證、產生哪些產物，以及任務結束後清理了什麼。獨享資源可減少資源競爭，但不會取代流水線本身的權限控管。

  1. 01

    注入最小權限憑證

    依儲存庫、相依套件來源與發布目標拆分憑證，只授予目前任務所需權限。憑證透過受控變數傳入，不寫入儲存庫、建置指令碼或記錄。

    CREDENTIALS
  2. 02

    固定執行環境

    記錄提交版本、分支、Scheme、目標平台、Xcode 版本與相依套件摘要。平行任務使用獨立工作目錄，避免共用衍生資料而互相覆寫。

    CONTEXT
  3. 03

    匯出可追溯產物

    封存檔、測試報告、符號檔案與建置記錄應帶有任務識別碼，並在匯出前檢查完整性。失敗任務也要保留足夠記錄以供定位。

    ARTIFACTS
  4. 04

    清理任務環境

    移除暫存憑證、掛載檔案、暫存工作區與不再需要的中間產物。長期重複使用的快取應放入指定目錄，不要與專案原始碼或敏感資料混放。

    CLEANUP
失敗任務至少保留四項證據 任務編號、提交版本、失敗步驟、錯誤記錄原文
查看首次建置清單
AI 實驗指南

先規劃模型、儲存空間與工作階段，再啟動長時間任務

AI 實驗的主要風險通常不是啟動命令，而是模型檔案重複、磁碟持續增長、工作階段中斷，以及結果未及時匯出。開始前建立資料邊界，有助於避免執行到一半才發現空間不足。

容量規劃

依三層目錄整理模型檔案

SOURCE 原始模型

保留來源、版本、授權資訊與校驗摘要。原始檔案只保存一份，避免在不同實驗目錄中重複複製。

CACHE 可重新建立的快取

下載快取、轉換快取與暫存分片放入獨立目錄，空間不足時可清理並重新產生。

OUTPUT 實驗結果

依任務編號封存檢查點、指標、記錄與匯出檔案，並在任務完成後移至長期保存位置。

長時間任務工作階段

訓練、轉換或批次推論任務應脫離暫時的圖形化工作階段執行。啟動後記錄程序識別碼、工作目錄、記錄路徑與復原方式，再測試中斷連線後任務是否仍會繼續。

  • 持續將記錄寫入檔案
  • 使用明確的檢查點間隔
  • 為輸出目錄預留成長空間

備份範圍

程式碼、模型來源資訊、不可重新建立的檢查點與最終結果需要獨立備份。下載快取、暫存分片與可重複產生的中間檔案不應佔用同等的備份資源。

諮詢 AI 工作負載配置
疑難排解決策樹

依層檢查，不要同時變更多個變數

每完成一層檢查，只變更一個條件並記錄結果。網路、憑證、系統、磁碟與建置記錄有明確先後順序；跳過前置檢查，容易將連線問題誤判為開發環境問題。

01

區域網路是否能連到連線位址

核對位址是否完整、目前網路是否限制相關連線，以及切換網路後現象是否一致。記錄用戶端系統、網路類型與錯誤發生時間。

失敗 保留位址欄位與網路錯誤原文
02

連線憑證是否來自目前訂單詳細資料

重新開啟主控台訂單詳細資料，逐字核對帳戶、位址與憑證輸入方式。不要使用舊截圖、瀏覽器歷程記錄或其他執行個體的連線資料。

失敗 記錄缺少的欄位，不要提交憑證原文
03

執行個體狀態是否允許建立工作階段

重新整理執行個體詳細資料，確認狀態欄位是否變更。若狀態與實際連線結果不一致，記錄訂單編號、節點、狀態原文與首次發現時間。

異常 提交狀態欄位與重現步驟
04

磁碟是否有足夠的工作空間

檢查專案目錄、衍生資料、相依套件快取、模型檔案與暫存產物。確認是空間問題後，優先清理可重新建立的快取，不要刪除尚未匯出的建置結果。

不足 記錄總容量、可用容量與主要目錄
05

建置記錄能否定位第一個真正的錯誤

從任務結束狀態往前尋找第一個錯誤，不要只截取最後一行。保留命令、工具鏈版本、提交版本與錯誤情境，並移除權杖、私密金鑰及其他敏感資訊。

未解決 整理去識別化記錄後提交工單
升級支援

無法自行解決時，提交一份可直接開始排查的完整情境

已有訂單的問題，請優先透過主控台工單關聯訂單。售前配置諮詢或無法進入主控台時，可寄送電子郵件至 support@armvms.com。請在同一個工作階段繼續補充資料，避免為同一問題重複建立請求。

必須提供

訂單與節點資訊

提供完整訂單編號、節點名稱、基本配置與額外選項。若問題發生在特定執行個體，請說明主控台中顯示的目前狀態欄位。

時間與重現

描述第一次失敗的操作

寫明發生時間、操作步驟、預期結果與實際結果。若曾多次嘗試，請說明哪些條件變更過，以及哪些條件維持不變。

診斷附件

附上錯誤原文與去識別化記錄

複製完整錯誤訊息，附上相關建置步驟與情境。截圖應包含欄位名稱，但必須遮蓋所有敏感憑證與專案機密。

提交後如何補充新的記錄或重現結果？

在同一張工單或同一個電子郵件工作階段中繼續回覆，註明新增測試的時間、變更了哪個條件以及結果。如此服務團隊可以依時間線比較，不必重新建立情境。

什麼時候應優先使用主控台工單？

訂單狀態、帳單、節點、執行個體連線與交付欄位等已有訂單問題，應優先使用主控台工單。工單可關聯訂單編號，減少來回確認。

售前配置諮詢需要準備哪些資訊？

說明專案類型、平行任務數量、所需 Xcode 環境、預估儲存空間、租用週期與目標節點。大型工程或大型模型推論可特別說明記憶體峰值與模型檔案大小。

準備好排查資料

關聯訂單提交工單，讓問題直接進入正確情境

附上訂單編號、節點、發生時間、重現步驟與去識別化記錄。售前諮詢也可以先查看兩種配置，再提交專案持續時間與資源需求。

登入主控台提交工單 聯絡服務團隊