OpenClash 路由器导入订阅教程：OpenWrt 插件上手

官方信息核对（2026-10-21）

下面这张表只记录我们在官方 GitHub 仓库页面和 Releases 页面上直接看到的内容，搜索引擎摘要和第三方镜像站给出的版本号一律没有采用。

项目	核对结果
官方仓库	https://github.com/vernesong/OpenClash
官方发布页	https://github.com/vernesong/OpenClash/releases
最新正式版	v0.48.002（标记为 Latest，非预发布）
发布日期	2026-10-12
适用系统	OpenWrt（README 徽标为 OpenWrt 18.06+，LuCI 需 19.07 及以上）
安装包格式	.ipk（opkg）与 .apk（apk）两种
许可证	MIT
是否归档	否，仓库处于公开活跃状态
内核	Mihomo（Clash Meta）

仓库简介写的是「A Clash Client For OpenWrt」，README 进一步说明它是一个在 OpenWrt 上管理 Mihomo 内核的 LuCI 插件。最低内存要求官方页面没有给出明确数字，这一项我们写作「未能核实」。

OpenClash 解决的是什么问题

手机、电脑各装一个代理客户端，对一个人来说并不麻烦；但家里有电视盒子、游戏机、智能音箱这类装不了客户端的设备时，就需要把代理功能放到路由器上。OpenClash 的思路是：在 OpenWrt 路由器上跑一个 Mihomo 内核，再用 LuCI 网页界面把订阅、规则、运行模式都管理起来，所有接入这台路由器的设备都能按规则分流。

它和电脑上的 Clash Verge Rev 用的是同一类内核、同一类 YAML 配置，所以如果你已经熟悉 Clash 系客户端的「代理组」「规则」「策略」这些概念，上手 OpenClash 会快很多。区别在于路由器是全家共用的网关，一旦配置出错，影响的是所有设备，而不只是你自己的一台电脑。这一点是理解后面所有建议的前提。

谁适合用，谁不建议折腾

适合的人：

• 已经刷好 OpenWrt 或基于 OpenWrt 的第三方固件，能够登录 LuCI 后台，也会用 SSH 登录路由器。
• 家里有多台装不了客户端的设备，希望统一分流。
• 能接受偶尔需要排查 DNS、防火墙一类的问题。

不太适合的人：

• 路由器还是厂商原厂固件，没有刷机经验。为了一个插件去刷机，风险和收益不成比例，可以先看 家庭设备怎么用订阅 里更简单的方案。
• 只有一两台设备需要代理，直接在设备上装客户端更省事。
• 路由器内存和闪存都很小。OpenClash 依赖 ruby 等组件，内核本身也有一定体积，低配机型可能装不下或者运行吃力。

安装前一定要做的备份

路由器操作是有风险的。刷机或安装插件失误，轻则全家断网，重则设备无法启动，需要用恢复模式甚至编程器救砖。所以在动手之前，请务必做好下面几件事：

1. 备份当前系统配置。 OpenWrt 的 LuCI 一般在「系统」下有「备份与升级」之类的页面，可以生成一个配置备份文件，下载保存到电脑上。不同固件与版本名称略有差异，找不到时请查阅你所用固件的说明。
2. 记下宽带拨号信息。 如果路由器负责 PPPoE 拨号，提前把账号密码记在纸上或者向运营商确认好，万一需要重置时用得上。
3. 了解救砖方法。 每款机型进入恢复模式的方式都不同，有的是按住复位键开机，有的需要 TFTP。动手前先查清楚你这台设备的方法。
4. 准备一条备用网络。 手机热点就够用，路由器出问题时你还能上网查资料。

OpenClash 自身也提供了配置的备份恢复功能，官方说明里提到配置管理支持备份、恢复和加密。但插件内的备份只管插件自己的设置，不能代替系统级备份，两者最好都做。

OpenClash 安装思路（通用做法）

官方 Releases 页面给出了 .ipk 和 .apk 两种安装包，分别对应使用 opkg 和 apk 包管理器的固件。较新的 OpenWrt 版本已经转向 apk，较老的版本仍用 opkg，先确认你的固件属于哪一种，再下载对应的包。

官方页面列出的依赖大致分几类：基础的 luci、luci-base、luci-compat；运行需要的 bash、curl、ca-bundle、ruby、ruby-yaml；网络相关的 dnsmasq-full、ipset、ip-full、unzip；防火墙方面，使用 iptables 的固件需要 ipset 和 iptables-mod-tproxy，使用 nftables（firewall4）的固件需要 kmod-nft-tproxy。TUN 模式另外需要 kmod-tun。

通用的安装顺序是：先用包管理器更新软件源列表，安装上述依赖，再安装 OpenClash 的安装包，最后刷新 LuCI 页面，在「服务」菜单下找到 OpenClash。具体命令写法取决于你的包管理器和固件，请以官方 Releases 页面上的安装说明为准，本文不提供具体命令参数。

需要特别注意的是 dnsmasq-full。很多固件默认装的是精简版 dnsmasq，替换成完整版时会先卸载旧包，这个过程中路由器的 DNS 可能短暂失效。建议用网线连接路由器操作，不要在 Wi-Fi 下远程进行。

另外，官方说明提到首次运行时插件会下载内核，所以安装后路由器本身需要能正常访问网络。你也可以按官方说明把内核文件手动放到指定目录，但请只使用官方渠道发布的内核。下载来源的判断方法可以参考 下载安全指南。

OpenClash 导入订阅的步骤

在 LuCI 里进入「服务」下的 OpenClash，再进入「配置管理」或「配置订阅」相关页面（不同固件与版本名称略有差异）。官方文档描述的订阅条目包含两个关键字段：订阅名称和订阅地址。订阅名称是你给这份配置起的名字，订阅地址就是机场后台给出的订阅链接。

几个要点：

• 优先使用 Clash 订阅。 OpenClash 下载订阅后按 YAML 解析，机场提供的 Clash 格式订阅最对口。什么是 Clash 订阅、怎么在机场后台找到它，可以看 Clash 订阅使用指南。
• 订阅转换要谨慎。 官方说明提到可以接入订阅转换后端，并支持自定义 User-Agent 和请求头。但把订阅链接交给第三方转换服务，相当于把你的节点信息交出去，能用原生 Clash 订阅就不要转换。
• 设置自动更新。 官方文档里每条订阅都可以单独设置自动更新，有按周、按天定时的方式，也有按分钟循环的方式，默认是关闭的。机场节点经常调整，建议打开并设一个合理的频率，比如每天一次。
• 订阅链接不要外泄。 订阅链接本身就是凭证，截图求助时要打码。订阅链接的含义可以看 订阅链接是什么。

如果订阅更新失败，常见原因包括路由器本身无法访问订阅域名、订阅已过期、机场对请求头有限制等，排查步骤可以参考 订阅更新失败怎么办。

运行模式与分流

OpenClash 的设置项很多，新手最容易在运行模式和 DNS 上出问题。官方文档把运行模式、TUN、Fake-IP 等内容分在不同章节说明，这里只讲思路：

• Fake-IP 一类的模式 解析速度快，但部分依赖真实 IP 的应用可能出现异常。
• TUN 模式 能接管更多类型的流量，需要内核模块支持，对路由器性能要求更高。
• 规则分流 决定哪些网站走代理、哪些直连。机场订阅一般自带规则，你也可以叠加自己的规则。规则的写法和优先级可以看 分流规则指南。

官方 Releases 页面特别提醒：不建议在路由器上开启 IPv6，因为大量连接问题报告都与此有关。浏览器的「安全 DNS」功能也可能绕开路由器的 DNS，导致分流不生效。这两点是 OpenClash 用户最常踩的坑，遇到「部分网站打不开」时，先从这两处查起。

OpenClash 常见问题排查思路

插件启动后全家断网。 第一步永远是先停止 OpenClash，看网络能否恢复。恢复了，问题就在插件配置；没恢复，再看是否动了系统的防火墙或 DNS 设置。必要时用安装前的系统备份还原。

订阅导入了但节点全部超时。 检查订阅里的节点协议当前内核是否支持，官方列出的协议包括 Shadowsocks、ShadowsocksR、VMess、VLESS、Trojan、Snell、TUIC、Hysteria 等。协议的区别可以看 协议科普。

用一段时间就断流。 可能是路由器内存不足导致进程被系统结束，也可能是节点本身不稳定，排查方法见 连接频繁断开怎么办。

更新插件后设置丢失。 升级前先用插件自带的备份功能导出配置。官方说明中，删除某份配置会同时删除配置文件、历史缓存和运行时配置，误删很难找回。

和其他路由器插件怎么选

OpenClash 的优势在于和 Clash 生态完全一致，机场的 Clash 订阅拿来就能用，规则写法与桌面端相通，社区资料也多。它的缺点是依赖较多、设置项复杂，对低配路由器不太友好。

如果你更习惯 Xray 或 sing-box 内核，可以看 PassWall 系列；如果你用的是 ImmortalWrt 固件，又偏好 sing-box，可以看 HomeProxy；如果你的设备不是标准 OpenWrt，比如一些厂商固件或者 Linux 小主机，ShellCrash 这种脚本方案可能更合适。更多客户端可以在 客户端总览 里对比。

写在最后

OpenClash 更新频繁，本页信息核对于 2026 年 10 月 21 日。安装之前请再打开一次官方 Releases 页面，确认最新版本和安装说明；只从官方仓库下载安装包，不要使用来路不明的打包版本。最后再强调一次：路由器是全家人的网络入口，动手前先备份，出问题先停插件，这两条习惯能帮你避开大部分麻烦。