依任務定位問題

從錯誤現象找到可執行的排查步驟

這裡涵蓋 VMMini 雲端 Mac 獨享實體節點的首次連線、SSH 金鑰、VNC、MLX 推論服務、持續整合與訂單問題。先依現象完成基本檢查,再攜帶日誌與時間範圍提交工單。

頁面不會要求密碼、私鑰或助記資訊。涉及既有訂單的問題,登入控制台提交工單即可自動關聯訂單與節點記錄。

支援執行單 先定位,再蒐集,再提交
路徑清晰
03 排查階段
現象 連線、建置、磁碟、服務或訂單
證據 時間、命令、結束碼與去識別化日誌
處置 自行恢復或關聯訂單提交工單
節點範圍 新加坡 · 日本(東京) · 韓國(首爾) · 香港
快速搜尋

輸入錯誤訊息、工具名稱或任務目標

搜尋會在本頁指南、故障分流與術語說明中比對。若錯誤訊息包含訂單號碼、主機名稱或位址,請先去識別化再輸入。

連線與存取

先核對交付資訊,再判斷連線方式

連線問題通常來自位址、連接埠、金鑰權限、用戶端快取或本地網路路徑。在確認主機指紋前,請勿略過驗證。

SSH:從主機指紋開始

需要準備交付的主機位址、SSH 連接埠、使用者名稱,以及對應公鑰的私鑰檔案。私鑰只應儲存在受控裝置或金鑰儲存區,請勿貼到工單中。

  1. 首次連線:逐段比對控制台顯示的主機指紋與用戶端提示。
  2. 權限檢查:確認私鑰檔案僅目前使用者可讀,且公鑰內容沒有因換行而損壞。
  3. 斷線排查:依序檢查本地網路、DNS 或位址、連接埠可達性,以及使用者名稱與金鑰的對應關係。
  4. 蒐集證據:保留含時間資訊的詳細模式輸出,但移除位址、使用者名稱與金鑰路徑中的敏感部分。
ssh -vvv -p <port> <user>@<host>

VNC:先確認工作階段與顯示狀態

需要節點位址、連接埠、連線憑證與可用的圖形工作階段。連線憑證應儲存在密碼管理工具中,不應寫入腳本儲存庫或建置日誌。

  1. 首次登入:檢查系統版本、磁碟容量、時區、鍵盤配置與目前網路狀態。
  2. 黑畫面處理:先確認圖形工作階段仍在執行,再檢查用戶端色彩深度與縮放設定。
  3. 頻繁斷線:記錄發生時間、持續時間、本地網路類型,以及是否能同時透過 SSH 存取。
  4. 畫面卡頓:降低顯示品質進行對照測試,不要直接將單次用戶端卡頓判定為節點故障。

遠端桌面:分開驗證用戶端與節點

先確認所用用戶端支援交付的連線方式,再核對位址、連接埠與工作階段憑證。請勿重複嘗試已失效的舊憑證,以免掩蓋真正的錯誤原因。

  1. 本地端:關閉代理伺服器或切換網路進行對照,記錄用戶端版本與錯誤原文。
  2. 節點端:若 SSH 可用,請檢查圖形服務程序、磁碟剩餘空間與系統負載。
  3. 網路鏈路端:比較不同網路下的連線結果,確認問題是否只出現在單一路徑。
  4. 提交工單:提供訂單識別碼、節點、發生時間與去識別化截圖,請勿提供連線密碼。
MLX 推論支援

透過五個檢查點定位模型服務問題

先確認執行環境與模型檔案完整,再檢查監聽位址、健康檢查端點與日誌。只開放業務實際需要的連接埠,並限制來源範圍。

01

確認環境

記錄 macOS 版本、Python 版本、虛擬環境路徑、MLX 相關套件版本與目前可用磁碟空間。確認任務執行於 VMMini M4、M4、16GB、256GB SSD 的獨享實體節點上,而非誤用共用環境參數。

02

準備模型

核對模型檔案路徑、檔案數量、校驗結果與所需空間。模型與快取應放在明確目錄,避免下載任務與服務程序同時寫入同一個暫存位置。

03

檢查監聽

先繫結本機位址完成驗證,再依實際存取需求調整監聽範圍。確認連接埠未被其他程序佔用,外部存取只開放必要的連接埠與來源。

04

執行健康檢查

從節點本機呼叫健康檢查端點,記錄 HTTP 狀態、回應時間與回傳本文。若本機正常但外部失敗,應轉向檢查連接埠、存取規則與網路路徑,而不是重複重新啟動模型。

05

蒐集可重現日誌

保留啟動命令的去識別化版本、標準輸出、標準錯誤、結束碼、模型名稱與發生時間。若日誌包含存取權杖、請求本文或使用者資料,提交前務必移除。

本機健康檢查

先從回送位址驗證服務

將實際連接埠與健康檢查路徑替換到命令中。健康檢查端點應輕量且穩定,不觸發完整推論任務。

curl --fail --show-error \
  --max-time 10 \
  http://127.0.0.1:<port>/health
持續整合支援

讓 runner 可撤銷、可清理、可重現

self-hosted runner 不只是一個常駐程序。註冊、憑證、快取、產物與撤銷操作都需要明確的負責人與保留界線。

01

註冊 runner

使用專用服務帳戶與獨立工作目錄,記錄 runner 名稱、標籤、所屬專案與註冊時間。標籤只描述實際能力,避免多個專案誤將任務排程到同一個工作目錄。

完成標準 佇列可識別 runner,測試任務能回傳明確的結束碼。
02

隔離專案憑證

依專案與環境拆分權杖,優先使用受控金鑰儲存區或執行階段環境變數。禁止將長期憑證寫入儲存庫、runner 設定備份或可下載產物。

完成標準 任務日誌不輸出機密值,撤銷單一專案不會影響其他專案。
03

管理建置快取

為依賴項快取、DerivedData、暫存檔案與封存檔設定不同目錄。磁碟空間不足時,先確認增加來源,再依專案清理,不要直接刪除仍由執行中任務使用的目錄。

完成標準 快取路徑可追蹤,清理操作不會刪除最終產物。
04

保留建置產物

為產物記錄提交版本、建置編號、工具鏈版本與校驗資訊。任務結束後,將需要保留的檔案移出 runner 工作目錄,避免清理快取時一併刪除。

完成標準 失敗日誌與成功產物都能對應到同一次建置。
05

安全撤銷 runner

先停止接收新任務,等待目前作業結束,再從專案端撤銷註冊權杖並移除服務。最後檢查工作目錄、快取與憑證是否依資料移出計畫處理。

完成標準 控制端不再排程任務,節點上不殘留可重複使用的註冊憑證。
術語小辭典

先統一八個詞的含義

排查時使用一致的術語,可以避免將節點問題、軟體問題、網路問題與計費問題混在一起。

實體節點
實際交付給訂單使用的 Mac Mini M4 主機。這是雲端 Mac 硬體節點,而不是虛擬機器執行個體。
獨享
訂單使用整台實體機的處理器、記憶體與本機儲存資源,不與其他租用訂單共用同一組計算資源。
VNC
用於存取 macOS 圖形介面的遠端顯示方式。排查時需要區分圖形工作階段、用戶端與網路鏈路。
self-hosted runner
由團隊註冊與維護的持續整合執行端,負責擷取任務、執行建置並回傳日誌與產物。
MLX
面向 Apple Silicon 的機器學習工具體系,可用於模型準備、推論實驗與服務化驗證。
建置快取
為減少重複下載與編譯而保留的資料,包括依賴項快取、DerivedData 與工具產生的中間檔案。
節點
實體主機所在的服務區域。目前目錄包含新加坡、日本(東京)、韓國(首爾)與香港四個節點。
計費週期
訂單選定的使用時段,支援按日、週、月或季建立。週期、開始時間與到期時間以控制台訂單記錄為準。
故障分流樹

依現象選擇下一步,不要同時變更多項設定

每次只變更一個條件並記錄結果。一次重設多個設定會失去故障邊界,也會讓支援團隊無法重現。

NET 無法連線節點 逾時、拒絕連線、指紋變更或憑證不相符
先檢查

訂單是否有效、位址與連接埠是否對應目前節點、本地網路是否能連到目標連接埠,以及使用者名稱與金鑰是否相符。

蒐集資訊

發生時間、用戶端版本、錯誤原文、去識別化的詳細連線輸出,以及切換網路後的對照結果。

提交工單時機

兩個獨立網路都無法連線,或主機指紋與控制台記錄不一致時,停止繼續嘗試並提交工單。

BLD 建置失敗 依賴項解析、編譯、簽署步驟或 runner 作業異常
先檢查

提交版本、鎖定檔、工具鏈版本、環境變數、runner 標籤與工作目錄是否與上一次成功建置一致。

蒐集資訊

完整結束碼、失敗階段前後的日誌、建置命令、工具版本,以及清理快取後的對照結果。

提交工單時機

相同提交版本與設定在乾淨工作目錄中仍持續失敗,且日誌指向節點系統或磁碟異常時提交工單。

DSK 磁碟空間不足 模型、建置快取、日誌或封存檔持續增加
先檢查

依目錄統計用量,區分模型、依賴項快取、DerivedData、日誌、暫存檔案與需要移出的最終產物。

蒐集資訊

檔案系統剩餘空間、佔用最大的目錄、開始增加的時間、正在執行的任務與最近一次清理記錄。

提交工單時機

檔案系統報告與目錄統計明顯不一致,或刪除可清理內容後空間仍未釋放時提交工單。

SRV 服務無回應 程序存在,但健康檢查端點逾時或外部無法存取
先檢查

程序狀態、監聽位址、連接埠佔用、本機健康檢查、可用記憶體與最近一段標準錯誤輸出。

蒐集資訊

啟動命令的去識別化版本、程序結束碼、本機與外部請求結果、回應時間及服務日誌時間範圍。

提交工單時機

本機請求也失敗且服務日誌顯示系統級異常,或多個服務同時無回應時提交工單。

ORD 控制台訂單異常 訂單狀態、週期、節點或帳單記錄與預期不符
先檢查

訂單識別碼、所選 VMMini M4 設定、節點、計費週期、附加項目與付款記錄是否屬於同一筆訂單。

蒐集資訊

訂單識別碼、頁面顯示狀態、發生時間、操作步驟與去識別化截圖。請勿提交完整付款憑證。

提交工單時機

重新整理並重新登入後記錄仍不一致,或訂單操作無法繼續時,從控制台提交關聯工單。

服務運作標準

節點全年運作,事件依訂單記錄核對

VMMini 節點依全年 365 天正常運作設計,全年持續運行。具體訂單可用性與事件記錄以控制台即時回傳及關聯記錄為準。

四個節點的運作範圍 目錄內節點均可用於 VMMini M4 下單,實際可用資訊由控制台即時回傳。
查看訂單事件

新加坡

東南亞團隊與工作負載可優先測試此路徑。

日本(東京)

適合與日本或東亞程式碼來源進行實測比較。

韓國(首爾)

適合測試東北亞存取路徑的連線。

香港

可用於華南與東南亞鏈路的實測對照。

如何判斷是否為服務事件: 先使用兩個獨立網路重新測試連線,再確認節點本機服務與使用者軟體狀態。外部網路路徑、使用者設定或單一程序失敗,不應直接等同於實體節點無法使用。
提交支援請求

一份可直接進入排查的工單應包含哪些內容

已有訂單請優先使用控制台工單,以便關聯節點、週期與事件記錄。無法登入時,可使用 support@vmmini.com 聯絡服務團隊。

請求資訊清單

六項必要資訊

不含帳戶金鑰
  1. 01
    訂單識別碼

    提供控制台中的訂單識別碼,不要用截圖中的其他個人資訊代替。

  2. 02
    相關節點

    寫明新加坡、日本(東京)、韓國(首爾)或香港,以及對應主機。

  3. 03
    發生時間

    提供時區、首次發生時間、最後一次重現時間,以及是否持續發生。

  4. 04
    重現步驟

    依操作順序列出命令、輸入條件、預期結果與實際結果。

  5. 05
    錯誤原文

    保留結束碼與關鍵上下文,不要只寫「無法使用」或「建置失敗」。

  6. 06
    去識別化日誌

    刪除密碼、私鑰、存取權杖、使用者資料與不必要的完整位址後再附上。

沒有訂單或無法登入

寄送電子郵件至 support@vmmini.com,主旨中寫明問題類型。郵件仍需包含節點、時間、重現步驟與去識別化日誌。

查看聯絡方式

請勿提交以下內容

密碼、私鑰、存取權杖、助記資訊、完整付款憑證、未去識別化的使用者資料,以及與問題無關的程式碼儲存庫內容。

閱讀資料隱私政策
將證據附於工單

已有訂單,直接關聯節點記錄繼續排查

準備訂單識別碼、節點、發生時間、重現步驟與去識別化日誌。控制台工單用於技術與訂單問題,售前諮詢也可透過唯一支援信箱聯絡。