桌面工作
適合人工檢查與少量傳輸
- 上傳前壓縮包含大量小檔案的專案目錄，減少遠端檔案管理員逐項處理的等待時間。
- 解壓縮後檢查目錄權限，確認目前帳戶對工作目錄具有讀取與寫入權限。
- 影片、音訊與大型素材優先產生代理檔案，桌面工作階段只處理需要人工判斷的環節。
- 匯出完成後先核對檔案大小與雜湊值，再從節點刪除臨時副本。
遠端 Mac 連線指南
從取得存取資料，到穩定執行第一項建置工作
本頁依實際連線順序說明遠端桌面、SSH、程式碼儲存庫、自託管 Runner 與檔案傳輸。先核對節點與憑證，再處理用戶端參數；遇到問題時依現象逐層排查，避免將強制關機當成一般修復手段。
- 標準準備時間
- 約 4 分鐘
- 可用通道
- 遠端桌面與 SSH
- 節點類型
- 獨享實體機，非虛擬機
工作階段交接
遠端工作階段接入單
可核對
訂單與節點
先與控制台記錄逐字核對
-
01
讀取存取資料核對
確認存取位址、帳戶名稱、臨時憑證與節點代碼屬於同一筆訂單。
-
02
建立首次工作階段連線
先使用單一用戶端連線，排除多端同時連線與舊快取的干擾。
-
03
更新臨時憑證更新
首次進入後立即更新，並將新憑證存放在團隊核准的安全保管工具中。
-
04
啟用開發通道就緒
加入 SSH 公開金鑰，檢查 Xcode 命令列工具，再註冊自動化 Runner。
開始連線
先確認四項資料，再開啟用戶端
訂單通知郵件與控制台會提供同一組交付資訊。連線前應核對訂單編號、節點代碼、存取位址與帳戶名稱；如果兩處內容不一致，請勿反覆嘗試舊位址，直接在控制台提交支援工單。
首次連線清單
存取資料應能對應至同一台實體節點
- 存取位址
- 使用訂單資料中的完整主機位址，請勿從聊天記錄或舊專案文件複製歷史位址。
- 帳戶名稱
- 帳戶名稱需區分字元與符號。貼上後檢查前後是否含有空格，避免用戶端將空格計入欄位。
- 臨時憑證
- 僅供首次進入使用。完成連線後立即更新，請勿將臨時值寫入儲存庫、建置記錄或團隊共用文件。
- 節點代碼
- 節點代碼用於定位連線路徑及提交支援請求，不等同於帳戶名稱，也不要填入密碼欄位。
遠端桌面
VNC 與系統級遠端存取，先依工作選擇
需要完整圖形介面、Xcode 專案操作或創作軟體時，請使用遠端桌面；只執行指令碼、檢查建置狀態或傳輸少量檔案時，優先使用 SSH。減少不必要的圖形工作階段，可降低弱網路下的互動負擔。
| 連線方式 | 適用工作 | 連線前準備 | 用戶端參數 | 結束工作階段 |
|---|---|---|---|---|
| VNC 遠端桌面 | Xcode 圖形介面、模擬器檢視、Logic Pro、Final Cut Pro 與日常桌面操作 | 確認存取位址、連接埠、帳戶名稱與目前憑證；關閉同一帳戶的重複工作階段 | 先使用自適應畫質與系統解析度；弱網路下逐步降低色彩品質與影格率 | 儲存專案並結束應用程式，再從系統工作階段正常登出；請勿直接關閉正在寫入檔案的工作 |
| macOS 系統級遠端存取 | 團隊內統一用戶端、固定解析度工作台與長時間桌面工作 | 確認用戶端支援目標通訊協定，並允許所需網路連接埠通過本機防火牆 | 主機名稱填寫交付位址，帳戶名稱保持原樣；首次連線時核對主機提示資訊 | 先停止匯出、壓縮或同步工作，再執行登出；僅關閉用戶端視窗不代表結束背景程序 |
| SSH 命令列 | 儲存庫操作、建置指令碼、Runner 管理、記錄檢視與自動化工作 | 加入公開金鑰，確認私密金鑰僅儲存在受控終端機，並記錄節點主機指紋 | 明確指定使用者名稱、主機位址與連接埠；自動化指令碼應設定合理逾時與結束代碼檢查 | 結束互動式工作階段前，確認前景工作已完成；長時間工作交由受管理的程序或 Runner 執行 |
工作階段結束順序：儲存檔案、停止寫入工作、結束應用程式、登出桌面工作階段。若背景建置需要繼續執行，應由 Runner 或受管理程序接手，而不是依賴持續開啟的桌面視窗。
開發通道
分開互動式登入與自動化權限
個人遠端桌面帳戶、SSH 金鑰與 CI/CD Runner 不應共用同一組長期憑證。分別設定權限後，建置失敗更容易定位，成員變更時也能單獨撤銷相應存取權。
-
01
加入 SSH 公開金鑰
從受控工作裝置產生或選用現有金鑰，將公開金鑰寫入目標帳戶的授權清單。私密金鑰不得上傳至節點、透過郵件傳送或貼入工單。
ssh -i ~/.ssh/team_build user@assigned-host -
02
擷取儲存庫並確認權限範圍
優先使用僅涵蓋目前儲存庫的存取權杖或部署金鑰。首次擷取後檢查遠端位址，避免將含敏感參數的 URL 留在 shell 歷史記錄或建置輸出中。
git clone <repository-url> git remote -v -
03
檢查 Xcode 命令列工具
確認目前工具鏈路徑與版本符合專案要求。切換版本後重新執行檢查，並讓建置指令碼輸出實際使用的工具鏈，而不是只依賴團隊文件中的預期值。
xcode-select -p xcodebuild -version swift --version -
04
註冊自託管 Runner
為 Runner 使用清楚的標籤，例如晶片、節點與工作類型。限制單機並行數，為工作目錄設定清理策略，並在成員離開或專案結束後撤銷註冊權杖。
./config.sh --labels apple-silicon,macos,build ./run.sh
檔案與產物
桌面操作看得見，自動化工作要能回收
專案檔案、快取與建置產物應依用途放入不同目錄。將工作區與臨時快取混在一起，會讓磁碟空間問題難以判斷，也會增加清理時誤刪專案檔案的風險。
自動化工作
適合重複建置與大型產物回傳
- 為每次工作建立獨立工作目錄，工作結束後依結束狀態決定保留記錄或清理所有臨時檔案。
- 為快取目錄設定容量上限與清理週期，不要讓快取命中率建立在磁碟用量無限增長的基礎上。
- 大型產物採用可重試傳輸，並在回傳後驗證雜湊值；網路中斷時不要從頭重複完整建置。
- 記錄只保留定位問題所需的資訊，避免輸出權杖、密碼、完整環境變數與未經遮罩的業務資料。
清理前
確認工作目錄、快取目錄與產物目錄的界線
傳輸中
保留結束代碼、重試次數與雜湊值
傳輸後
先驗證遠端副本，再刪除節點臨時檔案
工作階段問題排除
先記錄現象，再變更一個變數
不要同時更換網路、用戶端、憑證與節點參數。每輪只變更一項，並記錄時間、錯誤文字與結果；這樣提交工單時，支援人員可以直接從已驗證的步驟繼續。
無法連線
先確認本機網路可以存取其他 HTTPS 服務，再核對主機位址與連接埠。關閉代理伺服器或企業網路策略進行一次對照測試，並確認用戶端沒有繼續使用舊工作階段快取。
畫面延遲或輸入延遲
降低解析度、色彩品質與影格率，暫停大型上傳，再比較有線網路與無線網路的結果。若 SSH 回應正常而桌面延遲明顯，優先檢查圖形編碼與用戶端設定。
憑證失效
確認帳戶名稱大小寫與貼上時的空格，檢查是否仍在使用首次交付的臨時值。不要連續高頻率嘗試；在控制台核對訂單狀態後提交工單，由支援人員確認帳戶狀態。
磁碟空間不足
分別檢查工作區、建置快取、模擬器資料、封存檔案與下載目錄。先移動需要保留的產物，再清理可重新建立的快取；請勿直接刪除來源不明的系統目錄。
建置程序中斷
保留結束代碼與失敗步驟，確認 Runner 服務、工具鏈路徑、剩餘磁碟空間與儲存庫權限。先使用相同提交重新執行一次最小工作，再判斷是環境問題還是專案指令碼問題。
重新啟動與執行界線
優先正常重新啟動，強制關機僅限無回應的節點
所有節點全年 365 天正常執行，不設定計畫停機時段。系統更新、專案相依性變更與使用者發起的重新啟動，應由團隊依工作狀態安排；如果節點完全無回應，再由支援人員進行節點檢查。
遠端正常重新啟動
停止 Runner 接收新工作，等待寫入完成，儲存桌面專案，然後從 macOS 執行正常重新啟動。重新連線後檢查時間、網路、磁碟與建置服務。
工作階段中斷但主機可連線
如果 SSH 仍可連線，請勿直接關機。先檢查遠端桌面程序、磁碟空間與系統負載，並記錄最近一次正常工作階段結束時間。
桌面與 SSH 均無法連線
提交訂單編號、節點代碼、發生時間與網路對照結果。支援人員會先檢查節點電源、網路與系統狀態，再決定是否需要進行恢復操作。
請勿連續觸發重新啟動或強制關機。
檔案系統正在寫入、建置產物正在封存或快取資料庫正在更新時，重複關機可能擴大問題。每次操作後都應等待狀態回傳，並記錄操作時間。
提交支援請求
讓工單從可重現的資訊開始
控制台工單適合處理訂單內的連線、節點與帳單問題；郵件適合尚未下單的設定諮詢。兩種管道都不要提交私密金鑰、完整存取憑證或未經遮罩的業務資料。
最小資訊集
- 訂單編號：用於定位對應的獨享實體節點。
- 節點代碼：依控制台顯示內容原樣填寫。
- 發生時間：註明時區與最近一次正常時間。
- 用戶端環境：作業系統、用戶端名稱、版本與網路類型。
- 重現步驟：從開啟用戶端到看見錯誤的最短步驟。
- 已遮罩記錄：保留錯誤代碼與上下文，移除密碼、權杖、私密金鑰與業務內容。
支援信箱
support@vmoak.com
獨享 Apple Silicon 實體節點
選擇適合建置、自動化或遠端創作的雲端 Mac
兩種配置、六個節點與所有週期價格均公開列明。提交訂單前，可先依工作所需記憶體、儲存空間增量與連線地區完成選擇。