任務導向支援手冊

從首次連線到建置排錯，依任務找到下一步

DebugMac 提供獨享 Apple Silicon 實體節點，而非虛擬機器。本頁先核對憑證、區域與工具鏈，再透過指令輸出定位連線、建置、儲存或網路鏈路問題。

立即租用雲端 Mac 查看首次使用流程
交付內容
Debug M4 獨享實體節點
連線方式
SSH 與 macOS 圖形介面
支援管道
控制台工單與支援信箱
BREAKPOINT REVIEW DESK 診斷任務單
逐項驗證
CASE / BUILD-042 待重現

先固定輸入，再檢查執行環境

節點
JP · Debug M4
任務
Xcode Archive
入口
SSH 公開金鑰
證據
指令、時間、去識別化日誌
排查路徑
  1. 01核對主機指紋確認連線目標未變更
  2. 02記錄工具鏈版本固定 Xcode 與相依套件輸入
  3. 03縮小問題範圍區分本機、鏈路與節點工作階段
輸入訂單與區域 執行重現與取樣 產出可驗證工單
支援索引

六類任務同時展開，不把關鍵步驟藏在篩選器中

選擇分類會定位並醒目顯示對應章節，其餘指南仍保持可見，方便跨任務核對上下游條件。

首次連線

驗證憑證與主機指紋

準備位址、使用者名稱與 SSH 公開金鑰，先確認指紋，再建立命令列與圖形工作階段。

日常建置

固定 Xcode 與封存輸入

從儲存庫狀態、工具鏈、簽署檢查到封存匯出，保留可重現結果的版本資訊。

CI 自動化

讓 runner 可追蹤、可清理

限制並行工作數，明確管理快取與暫存目錄，並將關鍵建置輸出帶回流水線。

儲存擴充

驗證容量、掛載與並聯裝置

啟用前確認附加項目，交付後核對磁碟容量、掛載點、檔案系統與讀寫目標。

網路診斷

分開檢查本機、鏈路與工作階段

透過延遲、路徑、連接埠與傳輸測試逐層縮小範圍，避免只憑一次 ping 下結論。

帳戶管理

整理成可執行的工單

附上訂單識別碼、區域、發生時間、重現步驟與去識別化日誌，減少重複確認。

SSH 與圖形工作階段

首次連線先驗證目標，再儲存可信基準

交付回執中的位址、使用者名稱、主機指紋與存取簽發狀態應屬於同一筆訂單。任何欄位不一致時，先停止連線並透過控制台工單核對。

連線前準備

準備本機 SSH 私密金鑰、公私鑰對應關係、交付回執與穩定網路。請勿將私密金鑰、完整憑證或未去識別化的設定貼到工單中。

  • 檢查本機私密金鑰權限是否僅限目前使用者讀取。
  • 確認訂單區域為新加坡、日本（東京）、韓國（首爾）、香港或美國西部之一。
  • 首次連線前獨立核對回執中的主機指紋。
  • 記錄首次成功連線的時間、系統版本與預設磁碟容量。
查看完整入門步驟
  1. 01 準備憑證

    讀取交付回執中的主機位址、使用者名稱與指紋；將私密金鑰保留在本機受控路徑，不透過聊天或工單傳輸。

  2. 02 驗證指紋

    首次 SSH 連線顯示的指紋必須與回執一致。已連線過但指紋突然變更時，請勿直接刪除本機記錄後重試。

  3. 03 測試金鑰登入

    先執行唯讀指令確認身分、Apple Silicon 架構、系統時間與可用磁碟，再進入儲存庫或建置目錄。

  4. 04 啟動圖形工作階段

    核對圖形工作階段憑證、顯示解析度與鍵盤配置；首次進入後進行一次安全中斷連線與重新連線測試。

  5. 05 處理斷線

    先區分本機網路中斷、SSH 連接埠無法連線與圖形工作階段中斷。命令列仍可用時，優先儲存日誌與任務狀態。

連線失敗時先保留三項證據

記錄本機時間、完整錯誤文字，以及從同一網路執行的連接埠檢查結果。請勿連續重設憑證，這會覆蓋問題發生時的狀態。

Xcode 工作流程

一併固定儲存庫、工具鏈與封存參數

同一提交在不同 Xcode、相依套件鎖定檔或簽署輸入下可能產生不同結果。排錯時先固定輸入，不要同時升級多個相依套件。

01

擷取儲存庫

記錄提交雜湊、分支、子模組狀態與相依套件鎖定檔。確認工作區沒有未提交變更後，再開始基準建置。

02

選擇工具鏈

使用 xcode-select -p 與 xcodebuild -version 記錄目前的開發者目錄與 Xcode 版本。

03

檢查簽署輸入

核對專案的團隊、Bundle 識別碼、設定名稱與簽署模式。日誌涉及憑證細節時，請先進行去識別化處理。

04

執行封存

明確指定 workspace 或 project、scheme、configuration 與 archivePath，並儲存完整結束碼與日誌。

05

下載產出物

封存完成後驗證檔案大小、校驗值與匯出目錄，再將產出物複製到團隊約定的安全位置。

建置基準指令 敏感值使用範例代稱 
git rev-parse HEAD
xcode-select -p
xcodebuild -version
xcodebuild -workspace "<WORKSPACE>" \
  -scheme "<SCHEME>" \
  -configuration Release \
  -archivePath "<OUTPUT>/App.xcarchive" \
  archive | tee "<LOG_DIR>/archive.log"

成功驗收

結束碼為 0，封存目錄存在，產出物大小符合預期，且日誌中沒有被忽略的簽署或腳本錯誤。

失敗分流

依序判斷相依套件解析、編譯、連結、簽署、腳本階段或匯出失敗，不要將所有問題概括為「Xcode 建置失敗」。

提交證據

提供提交雜湊、Xcode 版本、執行指令、結束碼、失敗階段與去識別化日誌片段，請勿上傳私密金鑰或完整憑證。

CI/CD 自動化

讓 self-hosted runner 的每次執行都有明確邊界

GitHub、GitLab 等流水線可以將 macOS 任務路由至獨享節點。節點不與其他租戶共用執行環境，但同一團隊的任務仍需管理並行工作數、快取與清理。

並行

從單一任務基準開始

先驗證一條流水線完整通過，再逐步提高並行數。多個建置同時寫入相同 DerivedData、鑰匙圈或輸出目錄時，容易互相污染。

  • 每個任務使用獨立工作目錄。
  • 為模擬器與封存路徑加入任務識別碼。
  • 記錄 CPU、記憶體、磁碟峰值與排隊時間。
快取

快取必須帶有可驗證的鍵值

相依套件快取鍵至少包含鎖定檔摘要、工具鏈版本與架構。快取命中後仍要核對相依套件完整性，不能將舊快取視為正確結果。

  • 分開管理相依套件快取與建置中間產物。
  • 切換工具鏈後主動產生新的快取鍵。
  • 記錄命中、回退與重建耗時。
清理

任務結束時回收暫存狀態

無論成功或失敗，都執行清理階段。保留需要回傳的日誌與產出物，刪除暫存金鑰、工作目錄與不再使用的模擬器狀態。

  • 清理步驟使用 finally 或等效機制。
  • 先封存失敗日誌，再刪除工作目錄。
  • 定期檢查磁碟使用量與過期快取。
  1. 01 註冊執行器

    使用團隊控管的短期註冊資訊完成 runner 接入，標籤應明確表示 Apple Silicon、區域與預期工作流程。

  2. 02 建立基準任務

    只執行環境檢查與最小建置，確認儲存庫權限、Xcode 路徑、相依套件下載與產出物回傳均正常。

  3. 03 加入快取

    先測試無快取所需時間，再依鎖定檔與工具鏈建立快取鍵，避免無法判斷快取是否真正有效。

  4. 04 驗證清理

    主動製造一次失敗，確認日誌仍可回傳、暫存資訊已撤銷，後續任務不會繼承上次狀態。

儲存空間與 Thunderbolt 5

先在訂單中確認附加項目，交付後再驗證容量與鏈路

基本配置為 Debug M4：M4、16GB RAM、256GB SSD。+1TB SSD、+2TB SSD 與 Thunderbolt 5 並聯皆為獨立附加項目，不能根據系統顯示推測訂單內容。

附加儲存空間

+1TB SSD

依訂單計費
每日$2.3
每週$6.1
每月$11.3
每季$30.7

啟用前確認目標工作流程、預計峰值與資料遷移方式；交付後核對總容量、磁碟區名稱、檔案系統與掛載路徑。

附加儲存空間

+2TB SSD

依訂單計費
每日$4.6
每週$12.2
每月$22.6
每季$61.4

適合需要保留較多封存檔、媒體素材或模型檔案的任務。容量驗收仍應以系統磁碟資訊與實際掛載結果為準。

按台計費

Thunderbolt 5 並聯

每台獨立計算
每日$1.7
每週$4.6
每月$8.5
每季$23.1

提交前明確並聯台數、任務分配方式與產出物彙總位置。此選項按每台計費，不能用一台的價格推算整組訂單。

  1. 01 核對訂單

    確認附加項目名稱、數量、租期與 USD 金額。實際可用狀態與結算閘道以控制台即時回傳為準。

  2. 02 核對系統

    使用 diskutil list 與 df -h 記錄磁碟、磁碟區與可用空間，避免只查看桌面圖示。

  3. 03 驗證讀寫

    在目標工作目錄執行小規模讀寫測試，確認權限、路徑與實際產出物位置，不要用一次極端測試代表長期表現。

  4. 04 記錄對應關係

    多磁碟或多機協作時記錄「任務—磁碟區—產出物目錄」對應關係，避免清理任務刪除仍需保留的資料。

網路診斷手冊

四組測試區分本機網路、跨區鏈路與節點工作階段

單次延遲或一次斷線不能直接證明問題所在。請在相同網路、相近時間重複取樣，並保留指令、目標、時間與原始輸出。

網路診斷指令、觀察項目與判斷界線
測試 範例指令 重點觀察 可協助區分
基本延遲 ping -c 20 <HOST> 封包遺失、波動、連續逾時位置 本機接入異常與持續鏈路異常
路徑追蹤 traceroute <HOST> 路徑變化、異常跳點、逾時是否持續 本機出口、跨區路徑與目標附近鏈路
連接埠檢查 nc -vz <HOST> 22 連線成功、拒絕或逾時 主機可達但 SSH 連接埠無法連線的情況
傳輸測試 scp <FILE> <USER>@<HOST>:<PATH> 持續速率、重試、檔案校驗值 互動延遲與大型檔案傳輸問題
工作階段檢查 ssh -vv <USER>@<HOST> 解析、握手、金鑰選擇、驗證階段 網路、指紋、金鑰與使用者設定問題

本機網路問題

同一裝置存取多個目標都異常，切換至受控網路後恢復，或本機出口前幾跳已出現持續封包遺失。提交時說明網路類型與複測結果。

跨區鏈路問題

本機接入正常，但特定路徑出現持續波動。應提供多次路徑追蹤，不要將中間跳點無回應直接等同於實際封包遺失。

節點工作階段問題

主機與連接埠可達，但驗證、Shell 或圖形工作階段失敗。此時應重點保留 SSH 詳細輸出、工作階段錯誤與最近操作。

測試口徑

網路結果受本地電信業者、接入方式、跨區路徑與取樣時段影響，僅用於定位問題範圍，不構成效能承諾。所有節點全年 365 天正常運作，可用性依實際服務記錄核驗。

工單準備清單

將支援請求整理成一次可重現的交接

使用中的節點問題請優先透過控制台提交工單。售前或無法登入時，可寄送電子郵件至 support@debugmac.com；兩種管道使用同一份資訊清單。

  1. 01 訂單識別碼

    提供控制台顯示的訂單識別碼與機型 Debug M4，請勿傳送付款憑證、私密金鑰或完整存取密碼。

  2. 02 節點區域

    寫明新加坡、日本（東京）、韓國（首爾）、香港或美國西部，並說明問題是否只在該區域出現。

  3. 03 發生時間

    提供含時區的首次發生時間、最近一次重現時間與持續時間，避免只寫「剛才」或「偶爾」。

  4. 04 重現步驟

    依輸入、執行指令、預期結果與實際結果排列。若無法穩定重現，請說明出現頻率與已觀察到的共同條件。

  5. 05 去識別化日誌

    保留時間戳記、結束碼與錯誤上下文；移除金鑰、權杖、密碼、內部儲存庫位址及其他敏感值。

  6. 06 已完成的排查

    列出已執行的指令、重試次數、網路切換與結果，避免支援人員要求重複同一組基礎檢查。

使用中的節點與帳戶

登入控制台提交工單

工單可與訂單、節點及歷史處理記錄關聯，適合處理連線、建置、儲存、帳單與帳戶存取問題。

進入控制台
售前或無法登入

寄送結構化支援郵件

主旨寫明任務類型與節點區域，正文依本頁清單排列。對外支援信箱僅為 support@debugmac.com。

寄送支援郵件
準備開始

需要一台配置可驗證的雲端 Mac？

選擇 Debug M4、租期與五地節點，提交前再次核對基本配置、附加項目、區域與 USD 應付金額。實際可用狀態以控制台即時回傳為準。

立即租用雲端 Mac 查看配置與價格