無法建立連線
先確認訂單中的位址與連線方式，並確認本機網路及用戶端運作正常；接著檢查帳號是否獲授權存取該執行個體。
如果用戶端顯示錯誤訊息，請保留原文並記下發生時間。請勿同時反覆修改多項設定，以免無法判斷哪項變更有效。
準備疑難排解紀錄
使用與疑難排解
遠端 Mac 遇到問題？先從這裡找答案
依連線、開發環境或訂單問題查找對應檢查項目。請只在控制台訂單中確認連線位址與授權資訊；本頁不會顯示任何實際憑證。
找到對應說明
搜尋問題，或依主題瀏覽
搜尋結果僅限本頁說明，不會查詢您的訂單或連線憑證。若問題涉及特定執行個體，請登入控制台確認。
開始連線前
先確認四件事，再開始檢查用戶端
如果訂單上的節點或連線方式與您手邊的紀錄不同，請以控制台目前顯示的資訊為準。請勿將位址或憑證貼到公開討論區。
- 01訂單與節點確認您查看的是目標執行個體的訂單，並核對所選實體節點及訂單中的連線說明；請勿沿用其他機器的舊紀錄。
- 02本機網路確認本機網路可正常使用；若在受限的辦公網路中，請檢查網路存取政策，再改用允許的網路嘗試連線。
- 03用戶端設定依訂單說明選擇適用的遠端桌面用戶端，逐一確認連線方式、位址與輸入格式。VNC 是遠端桌面操作方式之一，並非所有訂單都只支援這種方式。
- 04帳號與權限確認目前使用的帳號具備該執行個體的存取權限；團隊成員請由管理員確認授權範圍，切勿彼此傳遞登入憑證。
縮小問題範圍
連線異常？依症狀逐一檢查
先記下問題從哪個步驟開始，再一次只調整一項設定並重新測試。網路路徑、用戶端與工作負載都會影響使用體驗，本頁不提供未經確認的固定延遲數值。
已連線，但畫面異常
記下遇到的是黑畫面、顯示比例不正確，還是輸入沒有回應。檢查用戶端的顯示設定，並確認連線期間本機網路沒有頻繁切換。
如果仍能操作桌面，請先儲存工作，再依訂單說明重新建立連線；請勿只憑畫面狀況就判定是節點故障。
查看截圖去識別化要求連線意外中斷
記下中斷時間、當時的操作及用戶端提示；確認本機網路是否切換或中斷，重新連線後再檢查工作狀態。
請勿只憑桌面畫面判斷建置或實驗工作是否完成。請回到專案記錄與產出檔案目錄確認結果，避免重複執行。
檢查工作與記錄
開發環境
分別檢查系統、工具鏈與專案相依項目
可用的 macOS 與軟體版本請以控制台中的實體節點資訊為準。先記錄目前環境，再依專案需求調整；不要將專案相依項目的錯誤誤判為遠端連線問題。
macOS 版本
在桌面查看系統版本，並確認符合專案與工具的最低需求。請記下完整版本資訊，避免只寫「最新版」。
Xcode 版本
確認目前使用的 Xcode、專案需求與所需 SDK。若安裝了多個版本，請確認建置工作實際使用的是哪個版本。
編譯工具路徑
執行 xcode-select -p 和 xcodebuild -version，並確認路徑和版本符合預期；變更選取項目前，請先評估對其他工作的影響。
相依項目與快取
檢查鎖定檔、套件管理工具版本與專案指令碼。先用可重現的最小工作測試相依項目，再決定是否清除快取。
建置工作失敗時，先找出第一個有用的錯誤訊息
區分程式碼檢出、安裝相依項目、編譯、簽署與處理產出檔案這五個環節。使用 self-hosted runner 時，也要確認執行帳號權限、工作目錄，以及金鑰的安全注入方式。
保留失敗指令、結束狀態與已去識別化的記錄；請勿將簽署資料或環境變數的原始值貼進工單。如果桌面操作正常但建置失敗，請優先從專案記錄找出問題。
術語說明
八個詞，先釐清討論對象
使用一致的名稱描述問題，有助於區分機器、地區、連線方式與計費選項。
- 實體節點
- 提供雲端 Mac 服務的實體設備。訂單中的節點資訊可用來確認您選擇的執行位置。
- 獨享實體 Mac
- 由單筆訂單獨享的實體 Mac，而非與其他使用者共用的虛擬機器執行個體。
- 雲端 Mac
- 在遠端實體節點上執行、可依授權方式連線的 macOS 工作環境。
- VNC
- 用於檢視及操作遠端圖形桌面的其中一種連線方式；可用方式請以訂單說明為準。
- self-hosted runner
- 由團隊自行設定與管理，用來執行自動化建置工作的執行器。
- 租期
- 下單時選擇的計費週期，可選日、週、月或季；請以確認後的訂單為準。
- 節點
- 訂購時選擇的地區位置，並不代表固定的網路速度或用戶端連線位址。
- 加購儲存空間
- 基本設定以外另行選購的儲存空間；規格與各週期價格請參閱方案頁面。
訂單與付款
如何確認金額、週期與付款方式？
先確認訂單所選的租期與加購項目，再核對最終顯示的 USD 金額。完整週期價格與加購項目請參閱方案頁面，勿用其他週期的金額推算目前訂單。
訂單以哪種貨幣結算？
所有訂單皆以美元（USD）結算。查看訂單時，請在同一筆訂單中核對機型、租期、加購項目與最終金額；各租期的方案價格分別列出，不是以日租價格直接相乘。
支援哪些付款方式？
支援 USDT-TRC20，以及透過 Stripe 處理的 Visa / Mastercard / Amex。結帳時實際可選的付款管道以後端回傳為準；若付款未完成，請先確認該筆訂單狀態，避免重複提交。
如何確認租期與加購項目？
先到方案與價格頁面查看方案內容，再到控制台訂單確認實際選擇的週期、節點與加購項目。訂單確認資訊才是判斷本次購買內容的依據。
提交工單前
提供可重現的資訊，切勿傳送機密
訂單相關問題請從控制台提交工單，並一併列出已完成的檢查項目，讓支援人員能從尚未排除的環節接續處理。
- 01識別資訊與位置提供訂單識別資訊、所選節點及受影響的執行個體；不必複製連線憑證。
- 02時間與症狀寫明發生時間、時區、用戶端環境、看到的錯誤訊息，以及問題是否每次都會發生。
- 03重現步驟與檢查依序列出操作步驟，並說明已確認的網路、權限、用戶端或專案記錄；請勿只寫「連不上」。
- 04去識別化附件截圖或記錄只保留排查所需的部分；請遮住密碼、金鑰、權杖、簽署資料及無關的個人資訊。
請勿傳送密碼或金鑰。若需補充資料，請只透過控制台工單繼續聯絡；購買前的一般問題也可寄至 support@vpspush.com。