首次開通
連線資訊尚未驗證
適合剛完成訂單，需要核對機型、節點、主機位址、登入方式與初始網路狀態的情況。
查看開通檢查項目
開發工作支援
先保留現場，再沿著任務鏈找出問題
連線失敗、建置錯誤與效能下降通常不是同一類問題。PingMini 依開通、存取、工具鏈、任務執行、儲存與帳戶六條路徑整理排查，讓每一步都有輸入、檢查動作與可驗證結果。
- 6 類入口
- 依目前任務選擇路徑
- 5 項情境資訊
- 訂單、節點、時間、錯誤與步驟
- 2 種聯絡管道
- 控制台工單或支援信箱
BUILD SUPPORT BOARD
任務現場分流
準備排查
ACCESS
核對位址與指紋
網路
XCODE
固定版本並重現建置
記錄
RUNNER
隔離失敗任務目錄
任務
STORAGE
檢查空間與快取增量
容量
先記錄發生時間與最後一次正常狀態
CASE READY
選擇入口
從正在執行的任務開始，不要從錯誤碼猜起
先選最接近目前阻塞點的入口。每條路徑都列出應保留的資訊與下一步動作；若問題跨越多條路徑，請從最早出現異常的環節開始。
遠端連線
工作階段、網路或認證資料異常
適用於圖形桌面、SSH、主機指紋、連線逾時、鍵盤配置或剪貼簿策略相關問題。
檢查連線鏈路
開發環境
Xcode 與工具鏈不一致
適用於版本切換、命令列工具、憑證與描述檔、依賴快取以及建置記錄定位。
進入工具鏈排查
CI/CD
自託管任務執行失敗
檢查任務註冊、工作目錄權限、鑰匙圈存取、並行策略與失敗任務回收是否形成完整閉環。
核對任務執行鏈
儲存與效能
空間增加或任務變慢
區分系統磁碟、附加 SSD、建置快取與專案資料，避免將容量問題誤判為運算能力問題。
查看容量規劃
帳戶與訂單
需要核對訂單、續期或權限
準備訂單號碼、節點代碼、發生時間與操作範圍，再透過控制台提交與服務狀態相關的請求。
準備支援請求
首次使用路徑
透過四次確認建立可重現的起點
首次連線時，不要同時遷移專案、修改工具鏈並接入自動化任務。先確認節點、認證資料與網路可用，再逐層加入開發環境。
-
01
結果：欄位完整
取得連線資訊
在控制台開啟對應訂單，記錄主機位址、連線方式、帳戶名稱與節點代碼。不要只儲存螢幕截圖，應將訂單號碼與連線資訊放入團隊可控的交接記錄。
-
02
結果：配置一致
核對節點與機型
確認訂單中的節點、晶片、記憶體與 SSD 符合實際用途。三檔目錄配置分別為 M4 / 16GB / 256GB、M4 / 24GB / 512GB、M4 Pro / 64GB / 2TB。
-
03
結果：重新登入成功
完成首次登入並修改認證資料
先建立一次最小工作階段，確認可以進入桌面或命令列，再修改初始認證資料。修改後立即登出並重新連線，確認新認證資料確實生效。
-
04
結果：基線可重現
驗證網路與基本命令
檢查 DNS 解析、程式碼儲存庫存取與依賴來源連通性，並執行一個不會修改系統狀態的基本命令。記錄本地網路、用戶端與失敗時間，方便後續區分鏈路問題。
Xcode 與工具鏈
將「建置失敗」拆分為版本、權限、快取與記錄
同一份程式碼在不同環境出現不同結果時，先固定工具鏈輸入。不要一邊升級 Xcode、一邊清除快取，再用一次偶然成功判斷問題已經消失。
建議排查順序
VERSION
確認目前的 Xcode 與命令列工具
版本記錄
記錄圖形介面版本、建置版本號碼以及命令列工具實際指向。專案、指令碼與 CI 應使用同一套可確認的工具鏈。
SIGNING
檢查憑證與描述檔範圍
權限範圍
核對檔案是否存在、權限是否正確、CI 執行帳戶是否可以存取所需的鑰匙圈，並記錄失敗發生在解析、封存還是簽署階段。
CACHE
分層清理快取
單一變因重測
先清除專案衍生資料，再處理套件管理器快取，最後才考慮較大範圍的環境清理。每次只變更一層，並重現同一個建置。
LOG
保留第一個真實錯誤
完整記錄
從完整記錄中定位最早的失敗步驟、命令、目標與結束碼，不要只複製最後一行摘要資訊。
CI/CD 排查
先確認執行器健康，再重現失敗任務
自動化失敗可能來自註冊狀態、執行帳戶、工作目錄、鑰匙圈或並行競爭。請依任務生命週期檢查，避免反覆註冊執行器掩蓋根本原因。
確認任務註冊狀態
核對執行器是否上線、標籤是否相符、執行帳戶是否為預期帳戶。若任務未被領取，先檢查佇列規則與標籤，不要直接重新安裝工具鏈。
- 輸入
- 執行器名稱、標籤、佇列狀態
- 驗收
- 最小測試任務可被領取
驗證目錄與鑰匙圈權限
使用實際執行帳戶檢查工作目錄、快取目錄與產物目錄的讀寫權限，並單獨驗證建置所需的鑰匙圈是否可存取。
- 輸入
- 執行帳戶、目錄路徑、權限結果
- 驗收
- 無需提升權限即可完成最小建置
限制並行並回收殘留
將並行數量降至可控範圍，檢查殘留程序、鎖定檔案、暫存目錄與未完成的封存作業。失敗任務結束後，應明確制定回收策略，而不是繼續佔用環境。
- 輸入
- 並行數量、程序清單、磁碟使用量
- 驗收
- 連續重現結果保持一致
註冊健康
權限明確
單一任務通過
逐步恢復並行
SSH 連線 Mac
分別驗證金鑰、指紋、網路與權限
連線逾時與身分驗證失敗屬於不同階段。先確認網路可以連達主機，再檢查主機指紋與金鑰權限，最後驗證非互動式命令。
最小連線流程
先使用明確參數建立一次乾淨的工作階段
- 準備金鑰：為目前用途建立獨立金鑰，限制私密金鑰檔案權限，不要在多人之間複製同一份私密金鑰。
- 確認指紋：首次連線前，從可信的訂單資訊核對主機位址；指紋變更時先停止連線並查明原因。
- 檢查逾時：確認本地網路、出口策略、主機位址與連接埠，不要將逾時誤判為密碼錯誤。
- 收緊權限：使用完成任務所需的最小帳戶權限，並透過非互動式命令驗證自動化可用性。
ssh -i ~/.ssh/pingmini_ed25519 user@host
ssh -i ~/.ssh/pingmini_ed25519 user@host "uname -a"
連線逾時
輸出：鏈路結論
檢查連達路徑
記錄本地網路、主機位址、連接埠、發生時間與用戶端錯誤。先確認網路可達，再處理身分驗證。
身分驗證失敗
輸出：權限結論
檢查金鑰與帳戶
核對使用的私密金鑰、目標帳戶、檔案權限與伺服器端授權範圍，不要連續嘗試不確定的認證資料。
儲存與效能
先找出哪一類資料正在增加
系統磁碟、附加 SSD、專案資料與建置快取的生命週期不同。容量規劃應同時考慮目前專案、尖峰建置、封存產物以及租期結束前的遷移空間。
| 儲存類別 | 適用內容 | 重點觀察 | 建議動作 |
|---|---|---|---|
| 系統磁碟 | 作業系統、工具鏈、必要應用程式與基本配置 | 可用空間、暫存檔案與工具鏈版本數量 | 避免長期堆放封存產物，保留安全餘量 |
| 附加 SSD | 大型專案、素材、模型、建置產物與團隊交接資料 | 持續寫入量、單一專案尖峰與遷移耗時 | 依活躍資料與封存資料分目錄管理 |
| 建置快取 | 衍生資料、依賴快取與可重新產生的中間檔案 | 命中率、增加速度與失敗任務殘留 | 設定回收規則，不要與唯一的專案資料混放 |
| 專案資料 | 程式碼、配置、素材、測試資料與最終交付檔案 | 是否有獨立副本、權限範圍與交接負責人 | 依專案建立備份與租期結束前的遷移清單 |
記錄可用空間與每日增長量
匯入專案前記錄初始使用量；正常執行後再記錄典型工作日增量。兩組資料有助於判斷是持續增長、突發封存還是失敗任務殘留。
同時容納輸入、中間檔案與產物
影片轉碼、大型封存與模型測試可能同時保留來源資料、中間檔案與輸出結果。不要只依最終產物大小選擇空間。
區分磁碟壓力與運算壓力
記錄任務耗時、可用空間、並行數量與快取狀態。空間接近上限、頻繁清理或多個任務爭用同一目錄，都可能造成任務變慢。
安全處置流程
發現異常時，先收斂存取範圍
疑似認證資料外洩、異常登入、成員交接與租期結束屬於四種不同情境，但都應依照停止擴散、保留記錄、輪換存取權限並驗證清理的順序處理。
暫停相關存取
停止繼續分享認證資料，結束不必要的工作階段，暫停可能擴大影響的自動化任務。在尚未記錄現場前，不要大範圍刪除記錄。
記錄異常情境
整理訂單號碼、節點、發現時間、異常來源、受影響帳戶與最近一次正常操作，保留必要的用戶端與任務記錄。
輪換認證資料與金鑰
更換受影響的登入認證資料、SSH 金鑰與自動化存取材料，並撤銷不再需要的團隊成員權限。避免只修改一處後繼續重複使用舊金鑰。
驗證並完成清理
重新測試必要的存取，確認舊認證資料已失效。在專案交接或租期結束前，遷移專案資料、建置產物、金鑰與憑證材料，再依清單清理節點。
升級支援路徑
讓請求攜帶足夠資訊，直接進入排查
一般諮詢與服務中問題會依影響程度與可執行情境分別處理。資訊越完整，就越少需要往返確認基本欄位。
提交前的五項資訊
訂單號碼
用於關聯機型、租期與服務記錄。
節點代碼
填寫與訂單一致的 SG、JP、KR、HK 或 US-E 其中一項。
發生時間
註明時區，並補充最後一次正常操作時間。
錯誤訊息
保留完整文字、結束碼與最早失敗位置，不要只提交截斷的螢幕截圖。
重現步驟
從可正常運作的起點開始，逐步寫出命令、輸入、預期結果與實際結果。
連線失敗時，應該先提交螢幕截圖還是文字錯誤？
優先提交可複製的完整錯誤文字、用戶端名稱、發生時間與操作步驟。螢幕截圖可補充介面狀態，但不能取代主機位址核對、結束碼與網路階段判斷。
建置偶爾成功，是否代表節點已恢復正常？
不能只憑一次成功下結論。請在固定 Xcode 版本、相同程式碼提交、相同依賴與相同並行條件下連續重現，並記錄成功與失敗之間的輸入差異。
任務變慢時，是否應該直接升級機型？
先記錄 CPU、記憶體、可用空間、快取狀態、並行數量與任務階段。若瓶頸來自空間不足、目錄爭用或失敗任務殘留，單純更換配置無法消除原因。
下一步
準備好情境資訊，再將問題交給支援團隊
若你仍在選型，先查看三檔固定配置；若服務已開通，請帶上訂單號碼、節點、時間、錯誤訊息與重現步驟提交工單。