OpenClash教程：ipk下载安装、内核与订阅配置，没安卓版

30 秒结论：OpenClash 是 OpenWrt 路由器上的 Clash 插件（包名 luci-app-openclash），作者 vernesong，免费开源，最新 0.48.002（2026-10-12）。四件事先说清：它只能装在路由器上，没有安卓版和 Windows 版；官网就是 GitHub，openclash.org 是第三方站；OpenWrt 24.10 及以前装 ipk，25.12 起装 apk；装完还要单独下载内核，导入的必须是 Clash 订阅。GitHub 打不开的话，下面镜像了全部安装包和内核。

OpenClash 是什么

OpenClash 是一个 LuCI 插件——装好后会出现在路由器网页后台的「服务」菜单里。它在路由器上运行 Mihomo（原 Clash Meta）内核，把局域网里所有设备的流量按规则分流：国内网站直连，国外网站走机场节点。

适合谁：家里有软路由（x86 小主机、R2S、R4S 这类）或刷了 OpenWrt 的路由器，想让电视、游戏机、所有手机一起翻墙、不想每台设备装客户端的人。

不适合谁：用的是运营商光猫、小米/华为原厂路由器、没刷过机的——这些装不了 OpenClash，直接在手机和电脑上装客户端更省事。作者在使用手册里还提醒：不推荐第三方魔改的「高大全」固件，也强烈建议主路由部署，旁路由组网有先天缺陷。

OpenClash 官网是哪个？

OpenClash 没有独立官网，官方就是 GitHub 仓库 vernesong/OpenClash：

• 安装包：仓库的 Releases 页面
• 内核：仓库的 core 分支，不在 Releases 里
• 使用手册：仓库里 .github/skills/openclash-user-guide/ 目录，中文，按功能分了 18 篇
• 交流群：README 里给的 Telegram 群 @openclash_group

搜「OpenClash 官网」排前面的 openclash.org 是第三方教程站，页面里有「节点分享」「机场推荐」栏目，下载按钮指向它自己的存档页。clash.top 这类站同理。都不是作者的，安装包请认准 GitHub 或者下面本站的镜像。

OpenClash 下载（ipk / apk）

0.48.002 只有两个安装包，不分 CPU 架构（文件名里的 all），只看固件用哪种包管理器：

分不清用哪个：SSH 登录路由器输入 opkg --version，能出版本号就下 ipk；提示找不到命令、而 apk --version 有输出的，下 apk。OpenWrt 官方从 25.12 起把软件包从 ipk 换成了 apk，下载站 25.12.5 的软件源里已经全是 .apk。

这里的 apk 是 OpenWrt 的软件包格式，和安卓手机的 apk 同名不同物，手机装不了。

OpenClash 安装教程

方法一：网页上传（适合新手）

1. 先装依赖（见下一节），否则装完启动不了
2. 电脑上下载对应的 ipk 或 apk
3. 登录路由器后台，进 「系统」→「软件包」，点「上传软件包」选择文件，安装
4. 刷新页面或重新登录，「服务」→「OpenClash」 出现就说明装好了

方法二：命令行（README 原版）

SSH 登录路由器，按防火墙类型选一组。OpenWrt 22.03 起默认是 nftables（fw4），更早的是 iptables（fw3）。

nftables（fw4），opkg 系统：

opkg update
opkg install bash dnsmasq-full curl ca-bundle ip-full ruby ruby-yaml kmod-tun kmod-inet-diag unzip kmod-nft-tproxy luci-compat luci luci-base

nftables（fw4），apk 系统：

apk update
apk add bash dnsmasq-full curl ca-bundle ip-full ruby ruby-yaml kmod-tun kmod-inet-diag unzip kmod-nft-tproxy luci-compat luci luci-base

iptables（fw3），opkg 系统：

opkg update
opkg install bash iptables dnsmasq-full curl ca-bundle ipset ip-full iptables-mod-tproxy iptables-mod-extra ruby ruby-yaml kmod-tun kmod-inet-diag unzip luci-compat luci luci-base

依赖装完，把下载好的安装包传到路由器 /tmp/，再执行 opkg install /tmp/luci-app-openclash_0.48.002_all.ipk，或者 apk 系统执行 apk add --allow-untrusted /tmp/luci-app-openclash-0.48.002.apk。README 里还有一段自动拉取最新版的命令，前提是路由器本身能访问 GitHub。

依赖装不上的常见原因

• dnsmasq 冲突：OpenWrt 自带的是精简版 dnsmasq，OpenClash 必须用 dnsmasq-full。先 opkg remove dnsmasq 再装 full 版，卸载后到装上之前局域网会暂时没有 DNS，最好接着网线操作
• 软件源连不上：国内访问 OpenWrt 官方源慢，可以把「系统」→「软件包」→「配置 opkg」里的地址换成国内镜像（清华、中科大等）
• 空间不够：Ruby 和内核加起来要几十 MB，16MB 闪存的老路由器装不下，插件设置里有个「小闪存模式」，但根本办法是换设备

OpenClash 安装后应该做什么？

装好插件只是第一步，到能用为止还有三件事：

1. 下载内核——插件里不带内核，见下一节
2. 导入订阅——见「配置文件订阅」一节
3. 选运行模式并启动——见「设置」一节，新手照抄推荐值就行

三步做完，回 「运行状态」 点 「启动 OpenClash」，再用手机打开一个国外网站试试。

OpenClash 内核下载

OpenClash 插件本身不带内核，作者在 README 里写着「首次使用需要下载内核」。内核有两种：

• Meta 内核：就是 Mihomo，默认用这个
• Smart 内核：作者 vernesong 自己维护的 Mihomo 分支，多了上游没有的「Smart」策略组，用 LightGBM 模型给节点打分、自动选节点，相关参数在「覆写设置」→「Smart 设置」。在「插件设置」→「版本更新」里把「Smart 内核」改成启用才会下这个

在线下载（推荐）

「插件设置」→「版本更新」：

1. 看「处理器架构」，确认「编译版本」对得上（安装时会自动填，x86 软路由一般是 linux-amd64-v1，ARM 软路由是 linux-arm64）
2. 「更新分支」保持 master（稳定版），dev 是开发版
3. 下面的 CDN 列表会自动测速，点一个延迟低的行，插件和内核会一起更新到最新

下载后脚本会用官方 checksums.txt 校验 SHA256，对不上会中止更新，不用担心下到坏文件。

路由器连不上 GitHub 时：手动上传

在电脑上下载对应架构的内核压缩包，进 「配置管理」 页的上传区，文件类型选 内核文件，上传 .tar.gz 会自动解压。下面是 master 分支（稳定版）的内核，同步于 2026-10-15，版本 alpha-gbc76c13（Meta）/ alpha-smart-gdaf3ad0（Smart）：

官方原件在 GitHub 仓库 core 分支的 master/meta 和 master/smart 两个目录。拿不准架构：SSH 输入 uname -m，x86_64 选 amd64，aarch64 选 arm64，armv7l 选 armv7，mips 开头的看下面完整列表里的 mips 系列。

OpenClash 配置文件订阅

OpenClash 只认 Clash 的 YAML 配置。机场后台复制订阅时选「Clash」或「Clash Meta」那一条。

导入机场订阅

1. 「服务」→「OpenClash」→「配置订阅」，点 「添加」
2. 配置文件名：随便起，别和已有的重名
3. 订阅地址：粘贴机场的 Clash 订阅链接
4. User-Agent：默认就行；有的机场要求改 UA（下拉里有 clash-verge、clash.meta、clash 三个预设），按机场使用文档选
5. 保存，点 「更新配置」
6. 到 「配置管理」 确认这份配置是当前启用的（新下载的会自动设为启用）

想定时更新：「配置订阅」页上方打开「自动更新」，可以选每周几几点，也可以每隔 N 分钟。

机场只给 V2Ray / SS 订阅怎么办

在订阅条目里打开 「在线订阅转换」，填一个转换后端，OpenClash 会把订阅转成 Clash 配置再用。注意：

• 转换后端能看到你的订阅链接，用机场自己提供的或者自建的更放心
• 转换完启动后节点列表是空的，官方手册给的解法是打开转换选项里的 skip-cert-verify（跳过证书校验） 再更新一次

只要部分节点：关键字筛选

订阅条目里有「筛选节点」和「排除节点」两栏，按节点名匹配：香港|台湾 表示包含香港或台湾，香港&01 表示同时包含香港和 01。机场节点太多、路由器性能一般的，留几个常用地区就够了。

直接上传配置文件

有现成的 .yaml 配置文件，在 「配置管理」 页上传，类型选配置文件，上传后会自动设为当前配置。页面上还能在线编辑、切换、复制、下载配置。

OpenClash 设置（新手推荐值）

「插件设置」→「模式设置」：

「插件设置」→「流量控制」：「实验性：绕过指定区域 IP」选「绕过中国大陆」。官方手册原话是「强烈推荐启用」——国内 IP 的流量不进内核，路由器负担小很多。

几种运行模式怎么选：

• Fake-IP：日常首选
• 兼容模式（Redir-Host）：DNS 在设备上解析，按 IP 分流，跑 BT/PT 下载的用这个
• TUN / 混合：建虚拟网卡接管所有流量，需要 kmod-tun；混合模式（TCP 走 redirect、UDP 走 TUN）适合对 NAT 类型有要求的联机游戏

改完设置记得点页面底部的「保存配置」和「应用配置」。

OpenClash 指定 IP 不走代理

分两种情况。

局域网里某台设备不走代理

比如 NAS、下载机、公司电脑不想翻墙：

1. 「插件设置」→「黑白名单」
2. 「局域网访问控制模式」选 黑名单模式
3. 把设备 IP 填进 「不走代理的局域网设备 IP」（可以写单个 IP，也可以写网段如 192.168.1.0/24），或者把 MAC 地址填进 「不走代理的局域网设备 Mac」
4. 保存并应用

反过来，只想让少数几台设备走代理，就选「白名单模式」，把它们填进「走代理的局域网设备 IP」。IP 列表要在兼容（Redir-Host）系列模式下生效；只按 MAC 填没有这个限制，用 Fake-IP 模式的优先填 MAC，还不怕设备 IP 变。

建议在路由器 DHCP 里给这台设备绑定固定 IP，否则 IP 一变规则就失效。

访问某个外部 IP 不走代理

把目标 IP 填进黑白名单页的 「不走代理的 WAN IP」，端口则填「不走代理的 WAN 端口」。

Fake-IP 模式下这一栏只对直接访问 IP 的请求有效。要让某个域名直连，有两种做法：一是在「覆写设置」的 DNS 里把它加进 fake-ip-filter；二是在配置里加一条规则，比如 DOMAIN-SUFFIX,example.com,DIRECT。官方手册举的例子：UU、雷神这类游戏加速器在 Fake-IP 下会失效，就是把 +.leigod.com 这类域名加进 fake-ip-filter，或者把装加速器的设备 IP 加进「不走代理的局域网设备 IP」。

OpenClash 支持哪些协议？

协议支持取决于 Mihomo 内核，插件本身不管。README 里列的是：

Shadowsocks、ShadowsocksR、VMess、VLESS、Trojan、Snell、TUIC、Hysteria

Mihomo 实际支持的更多，Hysteria2、WireGuard、AnyTLS、SSH 等也能用。机场换了新协议、导入后节点显示不出来或启动报错，先去「版本更新」把内核更新到最新，旧内核不认新协议是最常见的原因。

OpenClash 安卓版、Windows 版：没有

OpenClash 只能装在 OpenWrt 路由器上，作者没有出过手机和电脑版。搜「OpenClash 安卓」「OpenClash for windows 中文」出来的，要么是把名字搞混了，要么是第三方站蹭词：

• 「OpenClash for Windows 中文版」 实际指的是 Clash for Windows——一个 2023 年 11 月已经删库停更的电脑客户端，和 OpenClash 不是一个东西
• 安卓上没有 OpenClash，网上的「OpenClash apk」要么是 OpenWrt 软件包（手机装不了），要么是别的 Clash 客户端改名

手机和电脑要和路由器用同一份 Clash 订阅、同一个 Mihomo 内核，装这几个：

都有中文界面。详细教程见 Clash Meta、FlClash、Clash Verge Rev 三篇。

常见问题排查

• 启动失败：先去「运行日志」→「调试日志」生成日志，看「依赖检查」那段缺什么就装什么。官方手册把这一步放在所有排查的第一位
• Ruby Works Abnormally：重装 ruby、ruby-yaml
• Config File Tested Failed：订阅下回来的配置格式不对，多半是订阅链接复制成了非 Clash 格式，或订阅已过期
• Updated Config Has No Proxy Field：配置里没有节点，检查订阅是否到期、是否需要改 UA
• 更新内核报 Checksum Verification Failed：下载不完整，换一个 CDN 再点
• 国内网站打不开或变慢：确认「绕过中国大陆」已开；旁路由用户试试打开「旁路由兼容」
• iPhone 连旁路由很耗电：官方 issue #2614 里的建议是换 Fake-IP 模式，并让主路由 DHCP 下发的网关和 DNS 都指向旁路由

OpenClash 免费节点：没有

OpenClash 只是路由器上的工具，本身不带任何节点。openclash.org 这类第三方站的「节点分享」栏目，放的是公开节点和机场引流：多人共用速度慢、几小时就失效，节点主人还能看到经过的流量。路由器是全家设备的出口，接一个来路不明的免费节点，等于让全家流量过别人的服务器。

想稳定用，还是买一家机场，把 Clash 订阅填进「配置订阅」。

能用 OpenClash 的机场

下面两家本站写过，官方使用文档里专门写了 OpenClash：

• Mitce：2023 年起运营，按美元计价，月付 0.6 美元 100G 起，流量给得很足。帮助中心 docs.mitce.net 单独有一栏 OpenWrt，列了 OpenClash 和 Passwall2 两个插件的教程，这在机场里不多见。它主域 mitce.com 国内打不开，入口要看本站评测
• 大米机场 BigME：2023 年起运营，月付 6 元 45G 起。官方给路由器推荐的就是 OpenClash 和 Nikki，节点是 AnyTLS 协议，所以内核要更新到最新；拉订阅必须改 User-Agent，对应上面「导入机场订阅」第 4 步

两家买之前都先看完本站评测里写的入口和条款。

安装包校验（SHA256）

本站镜像文件从 GitHub 原样下载、未做修改，同步于 2026-10-15。两个安装包的 SHA256 与 GitHub Release 页面给出的一致；内核文件逐个比对了仓库 core 分支里官方 checksums.txt 的值，完整校验值见上面折叠列表里的两份 SHA256SUMS。

常见问题（FAQ）

官网与下载

OpenClash 官网和 GitHub 是哪个？

OpenClash 没有独立官网，官方就是 GitHub 仓库 vernesong/OpenClash，安装包在它的 Releases 页面，内核在仓库的 core 分支，使用手册也在仓库里。搜索结果里 openclash.org 这类自称官网的是第三方教程站，页面上还有节点分享和机场推荐。

OpenClash 下载 ipk 还是 apk？

看路由器固件用哪种包管理器。OpenWrt 24.10 及更早版本、大部分 ImmortalWrt 24.10 用 opkg，下 luci-app-openclash_0.48.002_all.ipk；OpenWrt 25.12 起换成了 apk，下 luci-app-openclash-0.48.002.apk。两个包都是 all 架构，不分 CPU。SSH 里输入 opkg --version 能出版本号就用 ipk。

OpenClash 内核怎么下载？

插件装好后进「插件设置」→「版本更新」，确认处理器架构和编译版本（x86 软路由一般是 linux-amd64-v1，ARM 软路由是 linux-arm64），选一个延迟低的 CDN 点击就会下载并校验内核。路由器连不上 GitHub 时，可以在电脑上下载对应的 clash-linux-架构.tar.gz，在「配置管理」页上传，选内核文件类型。

OpenClash 有安卓版和 Windows 版吗？

没有。OpenClash 只能装在 OpenWrt 路由器上。安卓手机用 Clash Meta for Android 或 FlClash，Windows 用 Clash Verge Rev，它们和 OpenClash 用的是同一个 Mihomo 内核，同一份 Clash 订阅都能导。搜到的「OpenClash for Windows 中文版」其实是已经停更的 Clash for Windows，不是 OpenClash。

配置与使用

OpenClash 配置文件订阅怎么导入？

进「服务」→「OpenClash」→「配置订阅」，点「添加」，配置文件名随便填，订阅地址粘贴机场的 Clash 订阅链接，保存后点「更新配置」。下载完成后到「配置管理」确认它是当前配置，再回「运行状态」启动。机场只给 V2Ray 订阅的，在订阅条目里开「在线订阅转换」。

OpenClash 怎么让指定 IP 不走代理？

局域网里某台设备不走代理：「插件设置」→「黑白名单」，局域网访问控制模式选黑名单模式，把设备 IP 填进「不走代理的局域网设备 IP」，或者把 MAC 填进「不走代理的局域网设备 Mac」。要让访问某个外部 IP 不走代理，填进「不走代理的 WAN IP」，Fake-IP 模式下只对直接访问 IP 的请求有效，域名要另加到 fake-ip-filter。

OpenClash 支持哪些协议？

协议由 Mihomo 内核决定。README 列的有 Shadowsocks、ShadowsocksR、VMess、VLESS、Trojan、Snell、TUIC、Hysteria，Mihomo 还支持 Hysteria2、WireGuard、AnyTLS 等。机场节点用新协议时，要把内核更新到最新版。

本文的版本号、下载地址、依赖与菜单名称核实于 2026-10-15（安装命令与依赖来自 GitHub vernesong/OpenClash 的 README，菜单名来自插件简体中文语言包 openclash.zh-cn.po，运行模式、黑白名单、订阅与内核更新的说明来自仓库内的官方使用手册，OpenWrt 25.12 改用 apk 包由本站查看 downloads.openwrt.org 软件源确认）。本站镜像文件从 GitHub 原样下载、未做修改。文中机场推荐可能含推广链接，通过链接购买不会增加你的费用，本站可能获得佣金，这不影响内容客观性。代理工具的使用请遵守所在地法律法规。