OpenClash 安装与订阅配置：路由器翻墙入门
梯子岛编辑部 · 更新于 OpenClash 是 OpenWrt 路由器上的 Mihomo 客户端插件。装之前先确认路由器能刷或已在跑 OpenWrt、做好备份，并把精简版 dnsmasq 换成完整版；订阅按 Clash 配置导入。官方建议用主路由方式，装完要自己验证并留好回滚办法。
OpenClashv0.47.156
- 类型
- Mihomo 系路由器插件
- 内核
- Mihomo
- 支持系统
- 路由器
- 最新版本发布于
- 2026-08-10（核验时已发布 59 天）
- 版本核验时间
- 2026-10-09 09:07 UTC（来源：GitHub 官方接口）
- 官方地址
- github.com/vernesong/OpenClash/releases
在路由器上装 OpenClash，难点从来不在“点安装”，而在安装之前：你的路由器能不能跑它、依赖有没有备齐、出了问题能不能退回去。这篇 OpenClash 安装入门把顺序捋清，再接着讲订阅怎么放进去，以及哪些设置第一次最好别碰。涉及的是整个家庭网络，所以每一步都以“可回滚”为前提，客户端定位见 OpenClash 档案。
动手之前，先确认这件事值不值得做
路由器上的透明代理有明显的好处：家里每台设备不用各自装客户端。但代价也同样明显：
- 配错会影响全家上网，不只是你一台设备；
- 排查起来比桌面客户端麻烦，没有一个“关掉就好”的开关；
- 需要的固件环境对设备型号有要求。
如果你只是偶尔用，桌面或手机客户端往往更省心。路由方案的整体取舍见 路由器翻墙怎么做，固件分类见 路由器固件导航。它与另一款常见插件的差异，看 OpenClash 与 Passwall 对比。
OpenClash 安装前的核对清单
按顺序勾，缺一项就先别往下走：
| 核对项 | 怎么查 | 不满足怎么办 |
|---|---|---|
| 路由器型号是否在 OpenWrt 支持列表 | 去官方设备总表搜型号 | 换设备或放弃这个方案 |
| 当前固件是不是 OpenWrt 系 | 登录管理页看固件信息 | 先研究固件项目对该型号的说明 |
| 闪存与内存是否够用 | 管理页的系统信息 | 空间不足时不要硬装 |
| 有没有配置备份 | 系统里的备份与恢复功能 | 先备份，再继续 |
| 上级网络能否访问下载源 | 路由器自己能不能联网 | 先把基础联网修好 |
设备总表和固件选择器的入口都在 OpenWrt 官网 以及 OpenWrt 支持设备总表，类似的国内常见衍生固件也各有自己的设备列表，请以对应项目页面为准。第三方魔改固件，官方指南明确不推荐。
依赖：dnsmasq-full 必须先到位
这是新手最容易漏的一步。官方指南写明，需要用完整版的 dnsmasq 替换系统自带的精简版，否则 DNS 劫持不生效。结果就是插件看起来在运行，但域名解析不走它，分流整体失灵。
操作思路是：
- 在软件包管理里查看当前装的是哪个 dnsmasq。
- 按官方指南的依赖说明，把精简版替换为完整版，替换前后都不要断开管理连接。
- 其他依赖也一并对照指南的依赖章节逐个确认。
替换的具体命令或界面步骤随固件变化，请照官方指南和固件文档操作，不要照搬别人截图里的命令。
OpenClash 安装的主体步骤：只认官方发布页
插件包请从官方仓库的发布页获取，入口汇总在 下载导航 和 GitHub 项目导航。通用的安装流程是：
- 先看发布页对架构的说明，确认包与你的设备架构一致。
- 把包上传到路由器，通过软件包管理或命令行安装，具体做法按官方指南。
- 安装完成后刷新管理页，应该能在服务菜单里看到它的入口。
- 先别开启，进入下一节检查内核与配置。
不要从论坛网盘或群文件里下载“整合包”，一来无法核对内容，二来可能夹带别的东西。来源判断见 破解版梯子软件能用吗。
OpenClash订阅 怎么导入，导入前先想清楚三件事
它读取的是 Clash 或 Mihomo 的 YAML 配置订阅，并且预设了几种订阅客户端标识，用来应对服务方按标识返回不同内容的情况。导入前想清楚：
- 订阅返回的是不是 Clash 配置：不是的话，要么换一个支持 Clash 格式的订阅，要么先转换。官方还提供了可选的在线订阅转换后端，但接入第三方转换服务意味着订阅会经过对方，风险见 订阅转换怎么做才安全，我们更建议用 节点转换工具 在本地处理。
- 订阅链接怎么保管：路由器的管理页如果对外暴露，订阅链接就跟着暴露。泄露的处理见 订阅链接泄露了怎么办。
- 更新方式：先手动更新一次，成功后再考虑定时更新。
导入的通用顺序是：在订阅配置里新增一项，填入名称和地址，选择合适的客户端标识，保存后手动更新，最后在配置文件里选中它。订阅基础概念可对照 Clash 订阅怎么导入，两者的思路是通用的。
openclash配置 第一次先别动的开关
装好、导入订阅之后，容易手痒去改很多选项。第一次建议保持默认，只确认下面几点：
- 运行模式：选择前先读官方指南对各模式的说明，不确定就用默认。
- DNS 相关：这部分与 Clash DNS 设置详解 是同一套概念，改之前先理解 fake-ip 与 redir-host 的区别，词典里有 Fake-IP 的解释。
- 内核：它使用 Mihomo 内核，另有作者维护的分支，具体用哪个按指南选择，协议能否使用取决于内核版本。
- 特殊协议：Hysteria2、TUIC 这类 QUIC 系协议在较新的 Linux 内核上如果出现断流，指南建议先尝试关闭 quic-go 的 GSO 相关选项。
装完之后怎么验证，出了问题怎么回滚
验证要分层，不要只看一个网页能不能打开：
- 插件状态：服务页显示已运行，日志里没有持续报错。
- 局域网设备：手机连上这个路由器，打开 IP 与 DNS 检测导航 的工具，看出口是否符合预期。
- 直连与代理各测一个：确认分流没有把国内站点也带走，慢的话参考 开了梯子后国内网站变慢。
- DNS：对照 DNS 泄露怎么解决。
回滚的底线是三层：先在插件里停止服务；不行就恢复事先备份的配置；还不行再用路由器自带的恢复模式回到干净固件。这三层都要在安装之前就想好，而不是出事之后现想。
下一步怎么走
- 还在犹豫方案，先读 路由器翻墙怎么做 和 OpenClash 与 Passwall 对比。
- 打算改用另一款插件，看 Passwall 安装与设置。
- 订阅或节点连不上，从 梯子连不上怎么办 起步。
- 官方发布与版本入口，统一在 GitHub 项目导航。
这篇没有覆盖的
- 本文只讲客户端侧的安装与订阅思路，不涉及固件刷写的具体步骤，刷机有变砖风险，请按固件项目与设备页面的说明操作。
- 官方知识库面向的是机器可读的指南，细节会随版本变化，具体按钮与选项名称请以你安装版本的界面和指南为准。
- 梯子岛没有各型号路由器上的性能数据，下文不给任何速度结论。
- 协议是否可用取决于所装的内核版本，需要你自行核对。
本文引用的官方来源
- OpenClash 官方仓库（github.com）
- OpenClash 官方文档（github.com）
- OpenClash 官方下载入口（github.com）
- OpenWrt 支持设备总表（openwrt.org）
以上链接均为官方页面，梯子岛在 2026-10-09 核对过；个别网站会拦截自动化访问，用浏览器直接打开即可。平台规则可能随时调整，以官方页面当前内容为准。
OpenClash 安装常见问题
我的路由器是厂家原版系统，能直接装 OpenClash 吗？
不能直接装。它是 OpenWrt 的插件，路由器必须运行 OpenWrt 或兼容的衍生固件。是否有对应的固件、怎么刷，要去固件项目和设备支持页面查证，刷机有风险，先确认型号和版本，没有把握不要动手。
旁路由和主路由方式选哪个？
官方指南更推荐主路由方式，并指出旁路由组网有固有缺陷，也不推荐第三方魔改固件。如果你的家庭网络已经是旁路由结构，建议先读官方指南里对应的说明，再决定是否调整。
订阅导进去之后节点是空的，怎么回事？
常见原因是订阅返回的内容不是它能读的格式，或者订阅地址对不同客户端标识返回不同内容。官方预设了几种客户端标识，可以尝试切换，也可以先用本地工具把订阅转成 Clash 配置，再导入。
Hysteria2 或 TUIC 节点连不上，是插件的问题吗？
不一定。能否使用取决于你所装的内核版本，官方指南还提到在较新的 Linux 内核上这类节点若出现断流，可以先尝试关闭一项与 GSO 相关的选项。仍无法解决时，再回到节点本身和服务方排查。
装完整个家里都上不了网了，怎么办？
先在插件里停止服务，再检查 DNS 相关设置有没有被劫持异常。仍然不行就按事先备份的配置恢复，或者用路由器的恢复模式回到干净状态。这也是为什么安装前一定要先备份。
接着读
- 客户端 · OpenClash 是什么？OpenWrt 路由器上的 Clash 插件
- 对比 · OpenClash 与 Passwall 对比：路由器代理插件怎么选
- 平台 · 路由器翻墙怎么做？固件、插件与家庭网络的取舍
- 教程 · Passwall 安装与设置：OpenWrt 代理插件入门
- 教程 · Clash 订阅怎么导入？订阅链接、更新与导入失败自查
- 教程 · Clash DNS 设置详解：fake-ip 与 redir-host 怎么选