查看機器 IP 與憑證
登入控制台，進入對應的訂單或實例詳情。逐一確認機型、節點、IP、使用者名稱及連接埠，確認實例已交付後再開始連線。團隊有多台機器時，請先用實例編號區分環境。
連線資訊屬於敏感資料。向工程師說明問題時，提供實例編號即可；請勿在電子郵件內文中貼上完整憑證。
查看連線前準備事項開發者支援
先自行查詢，再聯絡我們
先查詢連線、環境與帳單問題，再提交可重現的狀況。以下步驟適用於獨享實體 Mac；實例 IP、連線憑證及訂單狀態，請以登入後的控制台資訊為準。
找不到合適的答案？請在頁尾選擇透過控制台提交工單或以電子郵件聯絡。
還沒選好機型？付款開通前，先確認記憶體、儲存空間與計費週期。
首次連線
先做好這三件事
請以控制台中的實例資訊作為唯一的連線依據。不要從舊記錄複製 IP，也不要將密碼或私鑰存放在公開程式碼儲存庫。
完成首次 SSH 登入
依照實例詳情中的位址與連接埠建立 SSH 工作階段。首次連線出現主機指紋時，請先確認其來源；如果曾重新安裝系統，舊指紋可能不再相符。未確認原因前，請勿直接忽略警告。
登入系統後，先確認目前使用者與工作目錄，再設定金鑰登入。請保留目前的工作階段，確認新的工作階段可成功登入後，再調整驗證設定，避免自己被鎖在機器之外。
查看 SSH 連線步驟連線至 macOS 圖形桌面
使用實例詳情提供的 VNC 連線參數，在相容的用戶端輸入位址與憑證。先以較低解析度確認連線正常，再逐步提高畫質；不要把圖形桌面卡頓直接當成建置速度變慢。
網路不穩時，請降低色深並關閉動態桌布。若只需執行測試或查看記錄，建議優先使用 SSH，減少傳輸桌面影像所造成的等待。
查看桌面連線與調校方式先認識常用術語
八個術語，快速了解機器與連線方式
分清楚實體資源、遠端通訊協定與開發工具，才能更快找出問題所在。
- 實體節點
- 實際部署 Mac 的服務據點。MetalVNC 在新加坡、東京、首爾及香港設有四個亞太節點。選擇時請考量自己的網路路徑；地理距離較近，不代表每條線路的延遲都較低。
- 獨享實體機
- 租用期間可獨自使用整台機器的 CPU、記憶體與磁碟資源，不與其他租用者共用主機。團隊仍可在機器上執行多項工作，但這些工作會共用同一台機器的資源，需自行安排並行作業。
- 非虛擬機
- 工作環境直接執行於實體 Mac，而非共用主機上的虛擬實例。macOS 圖形介面與命令列皆可完整使用；實際建置效能仍取決於專案規模、工具鏈、快取及並行工作數量。
- VNC
- 傳輸桌面畫面並接收鍵盤與滑鼠輸入的遠端連線方式，適合圖形除錯與介面檢查。VNC 不是檔案同步工具；大型原始碼與建置產物應使用合適的檔案傳輸流程另行處理。
- SSH 金鑰登入
- 使用公開金鑰與私密金鑰進行身分驗證。公開金鑰存放於遠端授權清單，私密金鑰則保存在受控的本機裝置或 CI/CD 金鑰庫。請勿將私密金鑰提交至程式碼儲存庫，也不要透過工單傳送。
- self-hosted runner
- 由你管理、負責接收持續整合工作的執行器。你可以在獨享節點上執行建置與測試，但註冊權杖、工作權限、工作區清理及工具鏈版本都需要由團隊管理。
- 程式碼簽署憑證與描述檔
- 這些是程式建置與簽署流程所需的敏感開發資產，並非遠端登入憑證。使用前請確認用途與權限，依照團隊安全流程匯入並限制存取，工作結束後清除不再使用的資料。
- Thunderbolt 5 多機連接
- 供多台機器協同作業使用的選配連線功能，不會自動將多台機器的記憶體合併為同一個記憶體池。下單前請說明機器數量、資料流向與儲存需求；實際選項以設定頁面顯示為準。
環境與使用週期
確認注意事項後，再修改環境
以下常見問題涵蓋開通、系統、開發工具與資料。涉及重新安裝、更換方案或到期處理時，請先備份，再確認訂單適用規則。
下單後多久可以連線至機器？
請先在控制台確認付款與訂單狀態，再查看實例是否已交付。交付完成後，連線參數會顯示在實例詳情中；付款完成頁面不代表機器已可連線。
開通進度以控制台即時顯示為準，本頁不承諾固定所需分鐘數。如果付款狀態已確認，但實例仍未交付，請提交訂單編號與狀態截圖，讓工程師協助查核。
需要重新安裝系統時，應該先做什麼？
請先匯出原始碼、建置產物與必要設定，並確認可從其他位置還原備份。重新安裝可能影響系統磁碟內容、連線憑證、主機指紋及已安裝工具，不應作為一般連線問題的第一個處理方式。
請透過控制台工單提供實例編號、重新安裝原因與所需開發環境，並先確認支援的系統選項、資料處理範圍及執行安排。此頁未預設重新安裝按鈕或固定完成時間。
如何確認並切換 Xcode 版本？
先查看目前選用的開發者目錄與工具版本，再確認專案所需的 SDK 與模擬器執行環境。若安裝多個版本，可以為單次建置指定開發者目錄，避免影響其他正在執行的工作。
xcode-select -p
xcodebuild -version
DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer" xcodebuild -version最後一行的路徑僅供範例，請替換為機器上實際存在的 Xcode 目錄。切換開發者目錄不會自動安裝缺少的 SDK 或執行環境；執行正式工作流程前，請先進行小規模測試。
磁碟空間不足，可以增加儲存空間嗎？
可選購的附加項目為 +1TB SSD 與 +2TB SSD。+1TB SSD 的牌價為 $2.4/天、$6.5/週、$12.1/月、$32.9/季；+2TB SSD 為 $4.8/天、$13/週、$24.2/月、$65.8/季。
以上為附加項目價格，不含機器租金。新訂單請在設定頁面選擇；已交付的實例請先提交工單，確認適用方式、掛載路徑與資料移轉步驟。增加容量不會自動移轉現有工作目錄，操作前仍須備份。
到期後，機器中的資料會保留多久？
請勿將到期後的資料保留視為備份方式。請在到期前完成續約或匯出資料，尤其是尚未推送的原始碼、測試結果及僅儲存在遠端的設定。
實際保留與清除期限，請以訂單適用條款及控制台通知為準；本頁不另行設定天數。若實例已到期，請立即在原訂單下提交工單確認目前狀態，不要假設資料仍可還原。
團隊核銷需要帳單憑證，該怎麼辦？
請先在控制台查看對應訂單的帳單記錄。若需進一步確認憑證格式或抬頭資訊，請在工單中提供訂單編號、所需欄位與用途；請勿傳送完整卡號。
是否能提供符合你所在地區財稅要求的文件，請於付款前確認。美元帳單記錄與當地稅務用途的發票並非同一概念，不應直接視為相同文件。
服務可用率承諾
了解服務承諾與統計方式
各節點全年 365 天正常運作。此處說明服務承諾，不會將尚未接入的監測資料包裝成歷史績效。
月可用率目標
99.9%
月可用率低於 99.9% 時，將按不可用時數的 10 倍補償服務時數。
按月計算，並非建置成功率，也不是 VNC 畫面流暢度指標。不可抗力及使用者自身操作等排除項目，依適用服務條款確認。
近 90 天監測記錄
目前尚未接入公開監測資料，因此不顯示正常運作天數、歷史達標率或每日狀態。下方僅標示資料接入狀態，不代表節點故障。
若發現疑似服務中斷，請儘早記錄開始時間、時區、連線方式與錯誤訊息，並透過控制台提交工單。單次本機網路異常不能直接用來計算節點月可用率，工程師需比對實例端記錄進行查核。
提交故障工單付款與帳務核對
付款前先確認網路與金額
所有費用均以美元（USD）結算。付款閘道是否可用，以結帳時後端介面的回應為準。
USDT-TRC20
請僅使用結帳頁面指定的 TRC20 網路、收款地址與應付金額。請勿將其他訂單的收款資訊用於目前訂單，也不要只憑轉帳截圖認定訂單已完成付款。
款項到帳需經過鏈上確認並由閘道回報，所需時間會受網路與付款服務處理速度影響，沒有固定分鐘數。若已轉帳但狀態尚未更新，請先保存交易雜湊，再透過工單提交訂單編號與轉帳網路，避免重複付款。
確認依據：訂單付款狀態Visa / Mastercard / Amex
卡片付款由 Stripe 處理，請以結帳頁面顯示的金額與付款結果為準。如發卡銀行要求驗證，請完成相關步驟，再返回控制台查看帳單狀態。
若出現付款失敗提示，請記下錯誤訊息與訂單編號，避免短時間內連續重試。提交工單時只需說明卡片類型與失敗步驟，請勿提供完整卡號、安全碼或驗證資訊。
結算幣別：USD續約前確認兩件事
確認續約的對象是正確的實例，再核對帳單週期與附加項目。頁面支援按天、週、月、季計費，但不同週期的總價不能直接當作相同週期的價格比較。付款後的實際到期時間，請回到控制台確認。
-
01
標明對象
提供訂單或實例編號、節點及連線方式。請勿提供密碼、私密金鑰或完整付款憑證；截圖請遮蔽敏感欄位。
-
02
清楚描述狀況
記錄發生時間與時區、上一次成功操作及目前影響範圍。請說明是「只有 VNC 卡頓」、「SSH 也無法連線」，還是「建置命令發生錯誤」。
-
03
附上重現步驟
依實際順序列出命令、預期結果與錯誤摘要。請說明是否更換過本機網路、修改過連接埠或切換過工具鏈；不必上傳整個專案。
| 問題類別 | 提交時請說明 | 預期回覆方式 |
|---|---|---|
| 一般問題 | 選型、帳單欄位、工具鏈設定；請說明預計完成的工作。 | 具體目標回覆時間以工單內確認的資訊為準，本頁不承諾固定時數。 |
| 實例故障 | 無法連線、運作異常；請提供發生時間、影響範圍及已完成的檢查。 | 依業務影響與實例端查核結果安排處理；首次回覆不代表問題已修復，後續進度請在原工單中追蹤。 |
還沒找到答案嗎？
告訴我們你卡在哪個步驟
選型問題請說明用途；連線問題請附上錯誤訊息。若已有工單，請在原討論串補充資訊，避免同一問題分散在多份對話中。