本文只處理在 OpenWrt LuCI 的 OpenClash v0.47.156 加入一條 vmess:// 分享連結,執行核心為 Mihomo。這不是 Clash for Windows、Clash Verge Rev 或 FlClash 的匯入步驟;舊版 OpenClash 的欄位也可能不同。

vmess:// 通常代表單一 VMess 節點,內含伺服器、連接埠、UUID、傳輸與 TLS 參數;https:// 訂閱網址則是可被 OpenClash 下載並定期更新的遠端入口。把單節點連結直接當成普通訂閱下載,不會自動產生遠端設定檔。

現有內容實際含義本文對應入口
vmess://…單一節點分享連結啟用線上訂閱轉換,或在節點管理頁本機匯入
https://…遠端訂閱或設定網址通常直接加入「設定訂閱」
.yaml / .yml已建立的設定檔使用設定檔上傳或管理功能,非本文範圍

有兩條正確路徑:線上轉換較省步驟,但會把認證資訊交給轉換服務;本機匯入由 v0.47.156 的 LuCI 頁面程式解析並填入表單,不需要第三方轉換服務。私有節點優先使用本機方式。

完整 VMess 分享連結應當成密碼保存。不要貼到公開搜尋、論壇、線上 YAML 驗證器或故障截圖,也不要把真實連結留在文章與聊天中。本文只使用脫敏形式:

脫敏示例vmess://REDACTED
  1. 確認連結來自你有權使用且可信的服務端或供應商。
  2. 記錄目前啟用的設定檔、OpenClash 執行狀態與可用節點。
  3. 若使用線上轉換,先核對服務營運者與隱私邊界;無法確認時改用本機匯入。
  4. 若連結曾公開出現,先撤銷並重新產生認證資訊,再繼續操作。

單一節點也含敏感資料:VMess UUID 是認證資料,連結還可能暴露伺服器網域、連接埠、SNI、WebSocket Host 與路徑;只遮住節點名稱並不算脫敏。

方法一:在設定訂閱中啟用線上訂閱轉換

OpenClash v0.47.156 的訂閱編輯頁說明,只有啟用 Subscribe Convert Online 後,Subscribe Address 才支援 SS、SSR、VMess 等節點連結。轉換服務會收到你填入的內容,所以只應使用自己維護或已確認可信的後端。

  1. 進入「服務 → OpenClash → 設定訂閱」,新增條目或編輯專門用於測試的條目。
  2. 填寫容易辨識的別名,把一條完整 vmess:// 放入訂閱網址;首次測試不要與既有訂閱混在一起。
  3. 啟用線上訂閱轉換,在轉換服務網址中選擇已核驗的服務。畫面提供預設值不代表適合提交私有認證資訊。
  4. 儲存後回到列表,更新該條目,或使用頁面底部的 Update Config。後者會提交設定、啟用並啟動 OpenClash,期間可能短暫斷線。
  5. 等待更新完成,確認是否產生設定與 VMess 節點,再依後文驗證。

OpenClash 畫面本身警告隱私風險:線上訂閱轉換不是路由器內的離線轉換。無法確認轉換服務或營運者時,不要提交分享連結。

方法二:從節點管理頁本機匯入分享連結

不希望交給轉換服務時,可使用 OpenClash 的伺服器節點編輯器。v0.47.156 提供 SS/SSR/VMESS/TROJAN URL 與 Import 按鈕,並提示貼上分享連結。原始碼中的 parseVmess 在瀏覽器頁面解析內容並填入表單;匯入本身不需呼叫第三方轉換介面,但儲存後的認證資訊會寫入路由器設定。

  1. 開啟 Services → OpenClash → Config Manage,在目標 YAML 的操作欄選擇 Servers Manage,再按 Apply。
  2. 進入 Servers & Groups manage 後先按 Read Config,再到 Proxies 區域新增一項;這是頁面原始碼要求的編輯順序。
  3. 開啟新節點編輯頁,在 SS/SSR/VMESS/TROJAN URL 一列按 Import,貼上完整 vmess://。成功訊息只代表解析成功,不代表連線可用。
  4. 確認 Config File 仍是剛才選擇的目標設定;只有確實需要時才改為加入所有設定檔。
  5. 在 Proxy Group 欄位選擇目前設定中已存在的群組,不要輸入尚未建立的名稱。
  6. 逐項核對後按 Commit Settings。回到 Servers & Groups manage 按 Apply Settings,把節點寫回目標 YAML,再重新載入目前的執行設定。

本機匯入適合單一私有節點:它不會把原始連結交給訂閱轉換服務,單一節點也不會被當作可自動更新的訂閱。認證資訊變更後需手動修改或重新匯入。

儲存前核對 VMess 欄位,解析成功不等於參數正確

v0.47.156 匯入器會先解析常見 V2RayN Base64 JSON,也會嘗試 URI 形式的 VMessAEAD 連結。它可填入常見欄位,部分未知純量會放入其他參數,但物件型未知欄位不會自動補齊。最終仍要以節點提供方與 Mihomo VMess 文件為準。

必查欄位常見來源設定錯誤時
伺服器、連接埠、UUIDadd、port、id解析、連線或認證失敗
加密、Alter IDscy / encryption、aid握手失敗;不可自行猜值
TLS、SNI、指紋tls / security、sni、fpTLS 或憑證驗證失敗
傳輸方式net / typeTCP、WebSocket、HTTP/2、gRPC 選錯
路徑、Host、服務名稱path、host、serviceName連得到主機但協定不匹配
設定範圍與群組OpenClash 表單節點已存卻不在目前設定或群組

特別檢查憑證驗證的預設值:v0.47.156 新節點表單把 skip-cert-verify 預設為 true,而 VMess 匯入器不會在連結缺少 insecure 參數時主動改成 false。若可信原設定沒有要求略過驗證,匯入後應手動設為 false 再儲存;不要把表單預設值當作伺服器要求。

套用後用節點清單與連線記錄驗證

  1. 儲存節點或訂閱後,執行一次設定更新或套用,等待 OpenClash 恢復執行。
  2. 先看啟動記錄中的第一個設定解析、群組或 VMess 錯誤,不要反覆點更新。
  3. 確認新節點出現在指定設定與群組;沒有出現時先查設定範圍與群組,不要先改 TLS。
  4. 手動選擇新節點並發出真實請求,在連線記錄確認最終節點與錯誤類型。
  5. 切回原節點再測一次,區分新參數問題與路由器整體網路問題。

延遲測試成功只證明健康檢查網址當時可達,不代表每個目標服務都能使用。完成標準是 OpenClash 能啟動、節點位於正確設定與群組、真實請求經它建立,而且原節點仍可切回。

看得到節點卻無法連線:依序核對 UUID、連接埠、TLS、SNI 與傳輸欄位,不要同時改 DNS、Fake-IP、TUN、核心與代理模式。

常見失敗與還原:只撤銷本次新增內容

現象先查什麼處理方式
訂閱更新失敗是否未開啟線上轉換使用可信轉換服務,或改為本機匯入
本機匯入顯示格式無效連結是否完整且以 vmess:// 開頭從可信來源重新複製,不要公開解碼內容
解析成功但節點未出現設定檔與代理群組選擇目前設定和已存在群組後重新套用
節點出現但無法連線伺服器、UUID、TLS、SNI、傳輸逐項對照服務端,一次只改一項
更新後無法啟動啟動記錄第一個解析錯誤移除本次項目並恢復原設定

還原本機方案時,只刪除本次新增的伺服器節點,回到 Servers & Groups manage 再按 Apply Settings,把刪除結果寫回目標 YAML,然後重新載入目前的執行設定。線上方案要先切回原本啟用的設定,再停用或刪除本次訂閱條目;這不會自動刪除已產生的 YAML。若檔案確實由本次測試建立且不再需要,先確認它不是啟用設定並下載備份,再從 Config Manage 單獨移除。不要刪除原訂閱或批次清空節點。

若連結已交給不可信的轉換服務,刪除 OpenClash 條目無法撤回資料;應從服務端輪換 UUID 或重新產生分享認證資訊。相關平台入口可在本站下載頁面核對,但更換客戶端不能修復錯誤參數。

官方來源與版本邊界

版本號、檔案名稱與介面文字可能隨專案更新而變動,操作前請以連結中的專案文件為準。