REMOTE RUN SHEET
準備就緒
連線前檢查清單
- 資源類型
- 獨享 Apple Silicon 實體節點
- 存取路徑
- 圖形介面 / 命令列 / 自動化工作
- 節點區域
- 新加坡、日本（東京）、韓國（首爾）、香港、美國東部
- 開始前
- 核對位址、憑證、本機網路與專案存取方式
- 結束後
- 儲存記錄、確認工作狀態並安全結束工作階段
連線操作手冊
安全連線雲端 Mac，建立可重複的遠端開發流程
ArmVMS 提供獨享 Apple Silicon 實體節點。你可以依工作需求選擇圖形化遠端作業、命令列操作或自動化建置，並以同一套檢查順序管理連線資訊、專案檔案與執行記錄。
3 種存取方式
5 個可選節點
1 台獨享實體節點
選擇存取方式
先依工作決定入口，不必把所有工作都塞進遠端桌面
圖形介面適合需要持續視覺回饋的工作，命令列適合可腳本化的開發工作，自動化建置則適合重複執行與交付產出物。三種方式可以並用，但憑證、目錄與記錄應分開管理。
圖形化遠端工作
適合 Xcode 專案檢查、模擬執行、介面除錯、檔案整理與需要桌面回饋的開發工作。開始前確認顯示解析度與鍵盤配置，結束時關閉應用程式並結束遠端工作階段。
- 需要持續查看圖形介面
- 需要操作 Xcode 或桌面工具
- 需要人工確認建置與匯出結果
命令列操作
適合安裝相依套件、同步儲存庫、執行測試、檢查記錄與背景工作。建議為每個專案固定工作目錄，長時間工作寫入記錄檔，並在離開前確認程序是否仍需保留。
- 命令可重複執行且輸出可記錄
- 不需要持續傳輸桌面畫面
- 適合批次處理與遠端疑難排解
自動化建置
適合重複測試、封存建置與匯出產出物。執行身分應採用最小權限，敏感值由受控環境變數或憑證機制提供，工作結束後清理暫存檔案與不再使用的工作階段。
- 執行步驟固定且可驗證
- 產出物路徑與記錄位置明確
- 工作完成後可執行清理流程
首次連線準備
連線前，先將四組資訊放在同一張檢查清單上
多數首次連線問題並非來自機器本身，而是節點、連線位址、憑證版本或本機網路條件未經核對。依照以下順序檢查，可以避免反覆切換用戶端與重複嘗試。
連線前四項檢查
-
01
確認節點與訂單
在控制台核對訂單編號、節點區域、晶片、記憶體、儲存空間與租用期限。不要依據舊截圖判斷目前的連線對象。
-
02
確認連線位址與帳戶
逐字核對連線位址、連接埠、帳戶名稱與憑證更新時間。若憑證已更新，應停止使用本機儲存的舊版本。
-
03
檢查本機網路路徑
確認目前網路允許連線至目標，暫停可能改寫路由或 Proxy 規則的工具，並避免在不可信的公共網路中輸入憑證。
-
04
準備專案存取方式
提前確定程式碼儲存庫、相依套件來源、模型檔案與建置產出物的傳輸路徑，只攜帶目前工作所需的資料。
憑證只應輸入可信任的用戶端
不要將密碼、私密金鑰或權杖貼到聊天記錄、公開文件與來源未確認的腳本中。分享疑難排解資訊時，只提供已遮蔽敏感資訊的錯誤內容。
先記錄問題發生時間
連線失敗時，先記錄本機時間、目標節點、用戶端系統與完整錯誤訊息，再進行下一次嘗試。一次變更多項設定會增加定位難度。
圖形化遠端流程
從建立工作階段到安全結束，四步完成一次桌面工作
圖形工作階段的目標不只是「連上就算完成」，而是確認連線對象正確、桌面環境可用、顯示設定符合目前工作，並在離開時留下明確的執行狀態。
-
01
建立工作階段
從控制台取得目前的連線資訊，在可信任的用戶端中填寫位址與帳戶。首次出現主機識別資訊時，應與目前節點資料核對。
-
02
確認桌面環境
進入後核對節點配置、系統時間、專案目錄與可用磁碟空間，避免在錯誤目錄或錯誤訂單對應的機器上開始工作。
-
03
調整顯示設定
依據本機螢幕與網路條件選擇合適解析度，關閉不必要的視覺效果，並先用小型檔案驗證剪貼簿與檔案傳輸方向。
-
04
結束工作階段
儲存專案、確認建置工作狀態、關閉不再使用的工具並結束遠端工作階段。不要以強制中斷連線取代應用程式層級的儲存操作。
命令列工作流程
讓目錄、工作與記錄都有固定位置
命令列連線適合重複性工作，但也更容易因路徑、環境變數與背景程序不透明而留下問題。建議將一次遠端工作拆分為身分確認、進入目錄、執行工作、儲存記錄與安全離開五個階段。
CLI EXECUTION LEDGER
最小權限
命令列執行記錄
金鑰管理
區分自動化與人工操作的憑證用途，限制檔案權限，定期移除不再使用的金鑰。不要將私密金鑰提交至程式碼儲存庫。
專案目錄
為儲存庫、相依套件快取、暫存檔案與建置產出物設定清楚的目錄。執行清理命令前，先確認目前路徑與目標範圍。
背景工作
長時間工作使用可恢復的工作階段方式執行，並記錄程序識別碼、啟動參數與預計輸出位置，避免斷線後重複啟動。
記錄輸出
將標準輸出與錯誤輸出寫入明確檔案，保留工作開始時間、結束狀態與關鍵版本資訊，以便重現失敗。
安全離開
確認檔案寫入完成、暫存憑證已移除、背景工作狀態已記錄，再關閉連線。不要讓互動式命令停留在等待輸入的狀態。
開發體驗最佳化
把互動延遲留給真正需要畫面的操作
遠端開發體驗取決於畫面傳輸、檔案流向與工作安排。以下五項不依賴未經驗證的效能數據，重點在於減少重複傳輸、無效重新整理與目錄競爭。
解析度
優先選擇能完整顯示開發工具的最低適當解析度。網路條件變化時，先降低畫面負擔，再判斷是否存在連線問題。
剪貼簿
只傳遞必要文字與小型內容。貼上命令前，先在本機文字編輯器中檢查，避免帶入不可見字元或敏感值。
相依套件快取
快取應與工具鏈及專案版本相符。升級相依套件後記錄變更，發生異常時優先清理目標快取，不要不加區分地刪除所有目錄。
建置目錄
將原始程式碼、衍生資料、封存檔與匯出產出物分開存放，避免平行工作寫入同一路徑而造成覆寫或鎖定。
大型檔案傳輸
模型、音訊素材與大型產出物優先採用可驗證、可續傳的方式移動。傳輸完成後核對檔案大小或檢查結果。
安全基線
連線權限應隨工作收緊，而不是長期累積
獨享實體機代表資源不與其他租戶共用，但專案憑證、程式碼權限、腳本內容與應用程式層級設定仍由使用者管理。每次新增訂單或人員變更，都應重新檢查存取邊界。
首次登入後更新憑證
確認目前連線可用後更換初始憑證，並將新憑證存入受控工具。不要繼續依賴交付訊息中的原始副本。
執行最小權限
日常開發、自動化工作與管理操作使用不同的權限邊界。只有在目前步驟需要時才提升權限，完成後立即退出。
移除過期金鑰
成員離開專案、裝置更換或工作結束後，刪除不再需要的公開金鑰、工作階段與存取權杖，並記錄變更範圍。
腳本不儲存明文權杖
透過受控環境變數或憑證流程提供權杖，記錄中不得回顯完整值，提交程式碼前檢查設定檔與歷程記錄。
常見問題疑難排解
一次只檢查一個變數，並保留原始錯誤資訊
建議嚴格依照位址、網路、憑證、系統狀態與用戶端設定的順序處理。若跳過前置項目直接反覆更換用戶端，通常只會增加無法比較的嘗試記錄。
| 順序 | 檢查對象 | 需要核對 | 需要記錄 |
|---|---|---|---|
| 01 | 連線位址 | 目標節點、位址、連接埠與帳戶是否來自目前訂單 | 輸入值的遮蔽版本與錯誤發生時間 |
| 02 | 本機網路 | 目前網路、Proxy、路由與安全性原則是否允許目標連線 | 所用網路類型及切換網路後的結果 |
| 03 | 連線憑證 | 帳戶名稱、金鑰權限與憑證版本是否正確 | 憑證更新時間，不記錄憑證內容 |
| 04 | 系統狀態 | 控制台中的執行個體狀態與連線欄位是否正常回傳 | 訂單編號、節點與狀態欄位 |
| 05 | 用戶端設定 | 通訊協定、顯示、鍵盤與憑證確認設定是否相符 | 用戶端系統、軟體版本與完整錯誤訊息 |
位址與帳戶都正確，為什麼仍無法建立連線？
先確認連線資訊來自目前訂單，再檢查本機網路、Proxy 或路由規則。記錄錯誤發生時間與完整訊息，不要同時更換網路、憑證與用戶端設定；逐項修改才能判斷是哪個步驟產生變化。
圖形工作階段中斷後，正在執行的工作會怎樣？
圖形工作階段中斷與工作程序是兩種狀態。是否繼續執行取決於工作啟動方式。長時間工作應使用可恢復的工作階段方式，並將輸出寫入記錄；重新連線後先檢查程序與記錄，避免重複啟動同一項工作。
遠端桌面畫面反應變慢時，應先檢查什麼？
先降低解析度與不必要的畫面重新整理，再暫停大型檔案傳輸，檢查本機網路是否發生變化。可由命令列完成的安裝、同步與建置工作應移出圖形工作階段，減少持續的畫面傳輸。
取得協助
提交一份可定位問題的請求，比反覆描述「連不上」更有效
無法依上述順序解決時，請在同一次請求中提供訂單、節點、用戶端與錯誤背景。已有訂單時，請優先登入控制台提交關聯工單；售前諮詢或無法登入時可傳送電子郵件。
工單應包含六類資訊
- 訂單編號用於確認對應的配置與租用期限
- 節點區域新加坡、日本（東京）、韓國（首爾）、香港或美國東部
- 用戶端系統本機系統版本與所使用的連線軟體版本
- 發生時間記錄時區，並說明問題是否可重現
- 錯誤訊息保留完整原文，不要只截取最後一行
- 已遮蔽敏感資訊的記錄移除密碼、私密金鑰、權杖與業務資料
已有訂單
登入控制台查看目前狀態並提交關聯工單，避免訂單資訊與問題描述分散在不同工作階段中。
電子郵件聯絡
無法登入或需要售前確認時，請傳送電子郵件至 support@armvms.com，並使用同一個郵件串補充後續資料。
準備好連線至你的獨享雲端 Mac
從 $20.7/天起選擇 ArmVMS M4，或先查看兩種配置與五個節點的適用範圍。實際可用狀態以控制台即時回傳結果為準。