momo 插件怎么用？OpenWrt 的 sing-box 透明代理

momo 的定位

momo 是 nikkinikki-org 组织维护的 OpenWrt 插件，仓库名叫 OpenWrt-momo。官方仓库只用了一句话来描述它：在 OpenWrt 上用 sing-box 做透明代理。这句话把它的边界说得很清楚，一是运行环境限定在 OpenWrt 路由器，二是代理内核固定为 sing-box，三是工作方式是透明代理，也就是让局域网里的设备不必逐台设置代理，流量在路由器层面就被接管。

它不是一个独立的代理程序。真正处理协议、加密和转发的是 sing-box，momo 负责的是把 sing-box 运行起来，再根据配置去生成路由规则和防火墙规则。理解这一层关系，有助于你在出问题时判断该去哪里找原因：节点连不上通常要看 sing-box 的配置和日志，局域网设备不走代理则更可能是防火墙或访问控制设置的问题。

核对信息表

下表内容来自官方仓库 README、Releases 页面以及 GitHub API。没有在官方渠道看到的信息写作「未能核实」。

字段	核对结果	来源
官方仓库	nikkinikki-org/OpenWrt-momo	https://github.com/nikkinikki-org/OpenWrt-momo
最新版本	v1.2.2	GitHub API /releases/latest
发布日期	2026-10-14（UTC）	GitHub API published_at
仓库创建	2025-08-09	GitHub API created_at
平台	OpenWrt；发布资产按架构分别提供 openwrt-24.10、openwrt-25.12 与 SNAPSHOT 三类包，覆盖 aarch64、arm、i386、loongarch64、mips64 等架构	Releases 资产列表
固件要求	OpenWrt 24.10 及以上，Linux 内核 5.13 及以上，firewall4	README Prerequisites
内核	sing-box，依赖列表要求版本不低于 1.12	README Dependencies
透明代理方式	Redirect、TPROXY、TUN，支持 IPv4 和 IPv6	README Feature
许可证	GPL-3.0	GitHub API license 字段
是否归档	否（archived 为 false）	GitHub API
价格	未能核实（官方页面没有标注）	—
中文界面	官方安装说明中列有简体中文语言包	README Install

架构列表较长，上表只列出几个代表。具体到你的路由器应该下载哪一个包，请在 Releases 页面按你设备的 CPU 架构与固件版本逐一比对，选错架构的包要么装不上，要么装上后无法运行。

官方列出的功能

README 中的功能清单不长，只有四项：

• 透明代理，支持 Redirect、TPROXY、TUN 三种方式，可以只代理 IPv4、只代理 IPv6，或者两者都代理。
• 访问控制，用于决定局域网里哪些设备、哪些流量交给代理处理。
• 配置文件编辑器，可以在后台直接修改 sing-box 的配置。
• 定时重启。

README 还用五个步骤概括了它的工作过程：先运行 sing-box，设置定时重启，从配置文件中取得必要参数，设置 ip rule 与路由，最后生成防火墙规则并应用。官方特意补充说明，这些步骤会因配置不同而变化。这段描述对排障很有用，因为每一步都对应一个可能出错的环节。

和站内其他 sing-box 插件的区别

在 OpenWrt 上用 sing-box 的方案不止一个，站内已有 HomeProxy 页面，PassWall 系列也能调用 sing-box。momo 的特点是结构轻、功能聚焦：它不打算做成一个「什么都管」的大型插件，而是把重心放在透明代理与配置文件本身。如果你已经有一份写好的 sing-box 配置，并且希望路由器尽量原样运行它，momo 的思路比较贴合；如果你更希望插件替你管理节点列表、规则集和订阅更新，可能需要比较一下 HomeProxy 或 PassWall2 的界面是否更合适。

同一组织的 Nikki 则是另一条路线，它面向 Mihomo 内核，与 Clash 系配置更接近。很多人分不清这两个名字，其实区分方法很简单：手里的配置是 sing-box 的 JSON，就看 momo；是 Clash 或 Mihomo 的 YAML，就看 Nikki 或 OpenClash。

momo 插件安装之前先做这几件事

官方 README 给出了两种安装途径。一种是推荐的软件源方式，先运行官方提供的脚本添加软件源，再通过包管理器安装主程序、LuCI 界面和中文语言包；另一种是直接从 Releases 安装。由于新版 OpenWrt 的包管理器发生了变化，README 分别列出了两种包管理器下的命令。本页不转述具体命令，请以官方 README 原文为准，以免版本更新后出现偏差。

在执行任何安装步骤之前，建议先完成下面的准备：

1. 在系统菜单中导出完整的配置备份，并复制到电脑或其他存储里。不同固件中这个功能所在的菜单名称略有差异。
2. 核对固件版本、Linux 内核版本和防火墙类型，确认满足官方列出的三项前提。很多老旧或深度定制的固件不满足条件。
3. 确认软件源里能取得版本足够新的 sing-box。依赖要求不低于 1.12，旧固件的软件源可能只有更早的版本。
4. 准备一条有线连接。透明代理会改动路由和防火墙，一旦规则写错，可能出现全屋断网、后台无法打开、服务启动失败等情况，无线连接此时往往也会断开。

官方同样提供了卸载与重置脚本。它可以帮助你回到安装前的状态，但不能替代完整的系统备份。尤其是在你同时装有其他代理插件的情况下，多个插件争抢防火墙规则，可能让问题更难排查，建议同一时间只启用一个透明代理插件。

momo 插件的配置文件从哪里来

momo 运行的是 sing-box，因此它需要一份 sing-box 能读懂的配置。这一点直接决定了它和机场订阅的关系：sing-box 的配置是 JSON 结构，与 Clash 的 YAML 并不通用。本页没有在官方页面中核实到 momo 能直接解析 Clash 订阅或通用分享链接，所以请不要默认「把机场订阅地址粘进去就能用」。

比较稳妥的路径是：先确认你的服务商是否提供 sing-box 格式的配置，或者是否明确支持 sing-box 客户端。关于订阅链接到底返回什么内容，可以参考 订阅链接说明；关于不同协议在 sing-box 中的支持情况，可以参考 协议总览 和 sing-box 页面。官方的详细用法放在仓库 Wiki 里，README 的「How To Use」一节直接指向那里。

透明代理方式怎么选

Redirect、TPROXY、TUN 是三种把流量交给代理的手段，各有取舍。Redirect 方式历史最久，主要处理 TCP；TPROXY 可以同时处理 TCP 和 UDP，但需要相应的内核模块；TUN 是创建一个虚拟网卡，让流量从这个网卡进出。README 的依赖列表中同时出现了 TPROXY 与 TUN 相关的内核模块，说明这几种方式都在官方的考虑范围内。

本页不替你判断哪一种「更快」或「更稳」，因为这和设备性能、固件版本、配置写法都有关系。如果你想先弄清 TUN 这类模式的基本概念，可以读站内的 TUN 模式说明。

momo 插件出问题时按什么顺序排查

结合官方描述的五个工作步骤，可以把排障分成几层来看。第一层看 sing-box 是否真的在运行，如果服务启动后立即退出，多半是配置文件本身有错误，或者 sing-box 版本过旧，读不懂配置中的新字段。第二层看路由与防火墙规则是否生成，局域网设备完全不走代理时，常见原因是访问控制没有放行对应设备，或者防火墙类型不符合要求。第三层才是节点本身，连接超时、握手失败一类的问题，需要回到服务商的配置说明里核对。

每一层都尽量只改一个地方，改完记录下来。透明代理插件出错时，最怕的是同时改动多个设置，最后既不知道哪里修好了，也不知道哪里改坏了。

升级时的注意事项

momo 的仓库创建于 2025 年，更新较为频繁。频繁更新意味着新功能和修复来得快，也意味着配置项、依赖版本可能随时调整。升级之前，建议先阅读对应版本的发布说明，再导出一次当前配置；升级之后，确认 sing-box 的版本仍然满足依赖要求。如果升级后出现异常，可以先停用服务恢复上网，再对照发布说明逐项检查。

下载来源

官方 Releases 之外，网络上存在一些同步官方资产的镜像站。镜像本身不一定有问题，但你需要自己确认它与官方版本一致。最简单的方法是只从官方仓库的 Releases 或官方软件源获取，必要时核对文件名与版本号。更多判断方法见站内 下载安全指南。

适合谁

适合的人：路由器已运行 OpenWrt 24.10 或更新版本；已经习惯 sing-box 的配置方式，或者服务商能提供 sing-box 配置；希望插件尽量轻、配置尽量原样。

不太适合的人：固件版本较旧；手里只有 Clash 订阅；希望插件提供完整图形化节点管理。对后两种情况，可以先在 客户端总览 中比较其他路由器插件。

小结

momo 是一个仍在积极维护的 OpenWrt 插件，核对时最新版本为 v1.2.2，发布于 2026-10-14，许可证为 GPL-3.0，底层内核是 sing-box。它对固件、内核和防火墙都有明确的门槛。安装前请备份、确认架构与依赖版本，并做好透明代理规则可能导致断网的准备。