OpenClash 教程

OpenClash 是 OpenWrt 路由器上最流行的 Clash 图形化插件，使用 mihomo（Clash.Meta）内核在路由器层面完成分流。配好之后，电视、游戏机、手机等设备无需安装任何客户端就能按规则走代理。整个过程最容易卡住的是两步：依赖里的 dnsmasq-full 和首次下载内核，提前处理好，其余都是填订阅、点启动。

使用前的准备

项目	要求
系统	OpenWrt 官方或常见分支固件，README 要求 LuCI 19.07 及以上
存储	要放内核、规则文件和 GeoIP 数据，闪存很小的路由器不建议使用
防火墙	OpenWrt 22.03 起默认 firewall4（nftables），更老的版本为 iptables，依赖要对应选择
包管理器	多数固件用 opkg（.ipk），新版固件改用 apk（.apk）
订阅	机场提供的 Clash / mihomo 订阅链接

动手前先在 LuCI 的“备份/升级”页面生成一份系统备份并下载到电脑。本文默认你已经能登录 OpenWrt 的 LuCI 管理界面。

不确定路由器方案是否适合自己，可以先看 路由器使用机场教程。

官方下载入口

• GitHub 仓库：github.com/vernesong/OpenClash
• 安装包：仓库的 Releases 页面。本文参考 2026 年 10 月 12 日发布的 v0.48.002，项目仍在持续更新。

Releases 同时提供 .ipk 和 .apk 两种格式。先用 SSH 确认路由器的包管理器和防火墙类型，再下载对应的安装包。

第一步：安装依赖

按 OpenClash README，主要依赖如下：

类别	软件包
基础	luci、luci-base、luci-compat
运行	bash、curl、ca-bundle、ruby、ruby-yaml
网络	dnsmasq-full、ipset、ip-full、unzip
iptables 固件	iptables、kmod-ipt-nat、iptables-mod-tproxy、iptables-mod-extra
nftables 固件	kmod-nft-tproxy
可选	kmod-tun（TUN 模式）、ip6tables-mod-nat（IPv6）、kmod-inet-diag（按进程名匹配规则）

最常见的坑是 dnsmasq：很多固件自带精简版 dnsmasq，必须先卸载再装 dnsmasq-full，否则 OpenClash 的 DNS 功能无法正常工作。

第二步：安装插件

• 网页安装：在 LuCI 的软件包页面上传安装包并安装，刷新后“服务”菜单下会出现 OpenClash。
• 命令行安装：通过 SSH 上传安装包，用 opkg install 或 apk add 安装，具体命令以 README 为准。

第三步：下载内核

OpenClash 插件本身只是管理界面，内核不随安装包附带，首次使用必须下载 mihomo 内核，README 也提醒要提前确认网络环境。

1. 在插件的版本更新相关页面确认路由器 CPU 架构（如 aarch64、x86_64、mipsel 等），架构选错内核无法启动。
2. 尝试在线下载。路由器在没有代理时访问 GitHub 常常很慢甚至失败，可以切换插件提供的其他下载源。
3. 仍然失败，就在电脑上下载对应架构的内核文件，再手动上传到路由器的内核目录。

早期教程里“Dev 内核 / TUN 内核”的划分已经不适用，当前版本以 mihomo 内核为主，并支持在线更新与切换。

第四步：导入订阅

1. 进入 OpenClash 的配置订阅页面，添加一条订阅，填写名称和 Clash 订阅链接。
2. 开启自动更新，更新时间建议选在凌晨等不常用的时段。
3. 保存后执行一次更新，配置文件会出现在配置管理中，选中它作为当前配置。
4. 回到运行状态页面，启动 OpenClash。

订阅更新失败时，先确认路由器本身能访问订阅地址，再参考 机场订阅更新失败怎么解决。

第五步：选择运行模式

模式	原理	优点	缺点
Fake-IP	DNS 直接返回保留段的假 IP，由内核按域名分流	响应快、分流准	少数依赖真实 IP 的设备和应用需要加入过滤名单
Redir-Host	返回真实解析结果，再按 IP 或域名分流	兼容性好	多一次解析往返，防污染配置更复杂

新手建议先用 Fake-IP。需要接管游戏等 UDP 流量时，再考虑 TUN 或混合模式，前提是已安装 kmod-tun。

使用 Fake-IP 时，局域网设备上看到的解析结果是 198.18.x.x 一类的地址，这是正常现象，不是故障。

两种模式的完整对比见 Fake-IP 与 Redir-Host 模式有什么区别，如何选择，DNS 字段含义见 代理客户端 DNS 设置教程。

第六步：验证

1. 在运行状态页面确认内核已运行、配置已加载。
2. 打开插件内的 Web 控制面板，在策略组里选节点并测速。
3. 用一台没有安装任何代理软件的设备访问国外网站，确认能打开。
4. 再访问国内网站，确认直连速度正常。

日常维护

路由器方案一旦跑起来，平时只需要做几件小事：

• 订阅：保持自动更新开启，机场更换节点后路由器会自动同步。
• 规则与 GeoIP 数据：插件可以定时更新这些数据文件，建议和订阅一起放在凌晨。
• 内核与插件升级：升级前先导出配置，升级后检查运行状态和日志，确认没有报错再离开。
• 性能：低端路由器的 CPU 在加密协议下容易成为瓶颈，跑不满带宽时，参考 代理下载速度慢怎么解决 判断是节点还是硬件的问题。

常见问题

启动失败怎么排查？

先看插件日志。最常见的三个原因依次是：内核没下载或架构不对、依赖缺失（尤其是 dnsmasq-full）、配置文件格式错误。按这个顺序逐一排除。

一开启全家就断网？

多为 DNS 冲突，例如同时运行了 AdGuard Home、SmartDNS 等插件，端口或转发设置打架。先停用其他 DNS 插件确认能恢复，再按 代理 DNS 问题怎么解决 调整转发顺序。

打印机、NAS 或游戏机联网异常？

这类设备依赖真实 IP 或局域网发现，在 Fake-IP 下容易出问题。把相关域名加入 Fake-IP 过滤名单，或用访问控制让该设备绕过代理，做法见 fake-ip 模式引发的兼容问题怎么排查与修复。

只有某台设备不走代理？

检查这台设备是否手动设置了 DNS（如 8.8.8.8），绕过了路由器的 DNS。改回自动获取即可。

能和 PassWall 一起装吗？

可以装在同一台路由器上，但不要同时启用，两个透明代理插件会争抢防火墙规则和 DNS。更偏好按节点分流的方式，可以改用 PassWall 使用教程 中的方案。

配置备份

OpenClash 支持在插件内导出配置与设置；同时建议定期在 LuCI 的“备份/升级”页面生成完整系统备份，刷机或升级固件前务必先下载保存。全家多设备共用一条订阅时，流量和在线设备数都会增加，挑选套餐可参考 多设备机场：家庭共享与多终端。