互動操作
遠端 Mac 桌面
適合使用 Xcode 圖形介面、檢查模擬器、調整專案設定、查看建置結果及恢復上次的開發現場。它保留完整桌面脈絡，但對延遲、解析度與網路抖動更敏感。
- 需要看見視窗、選單與圖形回饋
- 需要使用本機鍵盤、滑鼠與輸入法
- 需要重新進入仍在執行的桌面工作階段
遠端開發連線指南
將雲端 Mac 桌面
將雲端 Mac 桌面
接回你的開發現場
每個執行個體對應一台獨享實體 Mac，而非虛擬機器。圖形介面用於互動式開發，SSH 負責命令列與自動化，檔案傳輸則用於受控地移動專案與產出物。
3 種任務入口
4 項連線前核對
1 套安全登出順序
REMOTE SESSION RUN SHEET
獨享實體節點
本機電腦
顯示與輸入
加密連線
桌面 · SSH · 檔案
雲端 Mac
獨享資源
圖形工作遠端桌面
建置工作SSH
資料移動檔案傳輸
連線方式取決於你正在做什麼
遠端 Mac 桌面並非所有任務的唯一入口。將互動操作、自動化執行與檔案移動分開處理，連線會更穩定，權限界線也更清楚。
命令與自動化
SSH
適合執行 xcodebuild、Fastlane、儲存庫操作、記錄檢查與長時間指令碼。畫面頻寬需求低，網路短暫波動時也更容易復原，是自動化任務的優先入口。
- 需要複製命令或批次執行指令碼
- 需要查看持續輸出的建置記錄
- 需要將長時間工作放入可復原工作階段
受控傳輸
檔案傳輸
適合移動素材、封存記錄、同步建置產出物或取回匯出檔案。優先使用加密協定傳輸，先確認目標目錄與剩餘空間，再開始大型檔案工作。
- 傳輸前核對檔案大小與檢查結果
- 避免將敏感憑證寫入共用目錄
- 完成後清理不再使用的暫存副本
先確認五項資訊，再開啟用戶端
連線失敗通常不是用戶端故障，而是位址、憑證、網路或顯示參數與目前執行個體不符。先完成這張執行前檢查表，可減少反覆嘗試。
節點位址
從控制台執行個體詳細資訊複製目前的主機位址與連接埠，不要使用聊天記錄或舊文件中的歷史值。位址變更時，同步更新已儲存的連線設定。
帳戶與憑證
確認使用者名稱屬於目前的執行個體，並使用最新憑證。不要將密碼、私密金鑰或復原資訊寫入專案儲存庫、建置記錄或共用筆記。
本機網路
優先使用穩定的有線網路或訊號可靠的 Wi-Fi。若公司網路限制遠端協定，先檢查出口政策、代理伺服器與本機防火牆。
顯示參數
首次連線先使用中等解析度與標準色彩品質。確認操作穩定後再提高畫面精細度，避免一開始就耗盡頻寬。
鍵盤與輸入法
檢查修飾鍵對應、鍵盤配置與本機輸入法切換鍵。涉及快速鍵的任務，應先在無風險的文字區域驗證一次。
儲存設定、驗證主機，再進入桌面工作階段
將連線資訊儲存為易於辨識的項目，並在首次連線時仔細核對主機，可避免將憑證提交至錯誤目標。
-
01
建立連線項目
在相容的遠端桌面用戶端中建立新連線，填寫節點位址、連接埠與執行個體使用者名稱。名稱建議包含專案、節點與用途，例如「行動版建置｜東京｜開發桌面」，但不要將密碼寫入名稱。
完成標誌 連線資訊易於辨識且來源明確 -
02
驗證目標主機
首次建立工作階段時，核對用戶端顯示的主機資訊與控制台執行個體詳細資訊。若資訊不一致，立即取消連線並重新檢查位址，不要略過警告繼續嘗試。
完成標誌 目標與目前執行個體一致 -
03
進入桌面並校準輸入
連線後先開啟一般文字區域，驗證大小寫、修飾鍵、中文輸入與常用快速鍵，再檢查解析度與縮放。確認無誤後再開啟專案與開發工具。
完成標誌 按鍵、輸入法與縮放正常 -
04
恢復開發現場
重新連線時先確認上次的工作是否仍在執行，再恢復編輯器、建置記錄與專案目錄。不要重複啟動同一項建置，以免發生資源競爭或產出物遭覆寫。
完成標誌 只恢復需要繼續的工作
使用相容用戶端，但不要在公用裝置上保留憑證
從 Windows 或 Linux 連線時，核心順序仍是確認協定、驗證主機、校準按鍵並控管憑證儲存範圍。
個人受控裝置
可以儲存不含密碼的連線項目，並啟用系統層級磁碟加密與螢幕鎖定。憑證應優先交由本機安全儲存管理，不要寫入桌面文字檔或啟動指令碼。
- 確認用戶端來源與更新狀態
- 啟用本機螢幕鎖定與磁碟保護
- 離開裝置前主動中斷遠端工作階段
公司統一管理裝置
先確認安全政策是否允許遠端協定與檔案傳輸。遇到代理伺服器、出口限制或憑證檢查時，記錄錯誤資訊並交由網路管理員核對，不要反覆關閉安全控管。
- 核對代理伺服器與防火牆政策
- 區分本機限制與節點連線問題
- 保留去識別化後的時間與錯誤資訊
臨時或公用裝置
不要儲存使用者名稱、密碼、私密金鑰、連線記錄與剪貼簿內容。工作結束後退出用戶端、清理下載檔案並確認工作階段已中斷；無法確認環境可信時，不應處理敏感專案。
- 關閉自動登入與憑證記憶
- 不要啟用雙向剪貼簿與目錄共用
- 離開前清理本機快取與暫存檔案
命令列工作流程
SSH 優先使用金鑰，讓長時間工作可復原
圖形工作階段短暫中斷不應中斷正在執行的建置。SSH 適合將檢查、建置與記錄追蹤拆成明確步驟，並透過可復原工作階段管理長時間工作。
先驗證
確認位址、連接埠與主機指紋
再執行
先檢查目錄與磁碟，再啟動工作
可復原
將長時間工作放入 tmux 等持久工作階段
SSH RUNBOOK
金鑰優先
01 · 檢查連接埠連通性
nc -vz node-address 22如果連接埠無法連線，先檢查本機網路、代理伺服器、防火牆與控制台中的執行個體狀態。
02 · 首次連線並核對主機
ssh -i ~/.ssh/gpumini user@node-address首次出現主機驗證提示時，將顯示資訊與執行個體詳細資訊核對；不一致就停止連線。
03 · 建立可復原工作階段
tmux new -s build
xcodebuild -workspace Project.xcworkspace \
-scheme App build網路中斷後重新連線，再執行 tmux attach -t build 返回原工作。
04 · 查看空間與輸出
df -h
tail -n 120 build.log建置前檢查磁碟空間，失敗後優先儲存末尾記錄並移除憑證、權杖與專案機密路徑。
先測試網路，再逐項調整顯示負載
ping 只反映部分往返時間。抖動、封包遺失、可用頻寬、解析度與畫面變化頻率會共同影響遠端 Mac 桌面的操作流暢度。
| 觀察項目 | 使用者感受 | 優先檢查 | 建議動作 |
|---|---|---|---|
| ping 中位數 | 點擊、拖曳與輸入回饋整體變慢 | 節點距離與目前網路出口 | 比較不同節點的實際測試結果，優先選擇穩定且延遲較低的路線 |
| 抖動 | 操作時快時慢，捲動不連續 | Wi-Fi 訊號、網路壅塞與代理鏈路 | 切換至有線網路或穩定 Wi-Fi，減少同一網路中的大量流量工作 |
| 封包遺失 | 畫面停頓、輸入遺漏或工作階段重新連線 | 本機鏈路、防火牆與出口品質 | 停止無關傳輸，記錄連續測試結果，並分別排查本機與節點方向 |
| 解析度 | 高解析度下畫面更新遲緩 | 顯示器縮放與遠端畫面尺寸 | 先降低至工作所需的最低可用解析度，再逐級提高 |
| 色彩與動態效果 | 移動視窗、播放影片或動畫時卡頓 | 色彩品質、透明效果與動態內容 | 降低色彩品質、減少桌面動態效果，將持續記錄切換至 SSH 查看 |
編碼與設定修改
保留清晰文字與易於辨識的介面縮放，降低不必要的動態效果。記錄持續捲動時改用 SSH，避免圖形工作階段反覆重新整理大面積內容。
模擬器與介面驗證
需要觀察細節時可暫時提高解析度與色彩品質，完成檢查後恢復較低負載設定。不要讓高畫質成為所有工作階段的固定預設值。
建置、匯出與測試
啟動工作後將主要觀察入口切換至 SSH 記錄，遠端桌面僅用於必要的圖形確認。如此即使桌面重新連線，背景工作仍可繼續。
中斷畫面前，先處理工作階段中的資料與工作
關閉用戶端視窗不代表完成安全登出。應明確哪些工作繼續執行、哪些敏感內容需要清理，並確認本機與遠端都不再保留無用副本。
-
01
確認工作狀態
檢查建置、匯出、同步與測試是否仍在執行。需要繼續的工作轉入可復原工作階段，不需要的工作正常停止。
-
02
鎖定桌面工作階段
離開開發現場前鎖定遠端桌面，關閉包含敏感內容的視窗，並清除不再需要的剪貼簿內容。
-
03
移除暫存資料
刪除暫存下載、一次性記錄、測試憑證與本機對映目錄中的無用副本，同時保留專案所需的獨立備份。
-
04
確認連線結束
從用戶端主動中斷工作階段，檢查連線狀態已結束。使用臨時裝置時，再清理連線記錄與本機快取。
不要連續重試，先定位故障所在層級
記錄發生時間、節點位址、連線方式、用戶端提示與已執行步驟。排查時每次只變更一個變數，才能判斷哪一步真正解決問題。
用戶端提示無法連線或連線逾時
先在控制台確認執行個體狀態，再核對節點位址與連接埠。接著測試本機網路是否可達，檢查代理伺服器、防火牆與公司出口政策。若 SSH 與遠端桌面都無法連線，優先排查網路或執行個體狀態；若只有一種方式失敗，則檢查對應協定與用戶端設定。
位址可達，但憑證驗證失敗
確認使用者名稱屬於目前的執行個體，並重新複製最新憑證。檢查鍵盤配置、大小寫與輸入法狀態，避免多餘空格。連續失敗時不要繼續猜測，應停止嘗試並透過控制台工單提交節點、發生時間與錯誤提示。
連線成功後出現黑畫面或畫面未更新
先等待用戶端完成首幀載入，再嘗試降低解析度與色彩品質。若 SSH 可用，檢查系統資源與相關程序是否正常。狀態不明時不要重複啟動多個圖形工作階段，以免增加判斷難度。
快速鍵、修飾鍵或輸入法行為異常
在一般文字區域逐項測試 Command、Control、Option、Shift 與中英文切換。確認用戶端按鍵對應與本機鍵盤配置一致。公用裝置或遠端套用遠端的環境可能重複對應按鍵，應先取消額外的對應層。
剪貼簿不同步或檔案拖放失敗
確認用戶端已允許目前方向的剪貼簿或檔案共用，並檢查公司安全政策是否限制此功能。敏感內容不要依賴剪貼簿傳遞；大型檔案改用加密檔案傳輸，並透過檔案大小或檢查結果確認完整性。
畫面延遲高、捲動卡頓或頻繁重新連線
分別觀察 ping、抖動與封包遺失，暫停本機大量流量工作，再降低解析度、色彩品質與動態效果。如果互動仍不穩定，將建置與記錄查看移至 SSH，並比較不同網路出口下的結果。
準備好後，從一台獨享實體 Mac 開始
選擇設定、週期與節點後完成下單。首次連線前依本頁核對位址、憑證、網路與顯示參數，再分別建立遠端桌面與 SSH 入口。