工程支援中心

先依序定位，再把問題交給合適的人員

這裡處理雲端 Mac 的交付、遠端連線、SSH、Xcode、CI/CD、儲存空間與帳單問題。先完成五項基礎核對，通常能在一輪檢查內判斷問題位於本地網路、存取資料、macOS 工作階段或建置環境。

需要工程人員介入時，請在控制台工單中附上訂單編號、目標節點、發生時間、截圖與已執行步驟。請勿提交密碼、私鑰或復原憑證。

立即租用雲端 Mac 登入控制台提交工單
7 類
問題入口
5 項
基礎診斷
2 種
聯絡管道
OVPS / INCIDENT ROUTE 快速診斷登錄板
建議核對順序 節點 → 網路 → 憑證 → 工作階段 → 用戶端
  1. 01
    確認節點資料 訂單編號、節點位址、連接埠與帳戶名稱必須對應同一台主機。
    基礎
  2. 02
    驗證網路路徑 切換網路後重新測試，區分本地出口與目標節點問題。
    網路
  3. 03
    核對存取資料 檢查憑證更新時間、SSH 金鑰與主機指紋。
    身分
  4. 04
    檢查 macOS 工作階段 確認圖形工作階段、鎖定畫面狀態與背景工作是否仍在執行。
    工作階段
  5. 05
    排除用戶端差異 記錄用戶端版本、顯示設定、代理伺服器與錯誤原文。
    本地端
全年 365 天正常運作 無法定位時轉入控制台工單
先選擇問題類型

七個入口，避免從錯誤方向開始排查

選擇最接近目前現象的入口。每張卡片都提供第一步檢查與應保留的證據，不會隱藏其他問題類型。

交付

訂單已提交，但存取資料尚未確認

先核對訂單狀態、所選機型與目標節點，再確認控制台是否已產生節點位址、連接埠、帳戶名稱與連線說明。

  • 記錄訂單編號與提交時間
  • 確認所選節點與訂單一致
  • 請勿重複建立相同訂單
遠端連線

圖形介面無法開啟、黑畫面或頻繁中斷

先確認節點位址與連接埠，再使用另一個網路重新測試。保留用戶端名稱、版本、顯示設定與完整錯誤截圖。

  • 確認工作階段未停留在鎖定畫面
  • 降低顯示解析度後重新測試
  • 檢查本地代理伺服器與防火牆規則
SSH

金鑰遭拒、指紋變更或連線逾時

分別檢查本地私鑰權限、公鑰內容、目標帳戶、連接埠與主機指紋。請勿將私鑰貼到工單或電子郵件。

  • 保留附帶時間的錯誤原文
  • 確認公鑰未因換行而損壞
  • 替換金鑰後先保留舊工作階段
Xcode

版本不相容、建置失敗或快取異常

記錄 macOS、Xcode、專案提交版本與相依套件版本。先進行一次不修改程式碼的環境確認，再決定是否清理快取。

  • 保存第一筆實際失敗記錄
  • 區分環境錯誤與程式碼錯誤
  • 清理前記錄快取目錄使用量
CI/CD

runner 離線、工作卡住或工作目錄漂移

確認 runner 服務程序、註冊範圍、工作目錄、並行工作與網路出口。先執行最小測試工作，再恢復完整流水線。

  • 記錄失敗工作編號
  • 檢查 runner 最後上線時間
  • 確認磁碟未被快取佔滿
儲存空間

磁碟空間下降、快取過大或寫入失敗

先按目錄統計使用量，區分專案檔案、相依套件快取、建置產物、記錄檔與暫存檔。請勿直接刪除來源不明的系統目錄。

  • 記錄可用空間與異常目錄
  • 檢查持續增長的記錄檔
  • 清理後重新執行最小建置
帳單

週期、節點、擴充項目或付款記錄需要核對

逐項檢查美元帳單中的機型、租用期間、節點、儲存空間擴充與 Thunderbolt 5 並聯數量，再核對付款管道記錄。

  • 確認日、週、月或季週期
  • 核對擴充項目數量與單價
  • 附上訂單編號，請勿提交付款密鑰
先保留現場，再執行清理或替換。

建置記錄、錯誤原文、用戶端版本、磁碟使用量與發生時間，能大幅減少來回確認。涉及憑證時只描述狀態，請勿傳送密碼、私鑰或復原憑證。

五項基礎核對

把「連不上」拆解成五個可驗證環節

每完成一步都記錄結果。請勿同時更換網路、金鑰與用戶端，否則問題恢復後也無法確認真正原因。

CHECKLIST / 05

快速診斷面板

依序執行
  1. 01
    節點資訊

    在控制台確認訂單編號、節點代碼、節點位址、連接埠與帳戶名稱。複製資訊時檢查前後空格，請勿憑記憶輸入。

    輸出：節點記錄
  2. 02
    網路可達性

    記錄目前網路、代理伺服器與出口環境，分別使用原網路與另一個可信網路重新測試。若只有某一網路失敗，優先檢查本地出口限制。

    輸出：網路對照
  3. 03
    憑證狀態

    確認臨時憑證是否已更新、SSH 公鑰是否完整、私鑰權限是否合理，並核對主機指紋是否與首次記錄一致。

    輸出：狀態說明
  4. 04
    macOS 工作階段狀態

    判斷是整台主機無法連線，還是只有圖形工作階段沒有回應。若 SSH 仍可連線，先檢查工作階段、鎖定畫面與相關程序。

    輸出：工作階段邊界
  5. 05
    本地用戶端設定

    記錄用戶端名稱、版本、顯示解析度、色彩設定、代理伺服器與錯誤原文。使用另一個相容用戶端重新測試時，保持其他條件不變。

    輸出：用戶端對照
可以自行繼續

已定位至單一環節

例如只有某個本地網路失敗、只有舊金鑰遭拒，或僅某個用戶端顯示異常。一次只變更一個變數並重新驗證。

查看連線指南
需要工程支援

跨網路與用戶端仍可重現

將五項核對結果、發生時間與錯誤截圖放入同一張工單。工程人員即可依據證據繼續檢查節點與工作階段。

開啟控制台工單
術語小詞典

先統一對象，避免混淆協定、工作階段與主機

這些詞會出現在交付資料、連線說明與工單回覆中。描述問題時請盡量使用相應術語。

雲端 Mac
透過網路存取的 macOS 工作環境，可用於 Xcode 建置、自動化測試、指令碼工作與本地模型推論。它描述的是使用方式，不代表虛擬化。
物理節點
實際承載訂單的 Apple Silicon 主機及其所在網路位置。節點資料通常包括位址、連接埠與區域代碼。
獨享
一筆有效租用對應一台專用物理主機，不與其他租戶共用同一台主機的運算資源。
非虛擬機器
交付對象是獨享物理主機，不是從共用主機切分出的虛擬執行個體。排障時應同時區分主機狀態與遠端工作階段狀態。
VNC
用於存取 macOS 圖形介面的遠端桌面協定。適合操作 Xcode、查看圖形化工具與驗證桌面工作階段。
SSH
用於命令列登入、指令碼執行、檔案處理與 CI/CD 管理的安全連線方式。連線時需要核對位址、連接埠、帳戶、金鑰與主機指紋。
self-hosted runner
部署在租用主機上的持續整合執行器。專案範圍、工作目錄、並行數量與快取策略由團隊自行設定。
恢復工作階段
遠端桌面中斷後重新進入原有 macOS 工作階段。恢復的是圖形工作階段，不等於重新啟動主機或重新建立建置環境。
連線排障手冊

首次登入、金鑰替換與畫面異常分別處理

展開與目前現象一致的項目，依序執行。每次只變更一個條件，重新測試後再進入下一步。

首次遠端登入失敗，應先檢查什麼？

先從控制台重新複製節點位址、連接埠與帳戶名稱，確認這些資料來自同一筆訂單。接著檢查本地網路是否啟用代理伺服器、連接埠限制或額外防火牆規則。

  1. 記錄用戶端名稱、版本與完整錯誤文字。
  2. 確認輸入欄位中沒有多餘空格，帳戶名稱大小寫保持不變。
  3. 換用另一個可信網路重新測試，但不要同時更換憑證。
  4. 若 SSH 可達而圖形介面無法連線，請在工單中清楚說明這項差異。
更新臨時憑證後，舊連線為什麼仍然失敗？

先完全退出儲存舊憑證的用戶端，再重新建立連線。部分用戶端會快取帳戶名稱或驗證資訊，只修改介面上的密碼欄位不一定能清除舊記錄。

確認新憑證可用後，再刪除舊記錄。請勿在工單、截圖或電子郵件中顯示密碼內容，只需說明更新時間、使用的帳戶名稱與錯誤類型。

如何安全替換 SSH 金鑰而不把自己鎖在外面？

保持目前已連線的 SSH 工作階段開啟，先新增並驗證新的公鑰。使用第二個終端機建立新連線，確認新金鑰成功後，再移除舊公鑰。

  1. 為這台主機產生獨立金鑰，不要重複使用來源不明的金鑰檔案。
  2. 檢查公鑰單行內容是否完整，避免複製時換行或截斷。
  3. 核對本地私鑰權限與目標帳戶。
  4. 保存主機指紋記錄；若指紋意外變更，請暫停連線並提交工單核對。
VNC 出現黑畫面、花畫面或輸入延遲時該怎麼處理？

先判斷 SSH 是否仍可使用。若命令列連線正常，問題更可能位於圖形工作階段或用戶端顯示設定，而非整台物理節點離線。

降低用戶端解析度與色彩品質，關閉本地代理伺服器後重新測試，並記錄問題是否只在全螢幕、縮放或多螢幕模式下發生。請勿連續強制結束多個系統程序。

感覺延遲較高時，如何取得可重複測試的結果？

記錄本地網路類型、目標節點、測試時段、使用協定與用戶端版本。分別在原網路與另一個可信網路上執行相同步驟，並保持解析度、代理伺服器與工作負載一致。

請勿只提供「很慢」的結論。工單中應註明是輸入回應、畫面更新、檔案傳輸或命令回顯變慢，以及問題是否持續出現。

建置問題處理

先固定環境，再分析 Xcode、runner 與磁碟

建置排障的目標不是立即清空所有快取，而是找出哪一層發生變更，並留下可重現的記錄。

步驟 01

確認 Xcode 與 macOS 版本

記錄目前 Xcode 完整版本、命令列工具路徑、macOS 版本與專案提交版本。若團隊有固定基線，先與上一次成功建置記錄比較。

xcodebuild -version
xcode-select -p
sw_vers
步驟 02

核對簽署環境邊界

確認專案設定、憑證檔案、描述檔與建置指令碼的引用關係。工單可以提交遮蓋敏感欄位後的錯誤截圖，但請勿上傳簽署私鑰或密碼。

  • 保留第一筆簽署錯誤原文
  • 記錄失敗的 target 與建置設定
  • 區分本地指令碼錯誤與專案設定錯誤
步驟 03

有依據地清理快取

先記錄 DerivedData、相依套件快取與工作目錄使用量，再只清理與失敗專案相關的目錄。清理後執行一次最小建置，避免並行工作覆蓋結果。

du -sh ~/Library/Developer/Xcode/DerivedData
df -h
步驟 04

重新連線 CI runner

檢查 runner 服務程序、註冊範圍、工作目錄與最後上線時間。使用不含發佈動作的最小測試工作，驗證網路、權限與執行環境。

  • 記錄失敗工作編號與時間
  • 確認沒有重複註冊同一個執行器
  • 檢查工作目錄擁有者與剩餘空間
步驟 05

檢查磁碟增長來源

按專案檔案、相依套件、建置產物、記錄檔與暫存檔分類統計。若空間持續下降，記錄增長目錄與觀察間隔，再提交工單。

df -h
du -sh ~/Library/Developer/*
du -sh ~/Library/Caches/*
不要把重設環境當作第一步。

先保留記錄、版本、磁碟使用量與失敗工作編號。直接清空全部快取或覆寫設定，可能讓問題暫時消失，卻同時失去定位依據。

帳單支援

按週期、設定、節點與加購項目逐行核對

所有訂單均以美元計價與結算。實際可用的付款閘道以控制台即時回傳為準。

美元計價

先確認租用週期

帳單週期可能是日、週、月或季。請勿用日價直接推算其他週期，訂單應以所選機型對應的目錄價格為準。

付款記錄

只核對兩類付款方式

支援 USDT-TRC20，以及 Visa / Mastercard / Amex（經 Stripe）。工單只需提供訂單編號與交易記錄中的非敏感識別資訊。

節點與擴充項目

逐項檢查帳單組成

確認機型、租期、目標節點、附加儲存空間類型與 Thunderbolt 5 並聯數量。可用狀態以控制台即時回傳為準。

附加選項四種租用週期價格
附加選項 每天 每週 每月 每季
+1TB SSD $2.6 $7.1 $13.2 $35.9
+2TB SSD $5.2 $14.2 $26.4 $71.8
Thunderbolt 5 並聯（每台） $2 $5.3 $9.9 $26.9
帳單工單建議附上哪些資料？

提供訂單編號、機型、租用週期、目標節點、加購項目名稱與數量，以及付款記錄中的非敏感交易識別資訊。請勿傳送完整銀行卡號、驗證碼、錢包私鑰或密碼。

提交工單

讓工程支援取得可直接開始排查的資訊

使用中的節點問題，請優先透過控制台工單提交；無法登入控制台時，可寄送電子郵件至 support@officevps.com。

SUPPORT PACKET

一張完整工單應包含六項內容

不含敏感憑證
01
訂單編號

從控制台複製完整編號，避免只寫機型名稱或節點城市。

02
目標節點

註明新加坡、日本（東京）、韓國（首爾）、香港、美國東部或美國西部中的實際訂單節點。

03
發生時間

寫明本地時間與時區，並說明問題是持續發生還是間歇性重現。

04
錯誤截圖或記錄

保留錯誤原文與上下文，遮蓋帳戶憑證、私鑰、簽署資料與其他敏感內容。

05
已執行步驟

依序列出測試網路、用戶端、命令與每一步結果，避免只寫「已全部試過」。

06
預期結果

說明希望恢復連線、確認帳單、重新連線 runner，還是定位具體建置失敗。

使用中問題

控制台工單

適合處理節點、連線、建置、儲存空間與帳單問題。訂單上下文可與工單保留在同一個帳戶中。

登入控制台
無法登入

支援電子郵件

寄送電子郵件時，請寫明帳戶電子郵件、訂單編號與問題摘要。請勿附帶密碼、私鑰或復原憑證。

聯絡 support@officevps.com
升級路徑

知識條目無法解決時，依狀態繼續推進

工單狀態用於說明目前責任方與下一步動作。回覆時沿用原工單補充資料，請勿為同一問題重複建立多張工單。

01
已提交

資料已進入佇列

檢查訂單編號、節點、發生時間、錯誤記錄與已執行步驟是否齊全。資料不足時可在原工單中繼續補充。

02
處理中

工程人員正在複核

可能檢查節點連通性、工作階段狀態、交付記錄或帳單組成。此時請避免重複修改環境，以免新變數覆蓋現場狀態。

03
待補充

需要更多可重複測試的資訊

依工單問題補充記錄、截圖、網路對照或用戶端版本。只提交相關片段，並繼續遮蓋敏感欄位。

04
已解決

驗證恢復並記錄結果

使用原有工作流程完成一次重新測試，記錄真正原因、有效步驟與環境版本，為團隊後續處理保留基線。

進入控制台工單 查看首次啟用步驟
準備部署

選擇獨享物理主機，將建置環境交付至合適節點

三種 Apple Silicon 設定涵蓋輕量建置、日常開發、並行 CI 與本地模型推論。僅支援 USDT-TRC20 與 Visa / Mastercard / Amex（經 Stripe），一律以美元（USD）結算。

立即租用雲端 Mac 查看三種方案