連線與登入
取得憑證後，先確認位址、連接埠與登入使用者，再檢查本機網路和用戶端。
依問題類型查看
問題分成四類，快速找到解決方向
先確認問題出在哪個環節。連線失敗不一定是節點異常，付款尚未確認也不代表需要再次付款。
計費與續租
先從訂單狀態查起。確認租期、付款方式與交易紀錄，不要只憑用戶端提示判斷是否入帳。
系統與環境
分開排查連線與工具問題。若能登入但建置失敗，請先記下工具版本與完整錯誤訊息。
網路與節點
選擇節點時，地理距離只是起點。實際路由、用戶端畫質與檔案大小也會影響遠端使用體驗。
連線疑難排解
先確認憑證，再檢查網路
別一開始就重裝主機。記下完整錯誤訊息，區分逾時、連線遭拒與驗證失敗，支援團隊才能判斷問題所在。
SSH 逾時：連線尚未進入登入階段
若顯示連線逾時，請優先檢查網路路徑，不要反覆輸入密碼。若顯示連線遭拒，請確認連接埠與服務狀態；若顯示驗證失敗，請參閱下方的憑證檢查。
- 01重新複製位址
開啟控制台中的執行個體詳情，複製目前的主機位址與 SSH 連接埠。貼上時移除多餘空格，不要沿用舊訂單或舊節點的連線紀錄。
- 02檢查本機對外連線
確認本機網路允許連線至該連接埠。公司網路、代理伺服器或安全軟體可能會限制對外連線；可改用另一個你有權使用的網路進行比對。
- 03檢查執行個體與規則
在控制台確認執行個體狀態，並檢查你設定的防火牆與來源 IP 限制。排查問題時不要直接開放所有連接埠；先確認目前的對外 IP 是否在允許範圍內。
在自己的終端機查看詳細連線記錄，替換大寫欄位後執行：
ssh -vv -p SSH_PORT USER@HOST提交記錄前，請遮蔽主機位址、使用者名稱與本機路徑等敏感資訊。請勿上傳私鑰或密碼。
螢幕共享黑畫面：先確認工作階段，再降低畫質
圖形介面黑畫面與 SSH 無法連線是兩種不同問題。先嘗試 SSH，確認主機是否可連線；若命令列運作正常，請著重排查圖形工作階段與用戶端設定。
- 01確認連線方式
依執行個體詳情顯示的資訊連線，不要把 SSH 連接埠當成螢幕共享連接埠。確認用戶端使用的通訊協定、主機與驗證方式都一致。
- 02重新連線目前的工作階段
中斷用戶端連線後再重新連線，確認畫面是否停在鎖定畫面或登入介面。避免多個用戶端同時調整顯示設定，以免問題更難重現。
- 03降低傳輸負載
先降低解析度與畫質，停止上傳大型檔案後再試。若只有特定用戶端出現黑畫面，請記下用戶端版本與設定，並附上螢幕截圖提交工單。
憑證失效：不要把驗證失敗當成網路中斷
出現驗證失敗通常表示連線已到達伺服器。確認登入使用者與驗證方式，比反覆更換節點更有幫助。
- 01確認目前的使用者
使用目前執行個體的登入使用者名稱。重裝系統或遷移後，請重新讀取連線資訊；若你曾自行修改密碼，請使用新密碼。
- 02確認金鑰配對
指定與主機上公鑰相對應的私鑰，並檢查本機私鑰檔案的權限。不要把公鑰檔案當成私鑰交給 SSH，也不要將私鑰傳給支援團隊。
- 03保留完整錯誤訊息
記下失敗發生的時間、驗證方式與錯誤訊息。若重裝後出現主機金鑰變更，請先透過控制台確認執行個體身分，再更新本機紀錄。
計費與付款
先確認訂單狀態，避免重複付款
僅支援 USDT-TRC20 與 Visa / Mastercard / Amex（透過 Stripe），一律以美元結算。實際可用的付款管道以控制台顯示為準。
已轉出 USDT-TRC20，為什麼訂單仍未確認？
錢包顯示已轉出，不代表訂單已完成確認。請核對付款頁面所列的網路、收款位址與應付金額，再查看該筆交易的鏈上狀態。USDT-TRC20 的入帳確認時間取決於鏈上進度，無法保證固定的確認時間。
返回控制台查看訂單付款狀態。請勿向已關閉或不屬於目前訂單的付款資訊轉帳。若交易已確認但訂單狀態仍未更新，請提交訂單編號、交易雜湊、轉帳金額與時間，並註明時區。請勿提供錢包私鑰、助記詞或密碼，也不要因等待而重複轉帳。
Visa / Mastercard / Amex 付款失敗怎麼辦？
先查看付款頁面的錯誤訊息。常見檢查項目包括：信用卡是否允許線上交易與美元交易、可用額度是否足夠、帳單資料是否一致，以及是否完成發卡銀行要求的驗證。必要時請聯絡發卡銀行確認拒付原因，不要短時間內頻繁重試。
若瀏覽器中斷、驗證頁面關閉或頁面返回異常，請先確認控制台中的訂單狀態，再決定是否重試。提交工單時只需提供訂單編號、錯誤訊息與發生時間；截圖請遮蔽敏感資訊。無須提供完整卡號與安全碼，信用卡付款資訊由 Stripe 處理。
如何續租、確認美元金額與下載帳單？
在控制台確認目前訂閱的到期時間，選擇續租並確認報價。付款前請檢查機型、期間、節點與附加項目，付款後再確認新的租期是否已顯示。服務採日、週、月、季預付，不按小時計費；續租金額與生效時間以訂單確認資訊為準。
所有方案價格均以美元計價。XN Core M4 每日 $21.4、每週 $57.7、每月 $106.8、每季 $290.5；XN Pro M4P 每日 $59.3、每週 $160.1、每月 $296.4、每季 $806.2。核對帳單時，請分別查看基本租金與已選擇的附加項目。帳單與可下載檔案可在控制台的帳單紀錄中查看；若無法下載，請附上帳單編號提交工單。
到期前會收到續租提醒，但請勿將提醒當成備份計畫。自行設定行事曆提醒，提早確認付款與租期，並持續將重要成果同步至自己的儲存空間。
系統與環境
先保留工作成果，再調整環境
獨享實體主機，非虛擬機；macOS 圖形介面與命令列皆可使用。安裝工具、切換版本或重裝前，請先確認備份與專案相依項目。
重裝 macOS 前要準備什麼？
先停止執行中的建置、傳輸與實驗工作，再備份程式碼、產出檔案、環境設定與需要保留的憑證檔案。重裝會變更系統環境，也可能清除本機資料，不應當作連線疑難排解的第一步。
登入控制台查看目前執行個體的重裝選項與確認說明。如需協助，請從該筆訂單提交工單，並說明要重裝的執行個體及已完成的備份。完成後重新讀取連線憑證，檢查 macOS 版本、工具路徑與磁碟空間，再還原專案。請勿依據舊連線紀錄判斷新環境是否異常。
如何確認及切換 Xcode 與命令列工具？
先確認專案要求的 Xcode、SDK 與 macOS 版本，再檢查目前選用的開發者目錄。若主機上有多個 Xcode 版本，圖形介面開啟的版本不一定與命令列建置所使用的版本相同。
xcode-select -p
xcodebuild -version
uname -m
df -h前三個指令分別查看開發者目錄、Xcode 版本與架構，最後一個則檢查磁碟空間。Apple Silicon 的原生架構輸出應為 arm64。需要切換時，先確認目標應用程式路徑確實存在，再使用 sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer 選取對應目錄；此指令會影響後續的命令列建置。
使用 Homebrew 前，請檢查 command -v brew 和 brew --version，確認指令來自預期的環境。安裝相依項目時，請依專案鎖定的版本操作，不要同時修改工具鏈、相依項目與建置指令碼。若安裝失敗，提供工具版本、執行指令與錯誤訊息末段，比只寫「無法編譯」更容易找出問題。
到期前要備份哪些檔案？如何確認備份完整？
至少整理三類內容：尚未推送的程式碼與專案設定、建置產出與實驗結果，以及還原環境所需的相依項目清單與授權檔案。憑證與金鑰應加密保存，並依團隊權限分發；不要放進公開儲存庫或工單附件。
可使用 scp 或 rsync 將檔案同步至自己的儲存空間。先傳送少量檔案，確認路徑、權限與可讀性，再傳送完整目錄；完成後比對檔案數量、大小或校驗值，並實際開啟重要產出。加裝 SSD 是外接擴充，不是獨立備份，也不代表資料會自動同步至其他節點。
不要仰賴到期後還原資料。實際保留與清除安排依控制台提示及適用規則為準；若有特殊遷移需求，請在租期結束前提交工單並完成備份。
網路與節點
先選擇符合工作流程的節點，再實際測試
六個節點皆提供兩種機型。選擇時也要考慮使用者所在位置、程式碼與產出檔案的傳輸方向，以及平常使用 SSH 或圖形介面。
如何選擇六個節點？如何判斷延遲？
先依地理位置縮小範圍，再使用自己的網路測試。下表提供選點方向，並非實測延遲保證；電信業者路由與本機網路都會影響使用體驗。SSH 對連續畫面傳輸的需求較低，螢幕共享則較容易受到往返延遲與頻寬影響。
| 節點 | 優先考慮的使用者區域 | 連線時優先檢查項目 |
|---|---|---|
| 新加坡 | 東南亞 | 比較日常網路下的互動反應與程式碼同步速度。 |
| 日本（東京） | 東亞 | 使用常用的螢幕共享用戶端，先從較低畫質開始測試。 |
| 韓國（首爾） | 東北亞 | 比較本機對外路由，不要只看地圖上的距離。 |
| 香港 | 華南與東南亞 | 檢查本機網路限制，以及上傳大型檔案時的反應變化。 |
| 美國東部 | 北美東部與西歐 | 同時觀察建置產出回傳與互動連線的表現。 |
| 美國西部 | 北美西岸 | 確認團隊、程式碼儲存空間與產出接收端的位置。 |
若操作時出現卡頓，先暫停大型檔案傳輸、降低螢幕共享解析度，再進行比對。若問題仍明顯，請記下本機網路類型、節點、用戶端版本與發生時段；不要只憑一次測試就判定整個節點無法使用。
如何跨區遷移至其他節點？
先在原執行個體備份資料，記下工具版本、環境變數、工作設定與網路允許規則。接著在控制台確認目標節點的訂單安排；若需調整現有訂閱，請先提交工單確認費用與生效方式，不要假設切換城市會自動遷移磁碟。
目標執行個體可連線後，再還原檔案並測試編譯、簽署、產出上傳與排程工作。更新團隊使用的主機位址與來源 IP 規則，確認新執行個體運作正常後，再處理原執行個體。遷移期間，請勿讓兩端同時執行會產生重複結果的發布工作。
六個節點各提供哪些機型？
新加坡、日本（東京）、韓國（首爾）、香港、美國東部與美國西部皆提供 XN Core M4（M4 / 16GB / 256GB SSD）與 XN Pro M4P（M4 Pro / 64GB / 2TB SSD）；目錄所列組合供應充足，實際供應狀況以控制台即時資訊為準。
一般 App 編譯與 CI 可選擇 XN Core M4；大量平行建置或需要較大統一記憶體的實驗，可考慮 XN Pro M4P。另可選購外接 +1TB SSD 或 +2TB SSD，不會改變機型本身的主磁碟規格。節點全年 365 天持續運作；若連線異常，仍應依序排查網路、驗證與系統。
工單準備
一次說清楚已完成的檢查
登入控制台，在工單區選擇相關訂單並說明問題。訂單資訊請留在工單中；公開諮詢時不要提供連線密碼或完整付款資訊。
提交前準備以下四項資訊
- 01訂單與執行個體
提供訂單編號、節點城市與機型名稱。若有多台執行個體，請說明是哪一台，避免混入其他主機的記錄。
- 02時間與問題現象
提供首次發生的時間與時區，並說明是持續失敗還是偶爾發生。描述最後一次正常操作，以及問題發生前變更過哪些設定。
- 03重現步驟與檢查結果
列出操作步驟、用戶端或工具版本、完整錯誤訊息，以及已完成的檢查。也可提供使用其他網路或用戶端的比對結果。
- 04已去除敏感資訊的附件
附上必要的螢幕截圖或記錄片段。移除密碼、私鑰、憑證敏感內容與付款安全資訊；保留與問題相關的錯誤碼。
建議依照這個順序說明
節點與機型 → 訂單編號 → 問題時間與時區 → 預期結果 → 實際錯誤 → 已嘗試的檢查。若影響建置或發布，請補充目前受影響的工作，不要只寫「很急」。
提交後，請在同一張工單補充最新結果，保留完整背景資訊。回覆時段、處理進度與預計回覆時間以控制台顯示及工單回覆為準；我們不會承諾未經確認的固定回覆時數。節點運作時間與人工回覆時間是兩回事。
還找不到答案？
選購前請來信諮詢，執行個體問題請提交工單
尚未下單？請說明用途、預計租期與所在區域，詢問適合的機型和節點。已有訂單，請透過控制台提交工單，方便我們將問題與執行個體對應。
售前、團隊採購及其他諮詢，請聯絡 support@xcodenet.com。請勿透過電子郵件傳送密碼、私鑰或完整卡片資訊。