OpenClash 使用教學

OpenClash 外掛安裝、訂閱設定與主路由代理

OpenClash 是在 OpenWrt 上管理 Mihomo 的 LuCI 外掛。本教學以可正常連網的主路由器為例,完成外掛與核心準備、設定檔匯入及終端裝置驗證,並說明停用與恢復連線的方法。

教學資訊
適用平台
OpenWrt
核心
Mihomo
最後更新

步驟 01下載安裝

安裝前確認主路由和下游裝置連網正常,並記下原閘道與 DNS;選用:在 LuCI 匯出系統設定備份,方便還原原本設定。

開啟本站下載頁:opkg 選 IPK,apk 選 OpenWrt APK。本站 IPK ZIP 先解壓出 .ipk;其他套件從同頁官方入口取得。

OpenClash 下載頁在桌面解析度下的完整 OpenWrt IPK 安裝套件卡片

透過 SSH 以 root 登入路由器,依韌體套件管理器擇一安裝基礎相依套件。opkg 韌體依序執行:
opkg update
opkg install bash dnsmasq-full curl ca-bundle ip-full ruby ruby-yaml kmod-tun kmod-inet-diag unzip luci-compat luci luci-base

apk 韌體依序執行:
apk update
apk add bash dnsmasq-full curl ca-bundle ip-full ruby ruby-yaml kmod-tun kmod-inet-diag unzip luci-compat luci luci-base

再依韌體實際使用的防火牆與套件管理器,執行以下對應的一條命令:
Firewall4 / nftables,opkg:opkg install kmod-nft-tproxy
Firewall4 / nftables,apk:apk add kmod-nft-tproxy
iptables,opkg:opkg install iptables ipset iptables-mod-tproxy iptables-mod-extra
iptables,apk:apk add iptables ipset iptables-mod-tproxy iptables-mod-extra
補充來源:官方相依套件說明。

相依套件安裝完成後,再到 LuCI 系统(系統)→ 软件包(軟體套件)→ 上传软件包...(上傳軟體套件),選擇解壓出的 .ipk 並確認安裝。不要上傳 ZIP。

DoorNet OpenWrt 中文軟體套件頁的上傳套件入口

OpenWrt APK 不是 Android 安裝套件,網頁安裝取決於韌體與簽章信任。使用 SCP 將已確認來自官方 Release 的 APK 上傳至路由器,儲存為 /tmp/openclash.apk,再以 root 權限執行 apk add /tmp/openclash.apk。若出現 UNTRUSTED signature,先核對官方 Release 來源,再執行該版本官方提供的本機套件安裝命令:
apk add -q --force-overwrite --clean-protected --allow-untrusted /tmp/openclash.apk
補充來源:官方 APK 命令列安裝步驟。空間或相依套件報錯先停止,解決後再安裝。

步驟 02下載核心

重新登入 LuCI → 服务 → OpenClash → 插件设置 → 版本更新,核對處理器架構,在 编译版本(編譯版本)中依 CPU、位元組順序與韌體選核心。

配圖為 0.47.096 歷史介面:在 内核版本更新(核心版本更新) 區點選 检查并更新(檢查並更新)。新版更新清單:點選 内核(核心)欄的版本單獨更新,不點位址一併更新外掛。

OpenClash 版本更新頁中的處理器架構、Mihomo 核心與插件更新位置

選用的手動上傳(自動下載失敗時再用):配置管理(設定檔管理) → 上传文件类型(上傳檔案類型) → [Meta] 内核文件(.tar.gz)(核心檔案) → 選擇對應 CPU 的官方 .tar.gz 核心封存檔 → 上传(上傳)。不要把 .gz 改副檔名代替,也不要選成設定或備份類型。

步驟 03取得訂閱

從訂閱服務商後台複製Clash / Mihomo YAML 設定連結。以畅连為例,開啟訂閱匯入視窗,點選「复制订阅链接」。

服務商訂閱匯入視窗中的複製訂閱連結按鈕

步驟 04新增訂閱

開啟 配置订阅(設定訂閱)→ 添加(新增),在 配置文件名(設定檔名稱)填入容易辨識的名稱,在 订阅地址(訂閱網址)貼上完整的 Clash / Mihomo YAML 設定連結。

OpenClash 中文設定訂閱中的設定檔名稱與訂閱網址

點選頁面底部 保存配置(儲存設定),返回訂閱清單,確認此訂閱已啟用,再點選這一列的 更新,等待設定檔下載完成。

OpenClash 設定訂閱清單中的啟用、更新與編輯位置

步驟 05選擇設定並啟動

開啟 配置管理(設定檔管理)→ 配置文件列表(設定檔清單),找到剛下載的 YAML,點選該列的 切换(切換),設為目前設定。已有本機 YAML 時,也可由設定檔管理上傳後再切換。

回到 运行状态(執行狀態),代理模式(代理模式)先選 规则(規則),開啟執行狀態卡片中的外掛開關。等待核心顯示執行中再繼續下一步;啟動失敗時開啟 运行日志(執行日誌)查看第一條錯誤。

OpenClash 執行狀態中的插件開關、控制面板與代理模式

步驟 06選擇節點並檢查連線

在 运行状态(執行狀態)的 控制面板(控制面板)區域開啟 Zashboard → 代理,展開策略群組,選擇可用節點或保留設定中的自動策略;選取項目以醒目背景顯示。

Zashboard 官方中文代理群組預覽:展開的策略群組與醒目選取項目

先只用一台電腦:檢查主路由下發的閘道與 DNS,依序開啟平時可直接存取的網站、需要透過代理存取的網站和路由器管理頁面,再到 Zashboard 的 连接(連線)查看命中的規則與代理鏈。確認這台電腦連網正常、核心沒有反覆重新啟動後,再測試其他裝置。

步驟 07停用與還原

需要停止使用或還原原本網路時,运行状态(執行狀態) → 關閉外掛開關 → 等待停止。手動改過閘道或 DNS,就依安裝前記錄還原,再測試直接上網與路由器管理頁面。IP 能通、網域不通就查 DNS;路由器能通、下游不通就查 DHCP 與轉送。

OpenClash 執行狀態中的插件開關、控制面板與代理模式

步驟 08代理模式說明

以下模式只處理已進入 Mihomo 的請求。終端閘道、DNS 與防火牆轉送仍須設定正確。

规则(規則):先在策略群組選好節點,日常用這個模式依規則分流。

全局:統一使用 GLOBAL 群組中所選策略,不逐條比對規則;選到 DIRECT 仍是直連。

直连(直連):讓已接管請求直連,外掛仍在執行。排障後切回原可用模式。

Fake-IP、Redir-Host 是 DNS 相關的執行方式,TUN 與混合變體涉及接管方式,不等於全局代理模式。先沿用可用執行模式;改動後依需要清除終端 DNS 快取,只測一台裝置。存取控制已繞過的流量不受這些路由模式影響。

先驗證連線,再處理異常

  • 確認設定已啟用
  • 測試節點連線
  • 核對規則命中
查看連線與設定問題