工程支援手冊

讓雲端 Mac 從連線到穩定運作

依實際操作順序完成憑證核對、VNC 遠端桌面連線、環境遷移與建置診斷。每一步都提供檢查結果與下一步，不讓問題停留在模糊描述。

登入控制台提交工單 立即租用雲端 Mac
服務對象
獨享實體 Mac mini
一般交付
約 4 分鐘
支援方式
控制台工單或電子郵件
RUN / CONNECT-01

首次連線檢查單

可執行
已取得憑證 控制台執行個體詳細資料
01
網路可連通 目標位址與連接埠可連通
02
已進入桌面 VNC 工作階段顯示 macOS 圖形介面
03
驗收結果

確認機型、記憶體、儲存空間與所選節點一致後，再同步專案與建置快取。

依問題進入

六個說明主題，直接定位操作路徑

先選擇最接近目前階段的主題。連線失敗從憑證與網路開始，建置失敗從環境與記錄開始，訂購與節點狀態則在控制台核對即時結果。

遠端連線

首次進入 macOS 桌面

核對位址、連接埠、使用者名稱與臨時密碼，完成 VNC 工作階段與首次安全設定。

查看連線步驟 帳戶與訂購

查看訂單與節點詳細資料

在控制台核對機型、租期、節點、附加儲存空間、帳單與服務狀態。

開啟控制台 系統初始化

完成交付後的基本驗收

修改臨時憑證，檢查系統版本、磁碟空間、網路時間與管理員權限。

執行驗收清單 開發環境

重現 Xcode、CI 與 MLX 環境

依版本清單安裝工具鏈、隔離相依套件，並保留建置與推論執行記錄。

查看環境指南 網路與儲存空間

區分連線問題與容量問題

檢查本機出口、目標連接埠、磁碟剩餘空間、同步工作與大型檔案傳輸策略。

進入診斷樹 服務狀態

核對節點與執行個體執行結果

以控制台即時回傳結果為準，結合節點狀態、系統負載與服務記錄判斷影響範圍。

查看狀態定義
首次連線指南

先驗收連線，再遷移專案

建議在同步儲存庫、模型或媒體素材前完成四項檢查，將交付、網路與專案環境問題分開處理。

  1. 01

    從控制台取得目前憑證

    進入執行個體詳細資料，核對節點編號、機型、VNC 位址、連接埠、使用者名稱與臨時密碼。請勿使用舊工單或歷史截圖中的連線資訊，也不要將完整憑證轉寄給他人。

    節點編號與訂單一致 位址與連接埠來自目前執行個體 憑證不含多餘空格
  2. 02

    建立 VNC 遠端桌面連線

    在可信任的網路中開啟相容的 VNC 用戶端，依控制台提供的位址與連接埠連線。若交握失敗，先檢查本機網路、代理伺服器、防火牆與目標連接埠，請勿連續重試錯誤密碼。

    本機網路可正常存取外部服務 代理伺服器未改寫目標連接埠 用戶端儲存的是目前位址
  3. 03

    修改帳戶安全設定

    首次進入圖形介面後立即修改臨時登入密碼，並確認螢幕鎖定、自動登入與遠端存取設定符合團隊規範。團隊使用時，應為獲授權成員分別建立可追蹤的本機帳戶。

    臨時密碼已更換 螢幕鎖定政策已確認 已記錄獲授權成員範圍
  4. 04

    驗證系統與訂單設定

    檢查 macOS 版本、M4 晶片、記憶體、儲存容量、可用磁碟空間、系統時間與網路出口。SureVM M4 Core 應顯示 M4、16GB、256GB；SureVM M4 Plus 應顯示 M4、24GB、512GB。

    晶片與記憶體符合所選方案 磁碟容量與附加項目一致 時間與網路狀態正常
遷移路徑

從本機 Mac 到雲端 Mac 的三步遷移

遷移的目標不是複製整台舊機器，而是重建可驗證、可重複使用的工作環境。先同步必要資料，再重現工具鏈，最後接入自動化工作。

01 資料同步

只遷移專案所需內容

優先同步程式碼儲存庫、設定範本、必要素材與確認可重複使用的快取。大型檔案先壓縮或分批傳輸，避免一次同步塞滿磁碟。

  • 透過版本控制拉取程式碼與子模組
  • 單獨注入敏感變數，不要提交至儲存庫
  • 記錄素材、模型與建置產物的存放路徑
  • 同步後驗證關鍵檔案數量與雜湊值
交付結果 專案資料可讀，目錄界線清楚
02 工具鏈重現

依版本清單重建開發環境

先確認 Xcode、命令列工具、語言執行環境與套件管理員版本，再安裝專案相依套件。不要直接複製舊機器中來源不明、無法追蹤的全域目錄。

  • 固定 Xcode 與 Command Line Tools 版本
  • 記錄 Ruby、Node.js、Python 與 Java 版本
  • 從鎖定檔還原 CocoaPods、SwiftPM 與 npm 相依套件
  • 執行一次乾淨建置並儲存完整記錄
交付結果 同一個提交可在新節點穩定建置
03 CI 接入與驗證

將節點納入可追蹤佇列

為 Runner 設定獨立工作目錄與最低必要權限，建立快取清理策略，並用測試分支驗證拉取、建置、封存與記錄回傳。

  • 限制 Runner 可存取的儲存庫與執行帳戶
  • 分開設定快取目錄與建置產物目錄
  • 驗證失敗工作可回傳結束代碼與記錄
  • 記錄節點編號、工作編號與提交雜湊
交付結果 自動化工作可重現、可定位、可交接
Xcode 與 CI

建置失敗時，依證據鏈排查

不要先清空所有快取或重新安裝全部工具。先保留失敗記錄，再從憑證、簽署、Keychain、Runner 權限、快取與具體錯誤逐層縮小範圍。

簽署鏈

憑證、描述檔與 Keychain

  1. 確認憑證用途與有效狀態

    核對建置目標使用的憑證類型、團隊設定與有效期限，避免混用開發與發佈環境。

  2. 核對簽署設定來源

    檢查專案設定、建置參數與 CI 環境變數是否指向同一套簽署策略。

  3. 確認 Keychain 可供工作存取

    互動式登入可用不代表背景 Runner 可用，應以 Runner 執行帳戶驗證解鎖與讀取權限。

執行環境

Runner 權限、快取與記錄

  1. 確認 Runner 的實際執行帳戶

    核對工作目錄、Shell、PATH 與讀寫權限，不要只在遠端桌面的互動式終端機中驗證。

  2. 隔離相依套件快取與衍生資料

    為 CocoaPods、SwiftPM、npm 與 DerivedData 設定清楚的目錄，先針對問題快取進行清理。

  3. 保留第一份完整失敗記錄

    記錄工作編號、提交雜湊、Xcode 版本、結束代碼與第一個錯誤，避免只提交最後幾行摘要。

記錄定位順序

先找第一個失敗，再看連鎖錯誤

建置記錄末尾通常包含大量後續失敗。應從第一個非零結束代碼、第一個簽署錯誤或第一個相依套件解析錯誤開始，結合工作開始時間判斷真正原因。

01 工作內容

節點編號、工作編號、提交雜湊、分支。

02 環境內容

macOS、Xcode、執行環境與相依套件版本。

03 失敗內容

第一個錯誤、結束代碼、相關指令與時間。

MLX 與開發環境

讓實驗環境可重建，而不是只能在目前工作階段使用

分開管理 Python 環境、模型檔案、參數與輸出記錄，以控制磁碟用量，也能在升級相依套件後快速比較實驗差異。

環境執行單

建議的目錄與記錄界線

ENV
Python 環境隔離

每個專案使用獨立虛擬環境、固定 Python 版本，並將相依套件清單納入專案版本管理。

DEP
相依套件安裝

從鎖定檔安裝相依套件，記錄 MLX 與關鍵函式庫版本；升級前先複製環境清單與基準結果。

MODEL
模型檔案管理

分開存放模型、量化版本與暫存下載目錄，記錄來源、雜湊值與磁碟用量，避免重複副本。

RUN
保留執行記錄

每次實驗儲存提交雜湊、參數、相依套件版本、輸入摘要、耗時與輸出路徑，不記錄敏感原始資料。

開始前

確認磁碟預算

模型檔案、虛擬環境、快取與輸出會同時佔用空間。下載前先檢查可用容量，並為中間檔案預留餘裕。

  • 模型目錄只保留需要的版本
  • 明確設定快取清理週期
  • 封存結果後再刪除中間檔案
變更後

用最小範例驗證

相依套件或模型變更後，先執行固定輸入的小型範例，比較結束代碼、輸出結構與資源用量，再恢復完整工作。

  • 保留變更前後的環境清單
  • 記錄失敗指令與第一個錯誤
  • 確認輸出路徑可寫入且容量充足
連線診斷樹

從憑證到節點狀態，逐層排除

每一層只回答一個問題。前一層未通過時不要跳到後一層重新安裝軟體，這能減少無關變更，也能為工單保留清楚證據。

01
憑證

位址、連接埠、使用者名稱與密碼是否來自目前執行個體？

未通過時

重新開啟控制台執行個體詳細資料，手動複製目前連線資訊，檢查前後空格與舊用戶端記錄。

02
網路

本機網路能否抵達目標位址與連接埠？

未通過時

暫時停用會改寫流量的代理伺服器，檢查公司出口政策，並使用另一條可信任的網路交叉驗證。

03
遠端桌面服務

網路可連通，但 VNC 工作階段是否在交握階段失敗？

未通過時

記錄用戶端名稱、版本、錯誤原文與發生時間，避免反覆提交錯誤憑證造成額外干擾。

04
系統負載

已連線但畫面遲緩，是否有高負載工作佔用資源？

需要檢查

查看 CPU、記憶體、磁碟剩餘空間與正在執行的建置或推論工作，先暫停非必要佇列再重新測試。

05
節點狀態

控制台是否回傳目前執行個體的正常運作狀態？

狀態異常時

不要自行反覆重新啟動工作。記錄節點編號、控制台狀態、發生時間與前述檢查結果後提交工單。

服務狀態定義

即時結果以控制台回傳為準

所有節點均以全年 365 天正常運作為設計目標。若執行個體狀態、連線結果與本機檢查不一致，請將具體節點與時間範圍提交支援團隊核對。

先記錄
節點編號與發生時間
再比對
控制台狀態與本機現象
最後提交
已去識別化的記錄與重現步驟
提交支援請求

讓支援團隊能直接重現問題

完整工單應說明對象、時間、操作與結果。請先將記錄中的儲存庫位址、權杖、私鑰、個人資料與業務內容去識別化。

TICKET / REQUIRED

工單需包含五項資訊

去識別化後提交
NODE
節點編號與地區

填寫控制台顯示的節點編號，並註明新加坡、日本（東京）、韓國（首爾）、香港或美國西部。

MODEL
機型與設定

註明 SureVM M4 Core 或 SureVM M4 Plus，以及是否使用附加儲存空間或 Thunderbolt 5 並聯。

TIME
發生時間與時區

提供首次發生時間、最近一次重現時間與所在時區，避免只寫「剛剛」或「大約昨天」。

STEPS
最短重現步驟

從正常狀態開始，依序寫出執行動作、輸入條件、預期結果與實際結果。

LOG
已去識別化的記錄與錯誤原文

保留時間、結束代碼與錯誤內容，移除密碼、存取權杖、私鑰、完整付款憑證與業務敏感資料。

已下單使用者

透過控制台提交節點工單

控制台工單可關聯執行個體、訂單與節點狀態，適合處理連線、系統、帳單與持續性的技術問題。

登入並提交工單
無法登入或售前問題

寄送電子郵件給支援團隊

使用可接收回覆的電子郵件寄送問題摘要。對外支援信箱只有 support@surevm.com，請勿在郵件中傳送帳戶密碼或私鑰。

support@surevm.com
下一步

已有問題就提交證據，需要節點就直接設定

控制台用於執行個體管理與支援工單；訂購入口用於選擇兩種 M4 設定、租期與五個可用節點。

進入控制台 立即租用雲端 Mac