Nikki 路由器插件教程：OpenWrt 上稳妥用起来

Nikki 到底是什么

Nikki 是一个 OpenWrt 软件包集合，官方仓库简介只有一句话：在 OpenWrt 上用 Mihomo 实现透明代理。它自己并不实现任何代理协议，真正处理流量的是 Mihomo 内核，也就是很多人熟悉的 Clash Meta 的延续版本。Nikki 负责的是「把内核放进路由器、接上防火墙、给出网页管理界面」这部分工作。

所谓透明代理，指的是局域网里的设备不需要单独设置代理地址，流量经过路由器时就被接管并按规则分流。家里的电视、游戏机、平板只要连上这台路由器的网络，就能享受到同一套规则，这正是路由器插件存在的意义。

如果你已经读过站内的 Mihomo 内核介绍，可以把 Nikki 理解成 Mihomo 在 OpenWrt 上的一层「外壳」：内核的协议支持、规则语法、代理组概念都沿用 Mihomo，Nikki 额外解决的是 OpenWrt 环境下的启动管理、防火墙规则生成和配置界面问题。

名字的由来：从 luci-app-mihomo 到 Nikki

不少老用户在论坛或旧教程里看到的是 OpenWrt-mihomo、luci-app-mihomo 这样的名字。我们在官方仓库的提交记录里找到了改名的那次提交，时间是 2025 年 2 月 9 日，提交说明的大意是：因为上游许可证不允许在项目名称中使用 mihomo，所以改名为 nikki。同一次提交里，luci-app-mihomo 目录被整体改成 luci-app-nikki，后台程序包也从 mihomo 改成了 nikki。

另外，旧的仓库地址 morytyann/OpenWrt-mihomo 现在会自动跳转到 nikkinikki-org/OpenWrt-nikki，可以确认二者是同一个项目的延续，而不是两个互不相干的插件。如果你手里的教程还在用旧名字，菜单项、配置文件名都可能对不上，遇到这种情况以新版官方 Wiki 为准。

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

本节只记录在官方 GitHub 仓库、Releases 页面以及 GitHub 接口上直接看到的内容，搜索结果摘要里出现的版本号一律不采用。

项目	核对结果
官方仓库	https://github.com/nikkinikki-org/OpenWrt-nikki
官方发布页	https://github.com/nikkinikki-org/OpenWrt-nikki/releases
使用说明	https://github.com/nikkinikki-org/OpenWrt-nikki/wiki
最新正式版	v1.26.2（非预发布）
发布日期	2026-10-10
固件要求	OpenWrt 24.10 及以上，Linux 内核 5.13 及以上，firewall4
发布包覆盖	按 OpenWrt 24.10、25.12 和 SNAPSHOT 分别打包，涵盖 aarch64、arm、mips、mipsel、i386、loongarch64 等多种架构
包管理器	README 同时给出 opkg 与 apk 两种安装方式
许可证	GPL-3.0
是否归档	否，仓库在 2026 年 10 月仍有提交
最低内存与闪存	官方页面没有给出明确数字，未能核实

v1.26.2 的更新说明里还提到一项随包更新：mihomo-meta 内核升级到 v1.19.32。也就是说，Nikki 发布包里会附带特定版本的 Mihomo 内核构建，插件版本号和内核版本号是两套编号，不要混为一谈。

官方列出的功能

README 的功能清单不长，但每一项都和路由器场景直接相关：

• 透明代理：支持 Redirect、TPROXY、TUN 三种接管方式，IPv4、IPv6 可以单独或同时启用。
• 访问控制：可以决定局域网里哪些设备走代理、哪些设备不受影响。
• 配置混入（Mixin）：在订阅下来的配置之上叠加一层本地设置，订阅更新后本地改动不会被冲掉。
• 配置编辑器：在网页里直接查看和修改配置文件。
• 定时重启：按计划重启服务，适合长期运行的路由器。

README 还简单描述了工作流程：先混入并更新配置，再启动 Mihomo，设置定时重启，然后配置路由规则，最后生成并应用 nftables 规则。官方也提醒，这些步骤会因配置不同而变化。理解这个顺序有助于排查问题，比如服务能启动但流量没被接管，往往是最后防火墙那一步没生效。

Nikki 插件安装前先备份，再动手

在路由器上装透明代理插件，和在电脑上装个软件不是一个风险级别。Nikki 会改动防火墙规则和路由策略，一旦配置不当，轻则全家所有设备上不了网，重则因为依赖冲突或闪存写满导致系统启动异常，需要进恢复模式处理。请在动手前把下面几件事做完：

1. 导出系统备份。在 LuCI 后台的系统维护类页面里，通常能找到生成配置备份的入口，把备份文件存到电脑上。不同固件与版本名称略有差异，找不到时以所用固件的文档为准。
2. 确认固件与内核版本。在系统状态概览里看清 OpenWrt 版本和内核版本，低于官方要求就不要硬装。
3. 确认防火墙类型。Nikki 依赖 firewall4，也就是基于 nftables 的防火墙；仍使用旧式 iptables 防火墙的固件不在支持范围内。
4. 留一条退路。准备好手机热点，并提前查好你这台路由器的恢复或救砖方式，出现无法进后台的情况时不至于手足无措。
5. 用网线操作。安装和首次启动期间网络可能短暂中断，通过 Wi-Fi 远程操作容易在中途失联。

安装途径（通用说法）

官方 README 给出两条安装途径：一是添加 Nikki 的软件源后，通过包管理器安装主程序、LuCI 界面和中文语言包；二是使用官方提供的安装脚本，从 Releases 拉取对应版本。较新的 OpenWrt 已经改用 apk 包管理器，较早的版本仍是 opkg，官方对两者都给出了说明。

本文不复述具体命令和参数，原因很简单：命令会随版本调整，照抄旧命令反而容易出错。请直接打开官方 README 和 Wiki，按你固件使用的包管理器选择对应写法。官方发布包是按 OpenWrt 大版本和 CPU 架构分开打包的，下载前务必确认这两项与你的设备一致，装错架构的包轻则装不上，重则留下残缺的依赖。

下载来源方面，只用官方仓库和官方软件源。网上流传的整合固件、二次打包的插件可能版本陈旧，也可能被改动过，判断方法可以看 下载安全指南。

Nikki 插件导入机场订阅

装好之后，刷新 LuCI 页面，在「服务」一类的菜单里应能看到 Nikki 的入口。不同固件与版本名称略有差异，有的固件会把它放在其他分类下。

Nikki 使用的是 Mihomo 的 YAML 配置，所以机场后台提供的 Clash 或 Mihomo 格式订阅最对路。一般流程是在配置或订阅相关页面新增一条订阅，填入机场给出的订阅地址，保存后让插件拉取配置，再选中这份配置并启动服务。订阅链接相当于你的账号凭证，向别人求助时不要把完整链接贴出来，原理可以看 订阅链接是什么。

Mixin 是 Nikki 比较有特色的一点。机场订阅里的 DNS、监听端口等设置未必适合你的路由器，如果直接改订阅文件，下次更新又会被覆盖。通过 Mixin 把这些本地设置单独保存，再叠加到订阅之上，就能做到订阅随便更新、本地设置保持不变。刚开始用时建议少动 Mixin，先用默认值跑通，再逐项调整。

Nikki 插件出了问题怎么排查

启动后全家断网。 先在界面里停止 Nikki 服务，观察网络是否恢复。恢复了，说明问题在插件配置；没恢复，检查是否在安装过程中改动了系统网络或防火墙设置，必要时用安装前的备份还原。

服务显示运行，但设备没被代理。 回想 README 描述的流程，流量接管依赖最后一步生成的防火墙规则。检查访问控制是否把设备排除在外，以及所选的透明代理方式是否与固件环境匹配，例如 TUN 方式需要相应的内核模块。

订阅拉取失败。 路由器本身要能访问订阅地址才能下载配置。订阅过期、域名被拦截、请求被机场限制都可能导致失败，先在机场后台确认订阅仍然有效。

节点连不上。 查看订阅里的节点协议是否在 Mihomo 支持范围内，不同协议的区别可以参考 协议科普。

官方 Wiki 是排查时最该先翻的地方，仓库里还提供了卸载与重置脚本，配置彻底混乱时可以考虑清理后重装，但请先留好备份。

和其他路由器方案的关系

站内收录了多款路由器插件，选择时可以按固件和习惯来分：

• 想用 Mihomo 内核、固件也比较老，可以看 OpenClash，它兼容的固件范围更宽。
• 习惯 Xray 或 sing-box 内核，可以看 PassWall 与 PassWall2。
• 偏好 sing-box，用的是 ImmortalWrt 一类固件，可以看 HomeProxy。
• 设备不是标准 OpenWrt，或者想用脚本方式管理，可以看 ShellCrash。

如果家里只有少量设备需要代理，在设备上直接装客户端往往更省心，具体思路见 家庭设备怎么用订阅。更多客户端可以在 客户端总览 里比较。

小结

Nikki 适合已经升级到较新 OpenWrt、使用 nftables 防火墙、希望在路由器上直接使用 Clash 格式订阅的用户。它由旧名 luci-app-mihomo 改名而来，目前仍在持续更新。本页信息核对于 2026 年 10 月 21 日，动手前请再看一眼官方发布页，确认版本与安装说明；先备份、再安装、出问题先停服务，这三条比任何技巧都重要。