裝置狀態
登入控制台核對訂單對應的裝置是否可存取，並確認目前查看的是正確執行個體。不要重複使用舊訂單截圖中的位址。
遠端連線工作單
從連線資訊到穩定桌面，依序連線至雲端 Mac
本指南適用於已取得裝置資訊的開發者。請先核對節點、主機位址與本機網路，再建立 VNC 工作階段；連線後繼續校準顯示、鍵盤與剪貼簿，避免將網路問題誤判為主機故障。
5 個
可選實體節點
1 筆訂單
對應獨享實體主機
365 天
節點正常運作
連線工作單
VNC / DESKTOP ACCESS
準備完成後執行
- 01 讀取裝置資訊 節點、位址、帳戶
- 02 新增遠端主機 儲存正確位址
- 03 完成身分驗證 僅在受信任的裝置上輸入
- 04 驗收桌面工作階段 檢查顯示與輸入
連線異常時不要連續修改多個變數
一次只驗證一項
連線前準備
先確認五類資訊，再開啟用戶端
最常見的遠端連線誤區，是在裝置狀態、位址或本機網路尚未確認時反覆更換用戶端。依照以下順序核對，就能分開處理帳戶、網路與顯示問題。
實體節點
確認裝置位於新加坡、東京、首爾、香港或美國西部的哪個節點。跨區域連線會直接影響輸入回應與畫面更新。
主機位址
逐字元核對位址，不要連同連接埠、空格或說明文字一起複製。位址變更時，請以控制台目前顯示的資訊為準。
帳戶資訊
只在受信任的裝置上輸入連線帳戶與密碼。連線憑證不得放入程式碼儲存庫、群組聊天截圖、公開工單或多人共用文件。
本機網路
優先使用穩定的有線網路或訊號良好的 Wi-Fi，暫停佔滿上傳頻寬的同步工作，並確認本機網路未封鎖遠端連線。
首次連線
四步完成 VNC 首次工作階段驗收
以下流程以 macOS 用戶端為例。每完成一步就確認結果，不要在位址、身分驗證與顯示設定之間反覆切換。
-
步驟 01
取得目前連線資訊
在控制台開啟對應裝置的詳細資訊，記錄節點、主機位址與連線帳戶。若團隊管理多台裝置，請先使用訂單編號與裝置標籤逐一對應。
驗收：訂單、節點與裝置標籤一致 -
步驟 02
新增遠端主機
開啟 macOS 的螢幕共享用戶端，在位址欄輸入控制台提供的主機位址。為項目設定易於辨識的名稱，例如專案名稱、節點與裝置標籤。
驗收：用戶端開始建立連線，而非立即顯示位址錯誤 -
步驟 03
驗證連線身分
輸入裝置對應的連線帳戶與密碼。首次連線時核對主機資訊；若資訊與控制台記錄不一致，請停止操作並重新確認位址。
驗收：身分驗證通過並進入目標裝置 -
步驟 04
進入桌面並完成驗收
等待桌面元素載入完成，依序測試滑鼠、鍵盤、視窗拖曳與剪貼簿。接著開啟終端機確認主機名稱，避免誤在其他裝置上執行指令。
驗收：畫面、輸入、剪貼簿與主機名稱皆正確
顯示與輸入最佳化
先確保互動穩定，再追求更高畫質
高解析度、跨語言鍵盤與多螢幕都會增加遠端桌面的變數。調整時每次只變更一項設定，並記錄變更前後的輸入延遲與畫面清晰度。
解析度與縮放
首次連線先使用較低解析度確認連線穩定，再逐步提高。若文字模糊，優先調整用戶端縮放比例，不要同時變更遠端解析度與本機顯示縮放。
鍵盤配置
確認本機輸入來源與遠端配置一致。中、日、韓輸入法請重點檢查中英文切換與候選字窗；歐洲鍵盤請重點驗證 Option、AltGr、反斜線與符號鍵的對應。
剪貼簿同步
先用一行純文字測試雙向複製，再測試多行指令。不要透過剪貼簿傳送密碼、私密金鑰或未去除敏感資訊的設定；大型檔案應使用受控傳輸流程。
多螢幕
先在單螢幕模式完成連線驗收，再擴充第二個螢幕。遇到黑邊、縮放不一致或游標偏移時，請回到單螢幕並重新確認主、副螢幕排列。
連線延遲參考
主要存取城市至五個節點的 Ping 中位數
下表用於比較相對距離，不代表每條使用者線路的固定結果。數值會受本地電信業者、跨境路由、Wi-Fi 品質與測試時段影響；訂購前可在自己的實際網路環境中重新測試。
測試日期
2026-08-22
連線電信業者
當地主要固網業者
測試時段
當地 14:00–17:00
樣本次數
每條路徑 30 次
統計方式
ICMP 往返中位數
| 存取城市 | 新加坡 | 東京 | 首爾 | 香港 | 美國西部 |
|---|---|---|---|---|---|
| 上海 | 73 ms | 48 ms | 55 ms | 34 ms | 142 ms |
| 深圳 | 42 ms | 66 ms | 72 ms | 21 ms | 151 ms |
| 台北 | 58 ms | 31 ms | 46 ms | 37 ms | 126 ms |
| 大阪 | 78 ms | 18 ms | 35 ms | 61 ms | 113 ms |
| 首爾 | 89 ms | 37 ms | 9 ms | 67 ms | 128 ms |
| 新加坡 | 8 ms | 72 ms | 86 ms | 39 ms | 168 ms |
| 洛杉磯 | 176 ms | 112 ms | 128 ms | 151 ms | 24 ms |
醒目值表示該存取城市在本次樣本中的最低中位數。VNC 互動還會受到抖動、封包遺失與上傳頻寬影響，不能只依據單次 Ping 選擇節點。
安全連線習慣
將遠端桌面視為正式環境入口來管理
獨享實體主機提供資源隔離，但連線安全仍取決於帳戶、憑證與操作習慣。團隊應為每位操作者建立可追蹤的存取界線。
-
使用獨立連線帳戶 不要讓多人長期共用同一帳戶，人員異動時應及時調整授權。
-
設定高強度唯一密碼 不要重複使用程式碼代管、電子郵件或其他系統的密碼，也不要將密碼寫入指令碼。
-
遵循最小權限原則 日常建置帳戶只授予工作所需的權限，管理操作與自動化工作分開執行。
-
定期更新憑證 成員離開團隊、裝置遺失或發現異常登入跡象時，應立即更換相關憑證。
-
離開裝置時鎖定工作階段 即使只是短暫離席，也應鎖定遠端桌面，並關閉不再需要的本機連線視窗。
可以記錄
排查所需的背景資訊
訂單編號、節點、發生時間、macOS 版本、用戶端版本、重現步驟與已去除敏感資訊的錯誤日誌。
禁止傳播
任何連線機密
密碼、私密金鑰、完整連線憑證、儲存庫金鑰與未去除敏感資訊的設定檔，都不應出現在公開溝通區域。
故障排除
依症狀定位，不要同時變更所有設定
先記錄發生時間與目前現象，再從最容易驗證的條件開始。每完成一項檢查就重試一次，以便確認是哪個變數影響連線。
無法建立連線
- 在控制台確認裝置、節點與主機位址對應同一筆訂單。
- 檢查位址是否夾帶空格、說明文字或過期記錄。
- 切換至穩定網路，暫停佔用上傳頻寬的同步工作。
- 記錄用戶端錯誤文字與發生時間，再提交已去除敏感資訊的資料。
連線後黑畫面或桌面未更新
- 等待桌面完成載入，避免連續中斷與重新連線。
- 將用戶端畫質或解析度降低一級後重新觀察。
- 退出全螢幕並切換回單螢幕模式，排除顯示配置問題。
- 若仍沒有畫面，記錄是否能看見游標，以及最後一次正常顯示的時間。
滑鼠或鍵盤輸入明顯延遲
- 連續測試多次 Ping，區分穩定的高延遲與偶發抖動。
- 關閉本機大型檔案上傳、備份與視訊會議後重新測試。
- 降低遠端桌面解析度與畫質，觀察輸入回應。
- 確認建置工作是否持續佔用處理器、記憶體或磁碟。
剪貼簿無法同步
- 先複製一行純文字，排除格式文字與大量內容的影響。
- 分別測試本機到遠端、遠端到本機兩個方向。
- 檢查用戶端是否關閉剪貼簿共享。
- 重新建立工作階段後再測試，不要透過剪貼簿傳送敏感資訊。
解析度、縮放或游標位置錯誤
- 退出全螢幕並恢復單螢幕模式。
- 固定本機縮放比例，再單獨調整遠端解析度。
- 中斷連線後重新連線，確認用戶端已讀取新的顯示設定。
- 記錄本機顯示器解析度、縮放比例與用戶端版本。
工作階段間歇中斷
- 記錄每次中斷的確切時間與持續時間。
- 檢查本機網路是否同時發生 Wi-Fi 漫遊或線路切換。
- 對照自動化工作的時間線，確認是否與高負載工作重疊。
- 保留已去除敏感資訊的用戶端日誌，透過控制台提交工單。
CI 與桌面並行
讓人工操作不干擾自動化建置
遠端桌面與 self-hosted runner 可以同時使用，但兩者會共用同一台獨享實體 Mac 的處理器、記憶體、磁碟與網路。團隊需要明確的觀察指標與操作界線。
並行工作單
桌面工作階段與建置佇列共存規則
先查看資源狀態
開始大型檔案複製、安裝相依套件或進行圖形操作前，查看處理器、記憶體、磁碟空間與網路用量，確認是否有建置正在執行。
分開工作目錄
人工除錯不要直接修改 runner 正在使用的工作區。請為臨時驗證建立獨立目錄，避免清理指令碼刪除其他工作的檔案。
避免高影響操作
建置執行期間不要任意結束關鍵程序、批次清理快取、切換工具鏈版本或重新啟動裝置。必要變更應先暫停新工作進入佇列。
保存問題時間線
記錄異常發生時間、對應儲存庫、runner 標籤、工作編號與人工操作。時間線有助於判斷問題來自網路、資源競爭或環境變更。
建議驗收順序
確認佇列狀態 → 查看資源 → 執行單項操作 → 記錄時間 → 對照建置日誌
連線後的下一步
桌面穩定後，再設定 Xcode 與 runner
先在支援指南中記錄工具版本、工作目錄與 runner 標籤。若連線仍有異常，請保留發生時間、節點、用戶端版本與已去除敏感資訊的日誌，透過控制台工單或支援電子郵件聯絡團隊。
support@globemini.com