你在解决什么问题:OpenWrt 上从零完成 OpenClash 安装

很多人搜OpenClash 安装或OpenClash OpenWrt 安装教程,目标并不是立刻精通 YAML,而是把路由器变成一台长期在线的 Clash 网关:能登录 LuCI、插件菜单里出现 OpenClash、订阅写进去、LAN 下的手机与电脑真的换了出口。站内已有《OpenClash 策略组分流》与《旁路由透明代理与 DNS 分流》,它们默认你已经装好插件并能进设置页;本文补的是从零到首轮订阅导入这条被跳过的主线,覆盖固件要求、依赖、LuCI 插件安装与第一次联网验证。

你可以把本篇当作「OpenWrt 装 OpenClash 2026」的操作版摘要:不堆概念名词,而是按真实检索意图写——在能 SSH 或 LuCI 的管理网络上,确认架构与存储对得上、opkg 依赖装齐、luci-app-openclash 出现在服务菜单、Mihomo 内核下载完成、订阅刷新后有节点,最后用独立检测页证明流量确实进了隧道。装通之后,日常选节点与分流切换请直接衔接到策略组专题;旁路网关拓扑与 DHCP 分工则交给旁路由文。

ℹ️
与桌面客户端的分工:OpenClash 适合「全屋设备共享同一套规则」;若你只想在单台电脑上快速试用,可并行阅读本站 Windows、macOS 或 Android 安装指南。路由器方案的优势是透明代理,代价是固件与插件环境更敏感。

固件要求:版本、架构与存储先对齐

OpenClash 安装失败里最高频的一类,不是订阅写错,而是ipk 架构与固件不一致。动手前请在 LuCI「系统 → 概览」或 SSH 里记下三项:OpenWrt 发行版本(如 22.03、23.05、24.x 等)、目标平台(aarch64_cortex-a53、x86_64、ramips/mt7621 等)以及剩余 Flash 与 overlay 空间。OpenClash 本体加上 Mihomo 内核与规则缓存,通常建议至少预留几十 MB 可用空间;空间告急的路由器要先清理旧日志、卸载无用 LuCI 主题,或换更大 Flash 的机型,否则内核下载到一半就会报写入失败。

架构核对命令示例(SSH):opkg print-architecture 与 uname -m。你在 GitHub Release 或作者维护的软件源里选的 ipk,文件名里的架构字符串必须与之一致;不要用其他型号路由器的包凑合,装得上也可能因缺少内核模块而无法启动透明代理。若你刷的是第三方精简固件,还要确认是否自带完整 opkg 软件源——部分「超精简」镜像裁掉了 iptables-mod-tproxy、kmod-tun 等模块,后续 OpenClash 的 Redir、TUN 路径会集体报错。

时间同步同样属于「固件要求」:OpenWrt 若长期错时,HTTPS 订阅更新与内核下载会全线报证书错误。请在「系统 → 时间同步」启用 NTP,或手动对齐后再做首轮导入订阅。合规层面只强调一次:只导入你有权使用的订阅与规则;公司或运营商网络若禁止旁路网关,应走工单而不是在本文寻找灰色开关。

⚠️
刷机风险:若你的设备仍在原厂系统或 OpenWrt 与当前硬件不匹配,请先完成正确的 OpenWrt 刷机与首次引导,再谈 OpenClash。本文默认你已经能稳定登录 LuCI 并执行 opkg。

依赖包:opkg 更新与 OpenClash 前置组件

官方文档与社区经验里,OpenClash OpenWrt 安装教程几乎都会列出同一批依赖:bash、iptables、ipset、dnsmasq-full、curl、ca-bundle、coreutils-nohup 等。不同 OpenClash 版本与透明代理模式(Redir、TPROXY、TUN)还会额外要求 iptables-mod-tproxy、kmod-tun、ruby 或 ruby-yaml 一类包——以你下载的插件版本说明为准,不要死记一份过期的清单。

推荐顺序:第一,SSH 登录路由器,执行 opkg update,若报错先检查 WAN 上网与软件源镜像是否可达;第二,按文档批量安装依赖,例如:

opkg update
opkg install bash iptables ipset dnsmasq-full curl ca-bundle \
  coreutils-nohup iptables-mod-tproxy kmod-tun

第三,安装完成后用 opkg list-installed | grep -E 'bash|ipset|dnsmasq' 抽查关键包是否在列。LuCI「系统 → 软件包」也能完成同样操作,适合不熟悉终端的读者;但批量复制命令往往更不容易漏项。若 dnsmasq-full 与系统自带的 dnsmasq 冲突,插件文档通常会说明如何切换或共存——不要在未读说明的情况下强行卸载系统 DNS 组件,否则 LuCI 与 DHCP 可能一起异常。

存储与内存紧张时,可先不装可选的 Ruby 相关包,等确认你的 OpenClash 版本确实需要再补装;反之,若插件启动日志明确提示缺少某模块,就回到 opkg 精确安装,而不是反复重装 OpenClash 本体。

安装 OpenClash LuCI 插件:软件源、feed 与手动 ipk

OpenWrt 装 OpenClash 常见有三条路:作者维护的软件源 feed、LuCI 软件包页在线安装、以及下载 ipk 手动上传。Feed 方式适合愿意维护自定义源列表的用户:按 OpenClash 仓库 README 把源地址写入 /etc/opkg/customfeeds.conf 或等价文件,opkg update 后 opkg install luci-app-openclash。手动 ipk 适合 feed 暂时不可用、或你已在 Release 页核对好架构的场景:在 LuCI「系统 → 软件包 → 上传软件包」选择文件安装,或在 SSH 里 opkg install /tmp/luci-app-openclash_*.ipk。

安装成功后,刷新 LuCI 页面(必要时清浏览器缓存),在「服务」菜单下应出现 OpenClash 入口。若菜单迟迟不出现:检查 luci-app-openclash 是否与当前 LuCI 版本兼容(部分旧固件需要 luci-compat);SSH 执行 /etc/init.d/rpcd restart 或重启 uhttpd;确认安装日志里没有「Wrong architecture」或依赖未满足的报错。切忌从来源不明的网盘安装二次打包 ipk——那会把整台网关的信任边界一起送出去。

ℹ️
版本选择:优先安装与你 OpenWrt 分支接近的 OpenClash 稳定版;追新尝鲜前先备份 /etc/config/openclash 与自定义规则目录,升级插件后可在「插件设置 → 备份/恢复」快速回滚。

Mihomo 内核:架构匹配与首次下载

OpenClash 是 LuCI 外壳与防火墙脚本,真正跑节点的是Mihomo(Clash Meta)内核。首次进入 OpenClash 的「版本更新」或「运行状态」页,插件通常会提示下载内核:请选择与设备 CPU 一致的 dev 或 stable 分支,并等待下载进度完成。下载失败时,优先看日志里是空间不足、HTTPS 证书还是GitHub 访问问题——后一类在某些网络环境下需要你在「插件设置」里配置可用的内核下载镜像或离线上传,具体选项以当前版本界面为准。

内核就绪后,「运行状态」应显示内核已安装、版本号可读。此时先不要急着开全屋代理:在「插件设置」里确认运行模式默认项、DNS 模式与本地端口尚未与现有服务冲突(例如 53 端口是否被其他 DNS 占用)。若你计划做主路由网关而非旁路,还要提前想好 LAN 侧 DNS 由谁发放;旁路由读者可在装通后阅读旁路由专题,把 DHCP 与网关指向一次理顺。

首轮订阅导入:URL、更新与应用配置

进入 OpenClash「服务器订阅」或等价标签页,新建订阅条目,粘贴以 https:// 开头的 Clash 兼容链接。操作前把 URL 先丢进纯文本编辑器去掉首尾空格与不可见符号——这与桌面客户端《订阅链接导入教程》里的防坑手段相同,在路由器上同样有效。点击「更新订阅」后,观察三样:时间戳是否前进、节点与策略组是否出现在配置预览、日志是否仍有 TLS 或 401。

更新成功后,使用「保存配置」「应用配置」或「重启 OpenClash」中的最小必要动作让内核 reload——不同皮肤按钮文案略有差异,以日志里出现配置重载记录为准。若列表为空,不要立刻怀疑节点质量:先核对系统时间、订阅格式是否为 Mihomo 可解析的 YAML 或 base64 包装,并对照《订阅更新 TLS 与时间排查》。刷新间隔建议克制,避免上游限速;token 类订阅 URL 等同临时口令,勿截图发到公开群组。

⚠️
配置文件路径:确认「当前启用」的配置文件正是订阅写入的那份;多套配置并存时,编辑 A 文件却启动 B 文件是新手常见误判来源。

开启服务:运行模式、防火墙与 LAN 侧准备

在 OpenClash 总开关打开前,建议先把运行模式设为 RULE(规则分流),除非你明确要做全局代理对照测试。随后开启服务,观察「运行状态」是否显示内核运行中,防火墙重定向规则是否已由插件脚本写入。若你使用旁路网关,此时 LAN 设备上的默认网关与 DNS必须指向这台 OpenWrt,否则你在 LuCI 里的一切配置只会影响「已经送达路由器」的连接——这也是许多「装好了但不生效」案例的真实原因。

DNS 相关选项(fake-ip、redir-host、上游 DNS 列表)在首轮联网阶段可先采用插件默认或文档推荐模板,待出口验证通过后再微调;过早同时改 DNS、透明代理与自定义规则,会把变量叠到无法排障。防火墙方面,确认 WAN 侧没有多余的「全端口阻断」策略拦截内核出站;USB 4G 网卡等特殊 WAN 还要核对 MTU 与 MSS,避免表现为「能解析但网页半开」。

首轮联网验证:出口、日志与国内直连

验证请在已经指向该路由器的 LAN 设备上进行:打开两个互不隶属同一 CDN 家族的 IP 检测页,核对国家、ASN 是否与所选节点大体一致;再访问国内常用站点,确认未被误送代理。回到 OpenClash「连接/日志」页,查看新会话是否出现命中规则名与策略组,把时间戳与浏览器操作对齐,避免看过期日志。

若检测页显示变更但部分 App 仍直连,检查该 App 是否使用私有 DNS、DoH 或硬编码 IP;若几乎全站直连,则回看运行模式是否为 DIRECT、网关是否仍指向主路由、或规则最早一条是否为全量直连。延迟异常时,与其反复切换全局模式,不如先在策略组里手动钉一个节点做最小复现——详细的手动选节点与 url-test 对照,见策略组专题。

ℹ️
口袋自检清单:架构匹配的 ipk 已装、依赖无 opkg 报错、内核版本可读、订阅更新时间正常、总开关开启且 RULE 模式、LAN 网关与 DNS 正确、两个检测源同向、国内站点仍直连。

装通之后:策略组、规则与旁路拓扑

当OpenClash 安装与首轮导入订阅都完成后,日常维护会转向三类工作:在策略组里换节点、按域名/IP 维护规则、以及在复杂家庭拓扑里对齐 DHCP 与 DNS。本站《LuCI 策略组分流》覆盖 selector 与运行模式;《规则分流最佳实践》帮助你在规则层减少误判;旁路网关读者则继续阅读《旁路由透明代理与 DNS 分流》,避免与主路由 DHCP 抢设置。

需要全平台安装语义对照时,可打开安装与配置文档,把路由器上的「订阅、策略组、RULE 模式」与桌面客户端对齐理解——同一套 Clash 语义,不同外壳而已。

常见问题(安装期排障速查)

opkg 报 Wrong architecture:回到固件架构核对节,重新下载匹配 ipk。内核下载一直转圈:查空间、时间与下载源可达性,必要时离线上传内核包。LuCI 能进但 OpenClash 启动即退出:看运行日志里缺少哪个 kmod 或 iptables 模块,用 opkg 补装后再启。订阅 401 或 TLS error:复制 URL 到 PC 浏览器测试是否需刷新 token,并对照订阅 TLS 排查文。只有 LuCI 本机能代理、其他设备不行:几乎总是网关或 DNS 未指向路由器,或防火墙未放行 LAN forward。

写在最后

把 OpenClash 跑在 OpenWrt 上,本质是把「安装、依赖、内核、订阅、防火墙与 DNS」收敛到一台长期在线的设备;OpenClash OpenWrt 安装教程的价值,在于让你少在架构不匹配与缺依赖的循环里浪费晚上。按本文顺序做完固件核对、opkg、插件、内核与首轮导入订阅,再用检测页与日志交叉验证,比死记某个版本的菜单截图更能应付后续升级。

相比之下,纯路由器方案在「只想快速试一条订阅、不想碰 feed 与 ipk」的单机场景里步骤偏多:固件架构、opkg 依赖、内核下载与防火墙脚本任一环节出错,都要同时翻 LuCI 与 SSH 日志,对新手心智负担不小。ClashSky 面向 Windows、macOS 与 Android 的图形客户端把订阅导入、策略组选择与连接摘要集中在一块屏里,路径更短、对照日志更直观,适合作为 OpenWrt 方案的并行对照,或在单机上先把规则与策略摸熟再回路由器做全屋覆盖。若你希望少在软件源与 ipk 之间来回试错,不妨立即免费下载 Clash,开启流畅上网新体验,用同一套方法论感受差异。