低互動負擔
SSH：建置、自動化與日誌
適合執行 xcodebuild、fastlane、安裝相依套件、同步儲存庫、檢查日誌與背景腳本。網路短暫抖動時，可搭配工作階段保持工具，讓遠端工作繼續執行。
- 適合
- 命令、腳本、持續建置
- 優點
- 頻寬使用量低，診斷資訊完整
- 限制
- 不提供 macOS 圖形介面
依工作互動方式選擇，不要只看工具名稱猜測
同一台雲端 Mac 可以同時處理命令列與圖形工作。穩定的做法是讓 SSH 負責長時間工作與診斷，讓 VNC 負責必須看見桌面的操作。
完整桌面
VNC：Xcode、剪輯與視覺化操作
適合使用 Xcode 圖形介面、模擬器、素材管理、剪輯時間軸及其他必須觀察桌面狀態的工作。延遲較高時，應先降低畫質與解析度，而不是反覆重新連線。
- 適合
- 圖形開發、剪輯、互動檢查
- 優點
- 完整操作遠端 macOS 桌面
- 限制
- 對延遲、抖動與頻寬更敏感
先核對五項參數，再發起首次連線
不要沿用其他訂單的位址或連接埠。每次都以目前服務在控制台顯示的連線資料為準。
讀取主機與連接埠
在目前服務詳情中複製主機位址與 SSH 連接埠。位址、連接埠與節點共同構成連線目標；切換節點或服務後，應重新核對。
確認遠端使用者名稱
使用者名稱必須與連線資料完全一致。不要將本機電腦使用者名稱、儲存庫帳號或團隊成員名稱代入 SSH 命令。
收緊金鑰權限
私密金鑰檔案只能由目前的本機使用者讀取。在 macOS 或 Linux 上可執行 chmod 600 ~/.ssh/lemonvm_key，再使用 -i 指定檔案。
核對首次指紋
首次連線出現主機指紋時，先與控制台顯示的資訊核對。只有內容一致時才寫入 known_hosts，不要直接略過檢查。
儲存可重複使用的設定
將 Host、HostName、User、Port 與 IdentityFile 寫入本機 SSH 設定，可減少手動輸入錯誤，但不要將私密金鑰內容寫入設定檔。
命令格式
ssh -i ~/.ssh/lemonvm_key -p 連接埠 使用者名稱@主機位址先建立可用工作階段，再逐步提高畫質
首次連線從中等畫質與較低解析度開始。確認輸入、剪貼簿與視窗切換正常後，再依目前線路餘裕調整顯示參數。
填寫位址
使用控制台提供的 VNC 主機與連接埠，不要沿用 SSH 連接埠。若用戶端要求組合位址，請依用戶端格式填寫主機與連接埠。
從中等畫質開始
優先確保滑鼠、鍵盤與視窗回應。文字清晰度足夠後再提升色彩與影像品質，避免首次連線就佔滿頻寬。
控制解析度
高解析度會增加每影格的傳輸量。網路較弱時，先使用單一顯示器與較低解析度，穩定後再調整遠端桌面尺寸。
檢查剪貼簿
連線後先用一段不含敏感資訊的文字測試雙向複製。不要透過共用剪貼簿傳送私密金鑰、完整存取權杖或長期憑證。
確認全螢幕快速鍵
記下用戶端退出全螢幕及釋放鍵盤擷取的快速鍵，避免遠端組合鍵被本機系統攔截後誤判為工作階段異常。
保留 SSH 診斷通道
VNC 畫面停滯時，先透過 SSH 檢查負載與網路。SSH 仍能連線通常表示實體節點在線，問題更可能位於圖形工作階段或網路鏈路。
連線診斷
從交握、線路到遠端建置逐層驗證
診斷時一次只變更一個變數。先確認 SSH 交握，再觀察網路探測，最後執行一個可驗證的遠端命令。這樣能區分憑證、連接埠、鏈路與工作環境問題。
看到
Connecting to 後沒有回應：檢查位址、連接埠與本機出口限制。進入金鑰協商但驗證失敗：檢查使用者名稱、私密金鑰路徑與檔案權限。
SSH 正常但 VNC 卡頓：降低畫質與解析度，並暫停背景傳輸。
連線正常但建置失敗：讀取完整建置日誌，不要將工作錯誤歸因於網路。
$ ssh -v -p 連接埠 使用者名稱@主機位址
debug1: Connecting to host [位址] port [連接埠]
debug1: Server host key: SHA256:[指紋]
debug1: Authentication succeeded (publickey)
$ ping -c 5 主機位址
5 packets transmitted, 5 packets received
round-trip min/avg/max = 41.2/44.8/49.1 ms
$ ssh lemon-node "xcodebuild -version"
Xcode [目前版本]
Build version [目前建置編號]
$ ssh lemon-node "cd ~/project && xcodebuild build"
** BUILD SUCCEEDED **以相同標準比較五個節點
下表用於觀察不同接入地點至新加坡、東京、首爾、香港與美國西部的相對差異。互動式 VNC 更重視延遲與抖動，背景建置則更重視連線穩定性與持續吞吐量。
測試時段工作日 20:00–22:00，當地時間
樣本次數每組 30 次 ICMP
統計標準排除首個封包後取中位數
接入線路當地固定寬頻或企業光纖
| 接入地點與電信業者 | 新加坡 | 東京 | 首爾 | 香港 | 美國西部 |
|---|---|---|---|---|---|
| 上海 · 中國電信 | 68 ms | 42 ms | 51 ms | 35 ms | 146 ms |
| 北京 · 中國聯通 | 91 ms | 54 ms | 46 ms | 58 ms | 139 ms |
| 深圳 · 中國移動 | 53 ms | 67 ms | 76 ms | 24 ms | 168 ms |
| 台北 · 固定寬頻 | 62 ms | 39 ms | 48 ms | 31 ms | 126 ms |
| 洛杉磯 · 企業光纖 | 171 ms | 112 ms | 124 ms | 143 ms | 27 ms |
閱讀方式：同一接入地點優先比較橫向數值；用於 VNC 時，也要持續觀察抖動與封包遺失。實際連線品質取決於本機 Wi-Fi、電信業者出口、跨境路由與背景傳輸。
依序從本機到遠端縮小範圍
不要同時切換節點、變更畫質與重新啟動用戶端。依照以下六個步驟逐項確認，每一步都記錄調整前後的延遲、封包遺失或操作回應。
檢查本機網路
改用有線網路或穩定的 5GHz Wi-Fi，暫停本機下載與雲端同步。若同一區域網路內的其他裝置也出現抖動，先處理本機鏈路。
觀察跨境線路
連續探測至少數分鐘，區分穩定的高延遲與間歇性封包遺失。短暫尖峰更可能造成 VNC 滑鼠跳動與畫面停頓。
比較所選節點
在新加坡、東京、首爾、香港與美國西部中，選擇更接近主要存取方向的節點。團隊應以主要操作者或建置相依項目所在的方向為準。
降低 VNC 畫質
先降低色彩品質、壓縮等級或影格率，觀察輸入回應是否改善。畫面清晰但操作延遲高時，不要只提高頻寬設定。
降低解析度
暫時切換至單一螢幕與較低解析度。若回應明顯改善，表示每影格資料量已超過目前線路適合的範圍。
暫停背景傳輸
檢查儲存庫拉取、相依套件下載、素材上傳、產物回傳與遠端同步工作。大型檔案傳輸應與即時 VNC 操作錯開執行。
連線資料只提供給需要存取的人
遠端連線的安全邊界由本機金鑰、初始憑證、工作階段鎖定與團隊交接共同構成。不要將長期存取資料貼到公開聊天室或儲存庫。
優先使用金鑰
為不同裝置使用獨立金鑰，私密金鑰只保存在受控終端。裝置退出團隊或遺失後，請及時移除對應的公開金鑰。
更新初始憑證
首次登入完成環境核對後，更新臨時憑證。不要在腳本、建置日誌或儲存庫設定中留下可直接使用的存取資料。
離開前鎖定工作階段
暫時離開時鎖定遠端桌面，不要關閉仍在執行的背景工作。共用工作空間也應同時鎖定本機電腦。
依成員分配存取權
多人協作時記錄誰在什麼時間執行工作，不要共用同一把長期金鑰。交接時說明工作狀態、日誌位置與待處理步驟。
先判斷工作是否仍在執行，再決定是否重新連線
VNC 畫面消失不代表實體節點停止。先使用另一個連線通道確認狀態，避免重複啟動建置、覆寫輸出或中斷仍在執行的工作。
SSH 與 VNC 同時中斷
先檢查本機網路，再測試目標主機與連接埠。網路恢復後重新連線，並查看工作日誌與程序狀態，不要直接重複執行原命令。
確認項目：本機出口、目標連接埠、最近日誌時間已建立連線但遠端沒有回應
透過控制台檢查目前服務狀態，再使用 SSH 驗證系統回應。恢復後檢查電源與工作階段設定，避免長時間工作期間進入不適當的睡眠狀態。
確認項目：SSH 回應、系統時間、執行中的程序SSH 正常但 VNC 畫面異常
降低顯示參數並重新建立圖形工作階段。在確認工作狀態前不要重新啟動整台節點，背景建置可能仍正常執行。
確認項目：遠端負載、圖形工作階段、用戶端設定斷線後建置仍在繼續
重新連線後讀取日誌、結束代碼與產物目錄。只有確認原工作已結束或失敗後，才啟動下一次建置，避免同時寫入相同的輸出位置。
確認項目：程序編號、結束代碼、產物修改時間