搜尋意圖:你要的是「OpenWrt 裝 OpenClash」整條路,不是零散 ipk 指令
在路由器上完成 OpenClash 安裝,和在手機或 Windows 裝一個圖形用戶端完全不同:你面對的是 OpenWrt 的固件版本、CPU 架構、flash 剩餘空間,以及 opkg 依賴鏈是否完整。很多人搜尋「OpenClash OpenWrt 安裝教學」「OpenWrt 裝 OpenClash 2026」,真正想要的是一條可重複的路徑:確認硬體與固件對得上 → 裝依賴與 LuCI 外掛 → 匯入訂閱 → 套用運行設定 → 在 LAN 裝置上驗證真的走代理。
OpenClash本質是在 OpenWrt 上包一層 LuCI 管理介面,底下跑 Mihomo/Clash Meta 類核心,負責訂閱、規則、策略組與透明轉發。站內已有 OpenClash 策略組怎麼用與 旁路由透明代理與 DNS,本篇專注從零安裝到首輪訂閱能連上,不重複策略組切換與 DHCP 拓樸細節。裝妥並驗證後,若要讓整個家網走旁路閘道,再回頭對照旁路由長文即可。
固件要求:架構、空間與 OpenWrt 版本先對齊
安裝失敗最常見的原因不是「不會點 LuCI」,而是下載了架構不符的 ipk。請在 LuCI 的系統 → 概覽(或 SSH 執行 uname -m、查看 /etc/openwrt_release)記下:
- CPU 架構:常見為
aarch64_cortex-a53、arm_cortex-a9、x86_64等,必須與 OpenClash 發布頁標註的 target 一致。 - OpenWrt 主版本:23.05 與 24.x 的套件 ABI 不同,勿混用其他版本編譯的 ipk。
- 剩餘 flash:OpenClash 本體、核心與 GeoIP/GeoSite 資料會佔用數十 MB 以上;空間不足時
opkg install會半途失敗或核心無法解壓。 - RAM:128MB 的老舊機型可勉強跑輕量規則,但訂閱節點多、開啟大量規則或 TUN 時容易 OOM,建議 256MB 以上較穩。
若你使用精簡版/第三方精簡固件,可能預設未帶 iptables-nft、完整 dnsmasq-full 或 kmod-tun,後面依賴段落要一併補齊。刷機或升級固件前,請先備份 /etc/config 與已自訂的防火牆規則,避免回退困難。
opkg install 報 Incompatible architecture,或 LuCI 顯示已安裝但核心日誌反覆出現 Exec format error、無法啟動進程。此時請停止重試,改下載正確架構的套件,不要強制覆蓋安裝。
依賴套件:在裝 OpenClash 前先補齊什麼
OpenClash 依賴清單會隨版本更新,但實務上常需以下類別(名稱因發行版略有出入,以你使用的 OpenClash 版本說明為準):
- DNS:
dnsmasq-full(含 ipset/nftset 支援),用於分流與廣告或規則聯動。 - 防火牆與轉發:
iptables-mod-tproxy、iptables-mod-extra,或 nftables 對應模組;透明代理模式需要。 - 工具鏈:
curl、ca-bundle、coreutils、bash或dash(視腳本而定),供訂閱下載與腳本執行。 - TUN(可選):
kmod-tun,若計畫使用 TUN 模式攔截非標準埠流量。 - LuCI 基礎:已具備
luci、luci-base,否則外掛選單不會出現。
可透過 LuCI 系統 → 軟體包 搜尋安裝,或在 SSH 執行(示例,請依你固件調整套件名):
opkg update
opkg install dnsmasq-full curl ca-bundle iptables-mod-tproxy kmod-tun
安裝後若 dnsmasq 與 dnsmasq-full 衝突,需依發行版文件停用精簡版、只保留 full 版並重啟 DNS 服務,否則後續 OpenClash 的 DNS 劫持或分流會異常。企業或營運環境若鎖定唯讀根目錄,請確認 opkg 可寫入 overlay 分區。
安裝 OpenClash:ipk、核心與 LuCI 外掛
OpenClash 安裝通常分兩部分:luci-app-openclash(LuCI 介面與設定)以及對應架構的核心二進位(Mihomo/Clash Meta)。請從專案官方 GitHub Releases或你信任的 OpenWrt 軟體源取得,下載檔名中的架構字串必須與第一節記錄一致。
常見安裝方式:
- 將
.ipk上傳至 LuCI 系統 → 軟體包 → 上傳套件,依提示安裝;或 - SSH 進路由器,
cd /tmp後opkg install /tmp/luci-app-openclash_*.ipk。
安裝完成後重新整理 LuCI,側邊欄應出現 服務 → OpenClash(或類似名目)。首次進入時,精靈或「版本更新」頁面可能提示下載核心——請在網路可直連 GitHub 或鏡像的環境下操作,否則核心會一直停在未就緒。部分使用者會先在 WAN 暫時用手機熱點等方式讓路由器能拉取核心,完成後再切回原本線路。
若你同時安裝其他 Clash 系 LuCI 外掛(舊版 PassWall、ShellClash 等),可能爭用埠號、iptables 鏈或 DNS 埠,建議只保留一套並卸載衝突套件,再啟動 OpenClash,否則日誌會出現埠占用或規則重複插入。
首次設定:運行模式、DNS 與防火牆(最小可運行)
在還沒匯入訂閱前,可先完成這些「底盤」設定,減少後續來回:
- 運行模式:新手可先選兼容模式或僅本機 SOCKS/HTTP 代理測試,確認核心能起再開透明代理;硬體較弱時避免一開始就開 TUN + 全規則。
- 本機代理埠:記下 HTTP/SOCKS 埠,稍後可用 LAN 電腦手動指定代理做 smoke test。
- DNS 相關:若使用「Redir-Host + 假 IP」等方案,請對照 OpenClash 說明與你現有
dnsmasq是否衝突;旁路由場景 DNS 由誰回答更關鍵,本文僅提醒「裝好 ≠ 全網 DNS 已指向路由器」。 - 開機自啟:驗證穩定後再勾選,避免每次重啟都因錯誤設定導致 WAN 斷線難以排查。
每次改動後使用 LuCI 的儲存並套用(或「套用運行設定」),並觀察運行日誌是否有持續報錯。若 WAN 斷線,可透過有線連接 LuCI 或 failsafe 模式還原設定。
首輪訂閱導入:HTTPS 連結、更新與選預設出口
訂閱概念與桌機相同,細節可先看本站 訂閱連結匯入教學。在 OpenClash LuCI 中,進入配置訂閱或訂閱管理(用詞依版本而定):
- 新增一筆訂閱,貼上服務商提供的完整 HTTPS URL,勿截斷查詢參數。
- 為訂閱命名(例如方案名+到期提醒),避免多條連結混淆。
- 設定更新間隔;第一次請務必手動「更新訂閱」,直到節點或策略組列表出現。
- 在運行設定中選擇要使用的配置檔(若訂閱會生成多份,選與你規則模板對應的那份)。
- 在 Proxy/策略組 區為「預設出口」類策略組選一枚延遲正常的節點(進階分流請讀 策略組 LuCI 教學)。
若更新失敗,請保留錯誤訊息並檢查:系統時間是否正確(NTP)、TLS 憑證是否完整、WAN 是否能在未開代理的情況下直連訂閱伺服器。路由器端常見「雞生蛋」:WAN 必須先能出網才能拉訂閱,若你家寬本身需代理才能上外網,請暫時用手機熱點或手動匯入本地 YAML。延伸排查可讀 訂閱更新與 TLS/時間修復。
連線驗證:確認 OpenClash 真的在轉發
完成訂閱與套用後,建議用三層驗證,避免「LuCI 顯示運行中但實際沒流量」:
- 路由器本機:在 OpenClash 的連線紀錄或日誌中,從 LAN 裝置開一個國外測試站,看是否出現對應連線與命中規則。
- LAN 裝置手動代理:暫時將電腦瀏覽器代理設為路由器 LAN IP + OpenClash 提供的 HTTP 埠,開啟 IP 查詢頁比對出口是否變化。
- 透明代理/旁路(若已啟用):關閉手動代理,讓裝置僅依閘道與 DNS 走網,再測一次;若無變化,代表閘道或 DNS 尚未指到這台 OpenWrt,需回旁路由教學調整,而非重裝 ipk。
驗證通過後,再考慮排程更新訂閱、備份 /etc/openclash 目錄,以及是否啟用開機自啟。第一次成功連線的設定檔建議單獨備份一份,日後改規則搞亂時可快速還原。
常見問題
Q:OpenClash 跟 ShellClash、PassWall 要選哪個?
本文只涵蓋 OpenClash 安裝路徑;三者底層都可能跑 Meta 系核心,差異在 LuCI 整合度、預設規則與社群維護節奏。已熟悉 OpenClash 介面者不必強遷;新裝機器建議只裝一套以免衝突。
Q:安裝成功但節點全紅或延遲極高?
先確認訂閱是否更新成功、預設策略組是否選了節點;再測 WAN 到節點 IP 是否被封或 QoS 限速。部分 ISP 對 UDP 不友善,可嘗試切換協定或換線路測試,細節屬營運層面,超出安裝篇範圍。
Q:升級 OpenWrt 後 OpenClash 不見了?
大版本升級常清空 overlay 或需重裝 ipk;請在升級前匯出 OpenClash 設定與訂閱清單,升級後依本文重新安裝對應版本套件並還原備份。
Q:只有手機要走代理,還需要裝路由器版嗎?
若需求僅單機,桌機或手機客戶端更簡單;路由器方案的價值在全網裝置共用、電視/主機等無法裝客戶端的場景。裝不裝取決於拓樸,而非「越複雜越好」。
結語:裝好 OpenClash 之後,下一步去哪裡讀
走完 OpenClash OpenWrt 安裝教學這條線,你應已具備:架構與固件對照、依賴與 LuCI 外掛就緒、首輪訂閱導入成功、以及至少一種可重複的連線驗證。接下來若要調策略組與分流,請接 策略組 LuCI 教學;若要當旁路網關服務全網,請接 旁路由透明代理。
相較之下,把同一套訂閱手動抄進路由器 UCI 或零散 shell,或依賴來路不明的「一鍵整合固件」,往往在升級 OpenWrt 後整包失效、也難對照日誌排查;部分舊式 LuCI 外掛核心停更仍對外稱 Clash,安全與協定支援都落後。桌機用戶端(如 Clash Verge Rev)雖然圖形化程度高,卻無法替電視、家用主機做閘道級轉發。ClashSky在文件層面把可信下載、訂閱觀念、分流延伸閱讀串在同一站,讓你在路由器與電腦兩端都有對照,減少論壇碎片指令踩坑的時間。
若你同時需要幫筆電或手機快速配好代理環境,也可先從說明文件總覽建立概念,再在路由器端套用同一套訂閱邏輯。
無論最終拓樸是主路由還是旁路,先讓 OpenClash 在單一裝置上驗證通過,再擴大到全網,永遠比一次開滿透明代理 + TUN 來得省時間。→ 立即免費下載 Clash,開啟流暢上網新體驗