連線與登入
SSH 連線逾時、圖形桌面黑畫面或螢幕共享顯示異常。先確認訂單資訊與網路，再判斷問題出在連線層還是桌面工作階段。
依問題分類
找到合適的排查方式
這四類問題的處理方式不同。付款尚未確認不代表節點故障，建置失敗也不一定需要重新啟動機器。
Xcode 與模擬器
命令列選到錯誤的 Xcode、快取佔用磁碟空間，或找不到簽署身分。檢查版本與鑰匙圈資訊，找出環境差異。
CI runner
互動式終端可以建置，流水線卻失敗。優先檢查執行使用者、PATH、鑰匙圈與模擬器狀態，不要先增加並行工作數。
帳務與續租
鏈上轉帳待核對、信用卡付款失敗或到期時間不清楚。訂單狀態與付款結果以控制台即時顯示為準。
連線排障
先檢查連接埠，再檢查工作階段
主機位址、連接埠、使用者名稱與金鑰要求，請查看控制台的訂單詳情。以下命令中的變數需先依該筆訂單設定，請勿將範例別名當成實際節點位址。
SSH 連線逾時
先分辨連線逾時與驗證失敗。逾時通常發生在 TCP 連線建立之前，請檢查位址、連接埠、本機網路出口與節點狀態；若出現 Permission denied 則表示已進入驗證階段，請檢查使用者名稱與金鑰，不要一再更換連接埠。
nc -vz "$NODE_HOST" "$SSH_PORT"請在本機終端機執行。連線成功只表示該連接埠可連線，不代表驗證已通過。若連線失敗，請改用其他可用網路再次檢查，並記錄兩次結果；若連接埠可連線但無法登入，可使用 ssh -vv 收集驗證階段的記錄。提交前請移除記錄中的使用者名稱、位址與本機路徑等敏感資訊。
VNC 連線後黑畫面
用戶端已連線卻沒有畫面，與連接埠完全無法連線是兩種不同問題。請先中斷重複的圖形連線，再檢查用戶端畫質與桌面工作階段。如果 SSH 仍可使用，可檢查目前的控制台使用者，確認是否已有登入中的圖形工作階段。
stat -f '%Su' /dev/console請在節點的 SSH 工作階段中執行。輸出僅供參考，不能單憑此結果判定桌面服務正常。請勿直接結束不明程序或重新啟動正在建置的節點；請在工單中提供黑畫面發生時間、用戶端名稱、SSH 是否可用，以及工作階段檢查結果，讓支援人員進一步確認。
螢幕共享解析度異常
先確認是遠端解析度變更，還是本機用戶端縮放導致文字模糊。檢查螢幕共享的縮放與自動調整畫質選項，再查看遠端顯示資訊。調整用戶端視窗大小不等於變更遠端顯示模式。
system_profiler SPDisplaysDataType請在節點上執行並查看顯示資訊。若沒有出現預期的顯示模式，請記錄目前解析度、用戶端視窗大小與可選的顯示模式；截圖僅保留顯示設定區域，不要包含專案、憑證或業務資料。請勿一開始就安裝來源不明的顯示驅動程式。
如果 SSH 和圖形連線都無法使用，且更換網路後仍然失敗，請直接提交節點無法連線工單。請勿以反覆重新安裝用戶端取代故障通報。
開發環境
讓終端機與建置使用相同工具鏈
先保留錯誤記錄，再變更環境。以下操作適用於你的獨享實體節點；執行需要權限的命令前，請確認沒有其他團隊工作正在使用該環境。
如何切換 Xcode 版本，並確認流水線實際使用的版本？
先執行 xcode-select -p 與 xcodebuild -version，記錄目前的開發者目錄與版本。確認目標 Xcode 已安裝後，再將開發者目錄切換至其 Contents/Developer。以下路徑適用於 App 名稱為 Xcode.app 的安裝；如果節點使用含版本號的 App 名稱，請依實際路徑替換。
xcode-select -p
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
xcodebuild -versionCI 程序可能透過 DEVELOPER_DIR 覆寫系統設定。若終端機與流水線使用的版本不同，請檢查 job 的環境變數與 runner 服務使用者，不要只查看系統設定。個別工作需要使用其他版本時，建議在該工作中明確指定開發者目錄，避免影響同一節點上的其他建置工作。
何時該清理 DerivedData？如何避免誤刪專案？
先檢查磁碟用量，再決定是否清理。切換工具鏈後若出現快取相關錯誤、索引異常或磁碟空間不足，可以處理 DerivedData；一般編譯錯誤不應直接歸咎於快取。關閉相關建置工作後，先將快取目錄重新命名以便復原，比直接遞迴刪除更容易確認。
du -sh "$HOME/Library/Developer/Xcode/DerivedData"
mv "$HOME/Library/Developer/Xcode/DerivedData" "$HOME/Library/Developer/Xcode/DerivedData.backup.$(date +%s)"只有在目錄存在時才重新命名；Xcode 會在下次建置時重新建立快取。重新命名不會釋出磁碟空間；確認新建置正常後，再依實際備份路徑刪除舊快取。請保留所需的封存產物，不要一併清除 Archives、專案目錄或簽署資料。如果 CI 使用自訂的 -derivedDataPath，請檢查該路徑，而非目前使用者的預設目錄。
匯入簽署憑證後，為什麼建置仍找不到簽署身分？
簽署身分需要有效憑證及其配對私鑰。只有憑證檔案通常無法完成簽署。請使用鑰匙圈存取工具匯入你有權使用的簽署資料，再以實際執行建置的使用者身分檢查可用的簽署身分。請勿在工單中附上憑證檔案或匯入密碼。
security find-identity -v -p codesigning
security list-keychains -d user互動式使用者看得到簽署身分，不代表 runner 服務使用者也看得到。請進一步檢查服務執行帳號、鑰匙圈搜尋清單、解鎖狀態與存取權限。如需調整鑰匙圈存取控制，請只授權必要的簽署工具；不要只為排除一次錯誤就讓所有 App 存取私鑰。提交工單時提供已去識別化的身分檢查結果、錯誤碼與執行使用者類型即可。
本機終端機可以建置，但 CI runner 或模擬器工作失敗，該先檢查什麼？
請在失敗的 job 中執行同一組環境檢查，不要只在 SSH 終端機中執行。比對執行使用者、開發者目錄、Xcode 版本、PATH 與可用的模擬器。服務程序不一定會載入互動式 shell 的設定，因此手動執行成功不代表服務環境一致。
whoami
xcode-select -p
xcodebuild -version
printf '%s\n' "$PATH"
xcrun simctl list devices available如果模擬器清單中沒有目標裝置，請先檢查所需執行環境是否已安裝，以及測試工作的 destination 是否相符。如果 runner 顯示離線，請檢查服務啟動狀態與工作記錄，再確認網路連線與註冊資訊。若沒有基準資料，請先用一項建置工作驗證流程，再逐步增加並行工作數，同時留意統一記憶體與磁碟用量。
獨享表示實體資源不會與其他租用者共用，但不代表同一節點上的多項工作彼此不受影響。GitHub Actions 與 GitLab CI 的完整設定步驟請參閱連線指南。
付款與租期
先確認訂單狀態，再決定下一步
所有費用均以美元計價。僅支援 USDT-TRC20 與 Visa / Mastercard / Amex（透過 Stripe）；實際可用的付款閘道以控制台即時顯示為準。
已轉出 USDT-TRC20，為什麼訂單仍未顯示付款成功？
錢包顯示已轉出、鏈上確認與訂單核對是不同步驟。確認時間會受鏈上處理與付款閘道狀態影響，本頁不提供固定分鐘數。請先確認付款頁面要求的網路、收款位址與金額，再查看該筆交易是否成功，最後檢查控制台中的訂單狀態。
訂單尚未更新時，請勿重複付款。如需人工核對，請提供訂單編號、交易雜湊、轉帳金額與時間，並註明時區。交易雜湊可用來查找交易；不需要也不得提供助記詞、錢包私鑰或密碼。若使用的網路或金額與付款要求不符，請保留交易記錄，並在工單中如實說明。
信用卡付款失敗，或帳單出現待處理款項時，該如何核對？
先查看付款頁面的錯誤訊息與訂單狀態，再確認發卡銀行是否允許該筆美元交易，以及是否需要額外驗證。發卡銀行顯示的待處理授權不一定代表訂單已付款成功；請勿只憑信用卡通知判斷服務是否已交付。
多次付款失敗時，請先聯絡發卡銀行確認拒絕原因，不要短時間內連續重試。若控制台仍未確認付款，但銀行已顯示扣款，請提供訂單編號、付款時間、金額及已去識別化的錯誤訊息；如有付款交易識別碼，也請一併提供。請勿傳送完整卡號、安全碼或簡訊驗證碼。支援人員會根據訂單與付款記錄核對；退款或授權解除狀態仍須依付款閘道與發卡銀行的結果確認。
何時會收到續租提醒？如何避免專案在到期時中斷？
請以控制台顯示的到期時間為準。提醒的實際發送時間與通知狀態，請在控制台確認；本頁不保證固定的提前通知天數，也不應只依收到提醒與否判斷能否繼續使用。建議團隊在專案行事曆中另外登記到期時間，並指定一位負責人確認續租結果。
選擇按日、週、月或季計費後，請確認續租帳單上的機型、附加項目與租期。完成付款後，請再次確認訂單已更新，不要只依賴付款頁面的截圖。到期未續租會影響節點使用；請在到期前備份專案、產物與必要設定。若控制台顯示的時間或金額與預期不符，請先保留帳單編號並提交工單，再決定是否繼續付款。
完整租期價格與儲存空間擴充費用請查看方案頁。已有訂單的帳務爭議，請透過控制台工單核對，勿在電子郵件中附上機器密碼。
工單準備
清楚說明問題，讓排查更順利
已租用的使用者請透過控制台提交工單。支援團隊會依影響範圍安排處理：節點無法連線優先，其餘環境設定與帳務諮詢則依問題類型跟進。
一般諮詢：說明預期結果與實際狀況
開發環境、設定方式與續租核對都可透過工單處理。聯繫時間以 UTC+8 為準，涵蓋亞太工作時段；實際回覆時段與處理進度請以控制台工單提示及回覆為準，本頁不承諾固定時數。
請說明想執行的操作、實際結果與已嘗試的步驟，並附上最精簡的重現命令。如果有多人輪流使用節點，請註明問題發生時是否有並行建置或圖形工作階段，避免將工作衝突誤判為節點異常。
緊急故障：節點無法連線優先處理
如果 SSH 和圖形連線都失敗，導致節點無法用於進行中的工作，請在主旨中註明「節點無法連線」，並提供最後一次正常連線的時間。也請附上更換網路後的連接埠檢查結果，以便判斷問題出在本機網路鏈路或節點端。
緊急優先級用於安排排查順序，不代表保證在固定時間內恢復。如果 SSH 仍可使用，請說明受影響的功能；請勿先清除磁碟、重新安裝或反覆斷電，以免擴大影響並失去診斷線索。
提交前請備妥以下三類資訊
-
訂單與節點
提供訂單編號、機型與節點識別資訊。可選節點包括新加坡、東京、首爾、香港；請勿傳送機器密碼、SSH 私鑰或付款驗證資訊。
-
時間與影響
記錄故障開始時間並註明時區，說明受影響的是 SSH、圖形桌面、建置工作還是付款核對，以及最後一次正常使用的時間。
-
結果與佐證
貼上已去識別化的命令輸出、錯誤碼與最精簡的重現步驟。請裁掉截圖中的專案內容與憑證；同一問題請優先在原工單補充，保留完整的處理脈絡。
如果無法登入控制台，或需要售前、批量諮詢及安全通報，請寄信至 support@xcodenode.com。電子郵件中同樣請勿提供密碼、私鑰、簽署資料或完整信用卡資訊。