SUPPORT PATH

先定位問題，再提交足夠的診斷證據

這裡提供從首次連線到建置與效能排查的固定檢查順序。先確認本機網路、目標位址、驗證資訊與節點狀態，再進入工具鏈或資源指標檢查，避免反覆嘗試，也讓支援人員更快重現問題。

前往控制台提交工單 查看遠端連線指南 立即租用雲端 Mac
diagnostic-path
01 檢查本機網路 基礎層
02 核對位址與驗證資訊 連線層
03 確認節點狀態 控制層
04 收集工作與資源指標 工作層

FIND THE PATH

依現象搜尋排查路徑

輸入錯誤文字、連線方式、系統工作或節點狀態。搜尋僅比對本頁可見文件，不會上傳輸入內容。

顯示 7 條支援路徑

FIRST SESSION

首次使用清單：先建立可重現的連線基準

不要同時修改多個連線參數。每完成一步就記錄結果，失敗時才能判斷問題位於本機、網路、驗證還是節點端。

  1. 01

    確認節點狀態

    在控制台查看目標節點是否顯示已就緒，並核對節點識別碼、區域與所選機型。節點仍在準備階段時，不應以用戶端錯誤判斷為連線故障。

    完成標準：節點識別碼與訂單一致，狀態允許連線。
  2. 02

    複製登入資訊

    從控制台目前節點的詳細資料複製位址、連接埠與使用者名稱，避免使用舊工單、舊截圖或其他節點儲存的記錄。貼上密碼時注意前後空格與輸入法全形字元。

    完成標準：位址、連接埠與使用者名稱來自同一筆節點詳細資料。
  3. 03

    驗證本機網路

    先確認一般 HTTPS 存取正常，再分別測試辦公室網路與可信任的備用網路。企業出口、防火牆或 Proxy 可能只封鎖特定連接埠，因此「網頁能開啟」不代表遠端連線一定可達。

    完成標準：記錄使用的網路、出口類型與失敗時間。
  4. 04

    校準鍵盤配置

    進入 macOS 圖形介面後，先測試字母、數字、符號、Command 與 Option 對應。若符號位置不一致，也要記錄本機鍵盤配置與遠端所選配置。

    完成標準：終端機可準確輸入指令中的引號、斜線與連字號。
  5. 05

    統一時區與時間

    為工作記錄、CI 記錄與工單時間統一標示時區。排查間歇性錯誤時，「14:20」沒有時區就無法與節點事件對應，建議使用包含時區的完整日期時間。

    完成標準：本機、節點與自動化記錄的時間可相互換算。
建議在第一次成功連線後，儲存一份不含敏感驗證資訊的基準記錄：節點識別碼、區域、連線方式、用戶端版本、鍵盤配置、時區與一次成功連線時間。後續異常可直接與這份基準比較。

DECISION TREE

連線故障決策樹：每次只排除一層

連線逾時通常指向網路或位址，驗證失敗通常指向使用者名稱、密碼、金鑰或用戶端設定。先依錯誤類型分流，再執行五層檢查。

1

本機網路是否穩定

LOCAL

關閉會改變路由的暫時 Proxy 後重試，並使用可信任的備用網路進行對照。若辦公室網路失敗而備用網路成功，記錄出口策略與受影響連接埠，問題應優先交由本機網路管理員處理。

繼續條件：同一目標至少在一個可信任網路上完成連線嘗試。

2

目標位址與連接埠是否屬於目前節點

TARGET

返回控制台重新複製目標資訊，不要從指令歷程重複使用位址。瀏覽器遠端桌面使用控制台提供的入口；SSH 則核對主機、連接埠與使用者名稱是否屬於同一筆連線記錄。

停止條件：位址已變更或記錄來自其他節點，更新後重新測試。

3

驗證資訊是否完整且未被輸入法改寫

AUTH

檢查使用者名稱大小寫、密碼前後空格、金鑰檔案權限與所選身分檔案。SSH 主機指紋首次出現時應與控制台資訊核對；指紋意外變更時暫停連線，並透過工單確認原因。

證據要求：保留錯誤原文，但遮蓋密碼、金鑰內容與完整存取位址。

4

控制台中的節點狀態是否允許連線

NODE

重新整理節點詳細資料，確認狀態、節點識別碼與最後變更時間。如果狀態異常，不要連續執行重新啟動類操作；記錄操作前狀態、已執行動作與每次動作時間，避免覆蓋故障現場。

升級條件：節點狀態異常，或狀態正常但兩個可信任網路均無法連線。

5

用戶端設定是否造成顯示或工作階段問題

CLIENT

瀏覽器頁面空白時，使用目前穩定版瀏覽器並清除該網站的工作階段資料後重試；鍵盤錯位時降為單一配置；SSH 工作階段頻繁中斷時，先關閉終端機外掛程式並使用基本指令建立對照工作階段。

完成條件：記錄用戶端名稱、版本、連線方式與可重現步驟。

錯誤為「逾時」或「無法到達」

優先提交網路類型、失敗時間、目標區域、兩種網路的對照結果，以及控制台節點狀態。不要只提交一張沒有時間與節點識別碼的截圖。

錯誤為「驗證失敗」

優先核對目前節點的使用者名稱、驗證方式與用戶端身分檔案。工單中只填寫驗證方式與錯誤原文，不要傳送密碼、私密金鑰或可直接使用的存取憑證。

BUILD PIPELINE

建置工作排查：從工具版本向外檢查

建置錯誤應以第一次出現的明確錯誤為起點，而不是最後一行的彙總資訊。先固定工具鏈，再檢查簽署、相依性、磁碟與自動化程序。

Xcode 工具鏈

記錄 macOS 版本、Xcode 版本、命令列工具路徑與建置指令。圖形介面與自動化工作若呼叫不同工具路徑，可能在同一節點產生不同結果。

  • 確認工作實際呼叫的 Xcode 路徑
  • 保留完整建置指令與工作目錄
  • 比較成功工作與失敗工作的版本差異

憑證與簽署

區分憑證遺失、設定檔不相容、授權範圍不符與鑰匙圈存取失敗。提交診斷時保留憑證名稱、有效期限與錯誤文字，但遮蓋憑證檔案、密碼及專案敏感識別資訊。

  • 確認自動化程序可存取所需簽署材料
  • 檢查目標、建置設定與簽署設定是否一致
  • 記錄錯誤發生在封存、匯出還是上傳階段

相依性與快取

先判斷失敗是否可由鎖定檔穩定重現，再清理最小範圍的快取。一次刪除所有相依性與建置快取會擴大變數，也可能讓原始問題暫時消失而無法定位。

  • 儲存相依性鎖定檔與套件管理器版本
  • 僅清理與失敗目標直接相關的快取
  • 記錄清理前後第一次建置的耗時與錯誤差異

磁碟與自動化記錄

封存、解壓縮相依性與暫存產物需要額外空間。只查看專案目錄大小並不足夠，還要檢查可用容量、暫存目錄、建置快取，以及自動化程序是否因資源不足而終止。

  • 記錄失敗前後的可用磁碟容量
  • 保留工作開始、結束時間與結束碼
  • 截取首次錯誤前後至少 50 行記錄

PERFORMANCE SAMPLE

效能排查：記錄同一時段的四類指標

單張 CPU 截圖無法解釋磁碟等待、記憶體壓力或網路波動。建議在問題發生前後連續取樣 5–10 分鐘，並標記工作開始與失敗時間。

指標 至少記錄 需要注意的現象 與工作對照
CPU 總使用率、主要程序、取樣時間 單一程序持續佔用、負載突然增加、工作結束後仍未下降 標記編譯、連結、測試或推論開始時間
記憶體 已用記憶體、記憶體壓力、交換空間 壓力持續升高、頻繁使用交換空間、程序遭系統終止 記錄平行工作數量與輸入規模
磁碟 可用空間、讀寫吞吐量、I/O 等待 空間接近耗盡、解壓縮或封存階段明顯等待 區分相依性下載、建置快取與產物寫入
網路 本機網路類型、往返延遲、封包遺失現象 僅特定出口異常、互動卡頓但節點工作正常 區分遠端畫面、相依性下載與程式碼擷取
SAMPLE

取樣要涵蓋異常前後

從工作開始前記錄基準，直到異常後至少 1 分鐘。只有異常瞬間的資料，無法判斷資源是原因還是結果。

COMPARE

保留一次正常工作作為對照

使用相同專案、相依性與平行度記錄一次正常工作，比較各階段耗時與資源曲線，而不只是比較總耗時。

BOUNDARY

先區分互動慢與計算慢

遠端畫面卡頓但節點內工作耗時穩定，通常應優先檢查網路；工作本身耗時增加則繼續檢查 CPU、記憶體與磁碟。

MINIMUM EVIDENCE

最小診斷資訊：讓問題可以重現

支援請求不需要上傳整個專案。以下欄位通常足以完成第一次判斷，缺少時支援人員會要求補充。

  1. 01

    節點與環境

    節點識別碼、節點區域、macOS 版本、Xcode 或用戶端版本。不要填寫密碼、私密金鑰或完整存取憑證。

  2. 02

    準確時間範圍

    使用「日期 + 時分秒 + 時區」，並標明第一次出現、最後一次出現與最近一次重現的時間。

  3. 03

    錯誤原文與結束碼

    複製可搜尋的文字，不要只上傳截圖。保留錯誤碼、失敗階段與首次錯誤前後的記錄內容。

  4. 04

    最短重現步驟

    從已知正常狀態開始，依序列出操作、指令、預期結果與實際結果，並說明重現機率。

  5. 05

    已嘗試的動作

    列出切換網路、更新位址、清理快取或重新啟動工作的時間與結果，避免重複操作覆蓋現場。

ESCALATION RULES

工單升級規則：依受影響對象分類

一張工單只描述一個主要問題。若帳戶存取與節點故障同時發生，請分別建立記錄，避免處理狀態互相覆蓋。

分類 適用情況 建議證據 優先管道
帳戶問題 無法進入控制台、帳戶資料或存取驗證異常 註冊電子郵件、發生時間、頁面錯誤原文、瀏覽器版本 支援電子郵件
節點無法連線 節點顯示允許連線，但瀏覽器遠端桌面與 SSH 都無法建立工作階段 節點識別碼、區域、兩種網路測試結果、錯誤時間與原文 控制台工單
硬體異常 持續出現異常重新啟動、儲存裝置錯誤或無法由單一工作解釋的資源異常 節點識別碼、系統記錄時間範圍、異常前工作、重現頻率 控制台工單
資料相關請求 節點釋出、資料匯出流程或隱私權相關請求 訂單識別碼、請求範圍、期望動作、必要的身分驗證資訊 控制台工單
影響等級 A

整個節點無法連線

節點狀態允許連線，但經過兩種可信任網路測試後，瀏覽器遠端桌面與 SSH 都無法連線。提交節點識別碼、區域與最近一次成功連線時間。

影響等級 B

主要工作受阻

節點可連線，但在固定工具鏈下的建置或自動化工作穩定失敗。提交首次錯誤、完整指令、結束碼與一次最短重現流程。

影響等級 C

設定與使用諮詢

節點可用，問題涉及鍵盤、解析度、相依性快取或工作流程最佳化。說明目前設定、目標結果與已驗證的方案。

SERVICE CONTINUITY

服務持續性與狀態判斷

所有節點皆以全年 365 天正常運作為設計目標，不設定週期性服務中斷。發生異常時，應依影響範圍區分區域網路波動、單一節點故障或本機連線問題。

REGION

區域網路波動

同一地區的多個連線來源在接近時間出現延遲升高、封包遺失或工作階段中斷，但節點內的工作可能繼續執行。

  • 記錄來源城市、電信業者與網路類型
  • 使用可信任的備用網路進行對照
  • 提供開始時間、持續時間與目標區域
NODE

單一節點故障

本機網路與同區域其他服務正常，但目標節點狀態異常、反覆失聯，或出現無法由使用者工作解釋的系統錯誤。

  • 保存節點識別碼與控制台狀態
  • 停止反覆執行可能改變現場的動作
  • 透過控制台工單關聯訂單記錄
LOCAL

本機或用戶端問題

目標節點在備用網路或其他用戶端可正常存取，只有某個辦公室出口、瀏覽器設定或 SSH 用戶端失敗。

  • 比較失敗與成功環境的差異
  • 檢查 Proxy、防火牆與用戶端版本
  • 將網路策略問題交由本機管理員處理

狀態描述應使用可驗證的事實

建議寫法

「節點 SG-示例自 2026-08-08 14:20 +0800 起無法透過 SSH 連線；家庭網路與辦公室網路均逾時，控制台狀態仍顯示允許連線。」

避免模糊描述

不要只寫「伺服器壞了」、「網路很慢」或「偶爾中斷」。缺少節點、時間、網路來源與錯誤原文時，無法確定影響範圍。

QUICK ANSWERS

提交支援請求前的常見問題

節點無法連線時，第一步應該做什麼？

先在控制台確認節點識別碼與狀態，再從目前節點的詳細資料重新複製位址、連接埠與使用者名稱。接著使用可信任的備用網路進行一次對照。尚未記錄狀態前，不要連續執行多個會改變節點狀態的動作。

建置失敗需要提交完整記錄嗎？

優先提交首次錯誤前後至少 50 行、完整建置指令、結束碼、Xcode 版本與發生時間。若完整記錄包含專案路徑、儲存庫位址或簽署資訊，應先去識別化。不要刪除錯誤碼與時間戳記。

為什麼單張效能截圖通常不夠？

截圖只能表示某一瞬間，無法判斷資源變化發生在工作之前還是之後。建議連續記錄 5–10 分鐘的 CPU、記憶體、磁碟與網路指標，並標記工作開始、異常與結束時間。

應該寄電子郵件還是提交控制台工單？

現有訂單、節點、硬體與資料相關請求，優先提交控制台工單，以便關聯訂單與節點記錄。無法進入控制台的帳戶問題，可寄送電子郵件至 support@macworker.com。本網站僅使用這兩種聯絡管道。

哪些內容不能放進工單或電子郵件？

不要提交密碼、私密金鑰、付款憑證、完整存取位址或專案原始碼。記錄中的敏感值可以遮蓋，但應保留欄位名稱、版本、錯誤碼、時間戳記與呼叫順序。

READY TO ESCALATE

已有節點識別碼、時間與錯誤原文嗎？

透過控制台工單關聯現有訂單，提交最短重現步驟與去識別化記錄。若尚未租用節點，可先進入入口網站選擇獨享實體機配置、區域與週期。

前往控制台提交工單 查看雲端 Mac 租用方案