先分辨連結類型:vmess://不是一般訂閱網址
本文只處理在 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
- 確認連結來自你有權使用且可信的服務端或供應商。
- 記錄目前啟用的設定檔、OpenClash 執行狀態與可用節點。
- 若使用線上轉換,先核對服務營運者與隱私邊界;無法確認時改用本機匯入。
- 若連結曾公開出現,先撤銷並重新產生認證資訊,再繼續操作。
單一節點也含敏感資料:VMess UUID 是認證資料,連結還可能暴露伺服器網域、連接埠、SNI、WebSocket Host 與路徑;只遮住節點名稱並不算脫敏。
方法一:在設定訂閱中啟用線上訂閱轉換
OpenClash v0.47.156 的訂閱編輯頁說明,只有啟用 Subscribe Convert Online 後,Subscribe Address 才支援 SS、SSR、VMess 等節點連結。轉換服務會收到你填入的內容,所以只應使用自己維護或已確認可信的後端。
- 進入「服務 → OpenClash → 設定訂閱」,新增條目或編輯專門用於測試的條目。
- 填寫容易辨識的別名,把一條完整
vmess://放入訂閱網址;首次測試不要與既有訂閱混在一起。 - 啟用線上訂閱轉換,在轉換服務網址中選擇已核驗的服務。畫面提供預設值不代表適合提交私有認證資訊。
- 儲存後回到列表,更新該條目,或使用頁面底部的
Update Config。後者會提交設定、啟用並啟動 OpenClash,期間可能短暫斷線。 - 等待更新完成,確認是否產生設定與 VMess 節點,再依後文驗證。
OpenClash 畫面本身警告隱私風險:線上訂閱轉換不是路由器內的離線轉換。無法確認轉換服務或營運者時,不要提交分享連結。
方法二:從節點管理頁本機匯入分享連結
不希望交給轉換服務時,可使用 OpenClash 的伺服器節點編輯器。v0.47.156 提供 SS/SSR/VMESS/TROJAN URL 與 Import 按鈕,並提示貼上分享連結。原始碼中的 parseVmess 在瀏覽器頁面解析內容並填入表單;匯入本身不需呼叫第三方轉換介面,但儲存後的認證資訊會寫入路由器設定。
- 開啟 Services → OpenClash → Config Manage,在目標 YAML 的操作欄選擇 Servers Manage,再按 Apply。
- 進入 Servers & Groups manage 後先按 Read Config,再到 Proxies 區域新增一項;這是頁面原始碼要求的編輯順序。
- 開啟新節點編輯頁,在
SS/SSR/VMESS/TROJAN URL一列按 Import,貼上完整vmess://。成功訊息只代表解析成功,不代表連線可用。 - 確認 Config File 仍是剛才選擇的目標設定;只有確實需要時才改為加入所有設定檔。
- 在 Proxy Group 欄位選擇目前設定中已存在的群組,不要輸入尚未建立的名稱。
- 逐項核對後按 Commit Settings。回到 Servers & Groups manage 按 Apply Settings,把節點寫回目標 YAML,再重新載入目前的執行設定。
本機匯入適合單一私有節點:它不會把原始連結交給訂閱轉換服務,單一節點也不會被當作可自動更新的訂閱。認證資訊變更後需手動修改或重新匯入。
儲存前核對 VMess 欄位,解析成功不等於參數正確
v0.47.156 匯入器會先解析常見 V2RayN Base64 JSON,也會嘗試 URI 形式的 VMessAEAD 連結。它可填入常見欄位,部分未知純量會放入其他參數,但物件型未知欄位不會自動補齊。最終仍要以節點提供方與 Mihomo VMess 文件為準。
| 必查欄位 | 常見來源 | 設定錯誤時 |
|---|---|---|
| 伺服器、連接埠、UUID | add、port、id | 解析、連線或認證失敗 |
| 加密、Alter ID | scy / encryption、aid | 握手失敗;不可自行猜值 |
| TLS、SNI、指紋 | tls / security、sni、fp | TLS 或憑證驗證失敗 |
| 傳輸方式 | net / type | TCP、WebSocket、HTTP/2、gRPC 選錯 |
| 路徑、Host、服務名稱 | path、host、serviceName | 連得到主機但協定不匹配 |
| 設定範圍與群組 | OpenClash 表單 | 節點已存卻不在目前設定或群組 |
特別檢查憑證驗證的預設值:v0.47.156 新節點表單把 skip-cert-verify 預設為 true,而 VMess 匯入器不會在連結缺少 insecure 參數時主動改成 false。若可信原設定沒有要求略過驗證,匯入後應手動設為 false 再儲存;不要把表單預設值當作伺服器要求。
套用後用節點清單與連線記錄驗證
- 儲存節點或訂閱後,執行一次設定更新或套用,等待 OpenClash 恢復執行。
- 先看啟動記錄中的第一個設定解析、群組或 VMess 錯誤,不要反覆點更新。
- 確認新節點出現在指定設定與群組;沒有出現時先查設定範圍與群組,不要先改 TLS。
- 手動選擇新節點並發出真實請求,在連線記錄確認最終節點與錯誤類型。
- 切回原節點再測一次,區分新參數問題與路由器整體網路問題。
延遲測試成功只證明健康檢查網址當時可達,不代表每個目標服務都能使用。完成標準是 OpenClash 能啟動、節點位於正確設定與群組、真實請求經它建立,而且原節點仍可切回。
看得到節點卻無法連線:依序核對 UUID、連接埠、TLS、SNI 與傳輸欄位,不要同時改 DNS、Fake-IP、TUN、核心與代理模式。
常見失敗與還原:只撤銷本次新增內容
| 現象 | 先查什麼 | 處理方式 |
|---|---|---|
| 訂閱更新失敗 | 是否未開啟線上轉換 | 使用可信轉換服務,或改為本機匯入 |
| 本機匯入顯示格式無效 | 連結是否完整且以 vmess:// 開頭 | 從可信來源重新複製,不要公開解碼內容 |
| 解析成功但節點未出現 | 設定檔與代理群組 | 選擇目前設定和已存在群組後重新套用 |
| 節點出現但無法連線 | 伺服器、UUID、TLS、SNI、傳輸 | 逐項對照服務端,一次只改一項 |
| 更新後無法啟動 | 啟動記錄第一個解析錯誤 | 移除本次項目並恢復原設定 |
還原本機方案時,只刪除本次新增的伺服器節點,回到 Servers & Groups manage 再按 Apply Settings,把刪除結果寫回目標 YAML,然後重新載入目前的執行設定。線上方案要先切回原本啟用的設定,再停用或刪除本次訂閱條目;這不會自動刪除已產生的 YAML。若檔案確實由本次測試建立且不再需要,先確認它不是啟用設定並下載備份,再從 Config Manage 單獨移除。不要刪除原訂閱或批次清空節點。
若連結已交給不可信的轉換服務,刪除 OpenClash 條目無法撤回資料;應從服務端輪換 UUID 或重新產生分享認證資訊。相關平台入口可在本站下載頁面核對,但更換客戶端不能修復錯誤參數。
官方來源與版本邊界
- OpenClash v0.47.156 官方 Release
- OpenClash v0.47.156 設定訂閱編輯原始碼
- OpenClash v0.47.156 設定訂閱清單原始碼
- OpenClash v0.47.156 節點與策略組管理原始碼
- OpenClash v0.47.156 設定管理原始碼
- OpenClash v0.47.156 伺服器節點編輯原始碼
- OpenClash v0.47.156 分享連結本機匯入原始碼
- OpenClash v0.47.156 官方簡體中文介面翻譯
- Mihomo 官方 VMess 節點設定文件
- OpenClash 儲存庫社群討論 #5307
版本號、檔案名稱與介面文字可能隨專案更新而變動,操作前請以連結中的專案文件為準。