連線
找不到連線資訊、主機身分提示變更、工作階段建立失敗，或初始憑證需要更新。
查看連線順序
工程支援手冊
先定位問題，再依序恢復雲端 Mac
適用於正在連線、設定或管理 RunAMac M4 的開發團隊。這裡提供可執行的檢查順序、完成標誌與工單資訊範本，無需在零散答案之間來回查找。
- 涵蓋範圍
- 6 類常見問題
- 部署參考
- 約 4 分鐘
- 支援對象
- 獨享實體主機
RUNAMAC SUPPORT RUN SHEET
問題定位執行單
先蒐集，再變更
INPUT
保留原始錯誤輸出
先記錄發生時間、節點、指令與完整錯誤訊息，不要只保留最後一行。
CHECK
從本機連線逐層排查至主機
分別驗證網路、連接埠、工作階段與環境相依性，每次只變更一個條件。
PROOF
用可重複的步驟確認結果
記錄成功標誌或失敗日誌，讓下一位處理人員能重現相同結論。
快速搜尋
依問題所在層級找到檢查入口
輸入現象、指令或管理動作，或直接選擇一個類別。搜尋只會標示最相關的內容，不會隱藏其他處理步驟。
首次連線
完成四次核對後再開始開發工作階段
連線資訊以控制台的交付記錄為準。不要從聊天記錄或舊文件複製位址，也不要跳過主機身分驗證。
讀取本次訂單的連線資訊
登入控制台，進入對應訂單與執行個體詳細資料，核對節點、主機位址、連接埠、使用者名稱與連線方式。有多筆訂單時，先確認訂單編號與節點相符。
完成標誌：位址、連接埠與使用者名稱均來自同一筆交付記錄。驗證主機身分
首次建立加密連線時，客戶端會顯示主機指紋。請與控制台記錄核對；若曾連線卻突然出現身分變更提示，請先停止連線並提交工單確認。
完成標誌：主機指紋與目前執行個體記錄一致。建立命令列或圖形工作階段
先使用交付資訊建立工作階段，再確認鍵盤輸入、剪貼簿策略與基本網路存取符合工作需求。在高延遲網路下，先降低畫面品質，再判斷是否為主機故障。
完成標誌：能穩定進入 macOS 圖形介面或命令列。修改初始憑證並儲存復原資訊
連線成功後立即修改初始憑證，並使用團隊核准的憑證管理方式儲存。不要將密碼、私密金鑰或憑證內容寫入建置日誌、工單正文或程式碼儲存庫。
完成標誌：新憑證驗證成功，後續工作階段不再使用舊憑證。
身分提示變更時不要直接覆寫本機記錄
先儲存提示截圖、發生時間與訂單編號，再透過控制台工單確認。貿然接受新的主機身分，會失去一次重要的安全驗證機會。
部署時間軸
從訂單確認到收到連線資訊，約 4 分鐘
每個步驟都對應一個可觀察的完成標誌。實際進度以控制台回傳結果為準，重新整理頁面不會改變已提交的訂單。
-
01 約 1 分鐘
訂單確認
系統核對 RunAMac M4、租用週期、節點與附加選項，並建立本次訂單記錄。
完成標誌：控制台顯示訂單編號與已確認的設定。 -
02 約 1 分鐘
分配實體節點
訂單會對應至所選區域中的獨享實體主機，設備資源不與其他租用者共用。
完成標誌：執行個體詳細資料中出現節點與設備識別資訊。 -
03 約 1 分鐘
系統初始化
系統準備基本存取環境並執行必要的執行個體檢查。此時不要重複建立相同訂單。
完成標誌：執行個體狀態進入可交付階段。 -
04 約 1 分鐘
交付連線資訊
控制台寫入主機位址、連接埠、使用者名稱、主機身分資訊與相應的連線說明。
完成標誌：可在執行個體詳細資料中讀取完整連線欄位。
開發環境清單
先建立可重現的環境基準，再接入建置工作
RunAMac 提供獨享 Mac mini 與完整的 macOS 使用環境。具體軟體、版本與專案相依性應由團隊依建置基準確認，訂單未列明的軟體不視為已預先安裝。
Xcode 與使用中的開發目錄
記錄專案要求的 Xcode 版本，確認使用中的開發目錄與建置腳本一致。切換版本後，重新驗證 SDK、模擬器執行環境與封存指令。
命令列工具
檢查編譯器、Git、Shell 與套件管理指令是否可用。不要只因圖形介面能啟動 Xcode，就認定自動化建置已準備完成。
憑證與簽署材料
確認簽署憑證、描述檔與鑰匙圈存取策略符合專案要求。敏感材料應透過受控流程匯入，不得進入儲存庫、一般日誌或工單附件。
相依性與快取
分別記錄相依性鎖定檔、快取目錄與失效策略。首次建置先執行無快取基準，再啟用快取比較耗時與命中結果。
持續整合執行器
核對執行器標籤、工作目錄、並行數量、啟動方式與日誌回收路徑。某個執行器失敗時，先確認工作是否被錯誤分配到其他環境。
網路排查手冊
沿著連線路徑逐層縮小故障範圍
不要同時更換網路、客戶端與連線參數。一次只變更一個條件，才能判斷恢復是由哪個步驟造成。
檢查本機連線
確認本機網路能穩定存取其他服務，分別測試有線、無線或備用連線。記錄是否存在持續封包遺失、代理伺服器介入或企業網路限制。
證據：本機出口、測試時間、連續失敗次數。確認目標節點
從控制台重新讀取目前執行個體位址，避免繼續使用舊訂單或舊節點資訊。RunAMac M4 可選擇新加坡、日本（東京）、韓國（首爾）、香港、美國西部。
證據：訂單編號、節點名稱、目標位址。驗證連接埠策略
確認連線連接埠與交付記錄一致，並檢查本機防火牆、公司出口策略與安全軟體是否攔截。不要為了測試而永久關閉防護。
證據：連接埠、客戶端錯誤碼、策略變更結果。核對工作階段狀態
判斷問題發生在建立連線前、身分驗證階段，還是進入桌面後。若只有畫面卡頓，請分別記錄輸入延遲與連線中斷情況。
證據：失敗階段、持續時間、是否可重現。收集診斷日誌
保留客戶端日誌與完整錯誤輸出，記錄時區明確的時間戳記。若日誌包含主機位址、使用者名稱或路徑，提交前應進行必要的去識別化處理。
證據：日誌片段、時間戳記、重現步驟。
工單資訊範本
讓支援團隊直接開始排查
依欄位提供背景資訊，比只寫「連不上」更容易重現問題。請勿將密碼、私密金鑰、憑證正文與付款憑證寫入工單。
訂單編號：
節點：
問題發生時間與時區：
連線方式與客戶端版本：
完整錯誤輸出：
已執行的檢查：
最短重現步驟：
預期結果與實際結果：
儲存空間與並聯
依資料量與設備協作方式選擇附加項目
先區分容量不足、讀寫路徑不合理與多設備協作需求。附加項目依所選租用週期計費，變更前應先核對資料遷移與工作中斷風險。
容量擴充
+1TB SSD
適合需要長期保留相依性快取、多個中型程式碼儲存庫、建置封存檔與測試產物的工作流程。啟用前先統計尖峰使用量與清理策略。
- 每天
- $2.3
- 每週
- $6.2
- 每月
- $11.4
- 每季
- $31
大容量擴充
+2TB SSD
適合大量建置產物、多專案快取、小型 AI 實驗資料與較長的保留週期。增加容量不能取代備份，重要成果仍需保留獨立副本。
- 每天
- $4.6
- 每週
- $12.4
- 每月
- $22.8
- 每季
- $62
設備並聯
Thunderbolt 5 並聯
按每台設備計費，適合明確需要設備間高速連線的協作工作。提交變更前，請寫清楚設備數量、連線關係、資料方向與驗收指令。
- 每天
- $1.9
- 每週
- $5
- 每月
- $9.3
- 每季
- $25.3
變更前完成三項確認
確認已用容量、執行中的工作與需要保留的資料路徑。
核對附加項目與目前租用週期，以及控制台回傳的 USD 應付金額。
完成後重新檢查掛載、可用容量、讀寫權限與工作路徑。
帳戶與租期
使用訂單記錄管理租期、設定與帳單
控制台是查看交付、租期與應付金額的統一入口。管理多個執行個體時，任何變更都要先核對訂單編號與節點。
ORDER MANAGEMENT
控制台核對清單
ORDER
查看訂單與執行個體
在訂單詳細資料中核對 RunAMac M4、Mac Mini M4、16GB RAM、256GB SSD、節點、租期與交付記錄。
TERM
確認續租
續租前檢查目前週期結束時間、下一個週期與 USD 應付金額，再依照控制台回傳的步驟完成確認。
ADD-ON
調整附加選項
變更 +1TB SSD、+2TB SSD 或 Thunderbolt 5 並聯前，先儲存工作狀態並確認對應的計費週期。
INVOICE
下載帳單
從帳單記錄核對基本主機、附加項目、週期與總額。金額統一以 USD 結算。
僅核對兩類付款閘道
支援 USDT-TRC20，以及由 Stripe 處理的 Visa、Mastercard、Amex。實際可用的付款閘道以控制台回傳為準。
已有訂單請優先進入控制台
交付資訊、租期、帳單與工單狀態都與登入帳戶關聯。
管理現有訂單
升級至人工支援
提交一份可直接重現問題的背景資訊
技術問題請優先透過控制台工單關聯訂單；售前、合作或無法登入帳戶時，可透過聯絡頁整理電子郵件內容。
訂單與節點
提供訂單編號、RunAMac M4 設定與節點。若問題涉及多個執行個體，請分別標示每台設備。
時間戳記
寫明問題發生時間與時區，並指出是持續發生、間歇發生，還是只出現過一次。
錯誤輸出
貼上完整錯誤文字或提供已去識別化的截圖。不要提交密碼、私密金鑰、憑證正文與其他私密憑證。
重現步驟
從已知的初始狀態開始，逐條寫出指令、輸入、預期結果與實際結果。
提交工單後如何繼續補充資訊？
在同一張控制台工單中追加新的時間戳記、日誌與驗證結果，避免為同一問題重複建立多張工單。這樣可以保留完整的排查脈絡。
哪些內容不應放入工單或電子郵件？
不要提交密碼、私密金鑰、憑證正文、付款憑證或未去識別化的專案機密。需要說明路徑或使用者名稱時，只保留定位問題所需的最少資訊。
無法登入控制台時如何聯絡團隊？
前往聯絡頁產生結構化電子郵件，或直接寄送電子郵件至 support@runamac.com。請寫明帳戶電子郵件、相關訂單編號，以及無法登入時看到的錯誤資訊。