# OpenClash 安装与使用教程（OpenWrt 路由器）

规范地址 https://jichangboke.org/clients/openclash/
发布 2026-09-18，更新 2026-09-18
作者 塔台君，机场博客

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

## 官方来源与下载

- 维护状态 维护中
- 内核 Mihomo 内核
- 源码 开源
- 价格 免费
- 最新版本 v0.47.156，核对于 2026-09-18
- 许可证 MIT
- 官方仓库 https://github.com/vernesong/OpenClash
- 路由器 官方下载页 https://github.com/vernesong/OpenClash/releases

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

它装在路由器上。操作全在 OpenWrt 后台的网页里完成，内核是 [mihomo](/glossary/#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 模式](/glossary/#tun)还要 kmod-tun，装之前对照一遍。

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

## 适合

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

## 要注意

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

## OpenClash 路由器使用教程

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

开始前准备

- 路由器已刷好 OpenWrt 固件，能用浏览器打开 LuCI 后台
- 机场提供 Clash 订阅链接，能登录用户中心复制，没选好机场可以先看[机场榜单](/jichang-tuijian/)
- SSH 连上路由器，执行一次 `opkg --version` 或 `apk --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](/glossary/#tun)、混合四选一，截图选的是兼容）、主程序和守护程序是否运行中。下面三个按钮能跳到不同风格的控制面板。

### 第 3 步 到机场后台复制订阅链接

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

### 第 4 步 在便捷导入区复制订阅

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

### 第 5 步 点配置订阅再点添加

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

### 第 6 步 填订阅信息并保存

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

### 第 7 步 启动 OpenClash 开始代理

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

### 第 8 步 选择代理模式

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

### 第 9 步 打开控制面板选节点

同一行下面有三个按钮，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 用的是什么内核

用的是 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 名下。