机场博客JICHANGBOKE.ORG

OpenClash 安装与使用教程(OpenWrt 路由器)

维护中Mihomo 内核开源免费MIT

OpenClash 是装在 OpenWrt 路由器上的 Clash 客户端,内核为 mihomo,开源免费,在后台网页里导入订阅、切换节点。家里想让所有设备一起走代理、机场又给 Clash 订阅的人适合装,2026 年仍在持续发版。

作者 塔台君更新 最新版本 v0.47.156,核对于

官方下载

官方下载走 GitHub,国内网络经常打不开。手上没有能用的代理,可以先买一份 星岛梦-六年老牌专线,也可以试试下面的加速下载。

路由器 加速下载v0.47.156,2 个文件

文件清单取自官方发布页,版本 v0.47.156,发布于 2026 年 8 月 10 日。加速线路是第三方公益镜像,转发的是官方发布页上的同一份文件,镜像随时可能失效。下载后请到官方发布页核对文件大小,有校验值的核对 SHA256。不知道选哪个文件,看下面对应系统的教程第一步。

许可证
MIT

「最新官方版本下载」只通向官方发布页或官方商店,请在发布页选择与你系统对应的文件,有校验值的核对 SHA256。本站不托管任何安装包。

OpenClash 的 README 头一句就把自己说清楚了,本插件是一个可运行在 OpenWrt 上的 Mihomo(Clash) 客户端。作者是 vernesong,仓库建于 2019 年 5 月,许可证 MIT。README 的致谢里写着代码基于 frainzy1477 的 Luci For Clash,控制面板用的是 zashboard 和 yacd。

它装在路由器上。操作全在 OpenWrt 后台的网页里完成,内核是 mihomo,机场给的 Clash 订阅贴进去就能用,家里的手机、电视、游戏机都不用再各装一个客户端。README 写明兼容 Shadowsocks、ShadowsocksR、Vmess、Trojan、Snell 等协议,还带一个流媒体解锁检测。

版本和安装包

本站 2026 年 9 月 18 日核对发布页,最新版是 8 月 10 日的 v0.47.156,7 月里发过两版,仓库 9 月 16 日还有提交。发布页同时放 ipk 和 apk,对应 OpenWrt 新旧两套包管理器。依赖不少。README 列了 dnsmasq-full、bash、curl、ruby、ruby-yaml 等一长串,开 TUN 模式还要 kmod-tun,装之前对照一遍。

节点是 VLESS 这类 V2Ray 系协议、想自己在插件里配规则的话看 PassWall2。固件装不了 LuCI 插件、只有 SSH 的设备用 ShellCrash,其余选择在路由器客户端对比里。

适合

  • 路由器刷了 OpenWrt,想让全家设备一起走代理的人
  • 机场提供 Clash 订阅,想沿用订阅里自带分流规则的人
  • 电视、游戏机这类装不了客户端的设备需要代理的人

要注意

  • 依赖多,README 列了 dnsmasq-full、ruby、ruby-yaml 等二十来项,缺了会装不上或启动失败
  • 只能装在 OpenWrt 系固件上,普通路由器的原厂系统用不了
  • ipk 和 apk 对应不同的包管理器,下载前先确认固件用的是哪一种
  • 路由器上出了问题全家断网,建议先在电脑上用客户端把订阅跑通再上路由器

OpenClash 路由器使用教程

截图版本 v0.46.001-beta · OpenWrt 23.05

OpenClash 装在 OpenWrt 路由器的网页后台 LuCI 里,内核是 mihomo。装插件、导入机场订阅、启动服务、选代理模式、进控制面板切节点,一共五步,全在浏览器里完成。选安装包前先确认路由器的包管理器是 opkg 还是 apk。截图读到的插件版本是 v0.46.001-beta,固件是 OpenWrt 23.05。

开始前准备

  • 路由器已刷好 OpenWrt 固件,能用浏览器打开 LuCI 后台
  • 机场提供 Clash 订阅链接,能登录用户中心复制,没选好机场可以先看机场榜单
  • SSH 连上路由器,执行一次 opkg --versionapk --version,确认用哪种包管理器
  • 路由器接好外网,装插件时要联网下载依赖
  1. 从官方渠道下载并安装

    到 OpenClash 的 GitHub 仓库 Releases 页下载安装包。SSH 执行 opkg --version 有输出选 ipk,比如 luci-app-openclash_0.47.156_all.ipk,执行 apk --version 有输出就选对应的 apk 包。装之前照 README 把 dnsmasq-full、bash、curl、ruby、ruby-yaml 等依赖装齐,缺了会装不上或启动失败。开 Tun 模式还要 kmod-tun。装完在 LuCI 左侧的服务菜单里能看到 OpenClash 一项。

  2. 打开服务下的 OpenClash

    在 LuCI 左侧点服务,展开后能看到 OpenClash。打开就是运行状态页,显示插件版本、运行模式(Redir-Host、兼容、TUN、混合四选一,截图选的是兼容)、主程序和守护程序是否运行中。下面三个按钮能跳到不同风格的控制面板。

    OpenClash 运行状态页,显示版本号和运行状态表格,下方是三个控制面板入口按钮
  3. 到机场后台复制订阅链接

    登录机场的用户中心,找到一键订阅或类似入口点开,弹出的菜单里第一项是复制订阅地址,点一下链接就进了剪贴板。各家机场面板长得不一样,认准订阅或一键导入字样的按钮。

    机场用户中心弹出订阅菜单,复制订阅地址一项被红框标出
  4. 在便捷导入区复制订阅

    机场用户中心往往还有一个便捷导入区块,按客户端类型分了好几个按钮。OpenClash 认 Clash 格式,点复制 CFW / ClashX 订阅这一个,同样能拿到订阅链接。

    机场用户中心的便捷导入区块,复制 CFW / ClashX 订阅等多个格式按钮并排列出
  5. 点配置订阅再点添加

    回到 LuCI 里的 OpenClash 页面,点顶部标签栏的配置订阅。页面还没有任何配置时中间写着尚无任何配置,点左下角蓝色的添加按钮,会弹出新增订阅的表单。

    OpenClash 配置订阅页为空,配置订阅标签和添加按钮被红框标出
  6. 填订阅信息并保存

    配置文件名随便填一个方便识别的名字,订阅地址粘贴刚才复制的机场订阅链接,User-Agent 保持默认的 Clash 不用改。下面的筛选节点、排除节点留空即可,填完点保存配置。

    新增订阅表单,配置文件名和订阅地址两个输入框及保存配置按钮被红框标出
  7. 启动 OpenClash 开始代理

    保存后回到运行状态页,订阅列表里能看到这份配置的流量、到期时间和语法检查结果,检查通过就说明配置没写错。下面的 IP 地址和网站访问检查用来确认出口线路是否正常。确认没问题,点最下面的启动 OpenClash 按钮,路由器上的设备就开始走代理。

    运行状态页显示订阅信息和网站访问检查结果,启动 OpenClash 按钮被红框标出
  8. 选择代理模式

    运行状态页中间的代理模式一行有三个选项。Rule 按订阅自带的规则分流,Global 让所有流量都走同一个节点,Direct 不走代理直连。日常用 Rule,想临时测试某个节点能不能用,切到 Global 更直接。

    运行状态表格里代理模式一行,Rule Global Direct 三个选项被红框标出
  9. 打开控制面板选节点

    同一行下面有三个按钮,Yacd 控制面板、Metacubexd 控制面板、Dashboard 控制面板,是同一内核的三种不同网页前端。点任意一个都会跳到新页面,用来查看和切换节点,风格不同,选自己顺眼的一个就行。

    运行状态页三个控制面板入口按钮被红框标出,从左到右是 Yacd、Metacubexd、Dashboard
  10. 在策略组里切换节点

    控制面板左侧点代理,右边列出订阅自带的策略组,国外流量、Netflix、Steam 这些分类各是一组,每组展开是一串节点。点组名下的某个节点就切过去,选中的会高亮。想让某类网站换个节点,就在对应的组里重新点一个。

    控制面板策略组页面列出多个分类和香港节点列表,代理入口和节点按钮被红框标出

路由器 上常见的问题

插件装上了但启动失败,或者状态一直是红的

多半是依赖没装全。OpenClash 依赖一长串软件包,dnsmasq-full、ruby、ruby-yaml 这些缺一个都可能起不来,尤其是固件自带的 dnsmasq 没替换成 dnsmasq-full 会直接冲突。回 SSH 里把 README 列的依赖逐个装一遍,再重启插件。

路由器能上外网,内网其他设备还是连不上

先看运行模式选没选对。OpenClash 默认用 Redir-Host,靠劫持 DNS 和重定向流量分流,路由器上如果还开着别的防火墙规则,容易互相打架。可以试试切换成兼容模式或者 TUN 模式,两种别混用,容易冲突。

运行状态页一直提示转发规则顺序错误

这是守护程序自检出来的提示,说明防火墙规则被别的插件或手动改动打乱了顺序。到插件设置里重新生成一次防火墙规则,或者重启一次 OpenClash 服务,多数时候能自己修好。

点了控制面板按钮,页面打不开或者一直转圈

先看运行状态页的主程序是不是显示运行中,没运行面板肯定打不开。面板默认走 9090 端口,如果路由器上别的服务占了这个端口,或者防火墙没放行,也会连不上。可以在插件设置里改端口,改完重启一次服务再试。

装的时候提示架构不匹配,或者装完找不到插件

ipk 和 apk 分别对应固件的两套包管理器,选错了要么装不上要么装上也用不了。SSH 里执行 opkg --version 或 apk --version,哪个有输出就用哪种包。装完在服务菜单里刷新一下页面,OpenClash 才会出现在列表里。

OpenClash 常见问题

OpenClash 用的是什么内核

用的是 mihomo 内核。README 的原话是可运行在 OpenWrt 上的 Mihomo(Clash) 客户端,许可说明里也写着内核来自 MetaCubeX 的 Mihomo。所以机场给的 Clash 订阅可以直接用,订阅里的节点和分流规则会一并带过来。

OpenClash 下载 ipk 还是 apk

先看固件。在路由器的 SSH 里执行 opkg --version,有输出就下 luci-app-openclash_0.47.156_all.ipk 这一类,执行 apk --version 有输出就下 apk。这里的 apk 是 OpenWrt 新包管理器的格式,和安卓安装包只是同名。

OpenClash 和 PassWall2 怎么选

先看机场给什么订阅。OpenClash 读 Clash 订阅,内核是 mihomo,分流规则通常直接用订阅里自带的。PassWall2 调用 Xray 或 sing-box,导入的是节点订阅,规则在插件里自己设。两个都开源免费,都在持续更新。两个插件同时装会不会互相冲突,本站没有测过。

OpenClash 还在更新吗

还在更新。本站 2026 年 9 月 18 日核对时,最新版 v0.47.156 发布于 8 月 10 日,7 月 7 日和 18 日各发过一版,仓库 9 月 16 日还有新提交。仓库从 2019 年 5 月建立至今,一直在 vernesong 名下。

保存订阅后要多久才能用

点保存配置不会立刻连上,要回到运行状态页确认语法检查显示检查通过,再点启动 OpenClash,服务重启之后才会真正生效,第一次启动可能要等几秒到十几秒。

机场更新了节点,要重新填一遍订阅吗

不用重新填地址。回到运行状态页,订阅那一行的更新时间旁边有个圆形箭头图标,点一下就能重新拉取这条订阅的最新节点。

OpenClash 的分流规则是自己写还是跟着订阅走

默认跟着订阅走,机场配置文件里已经写好了分流规则,导入后直接生效。想自己加规则,插件里有规则附加这个标签页,能在订阅规则前面插入自定义条目,一般用户用默认的就够。