openwrt-nekobox(luci-app-nekobox)是一款面向家庭用户的 OpenWrt 代理插件,支持 mihomo 和 sing-box 两种内核。它使用 PHP 和 Bash 实现,提供直观的网页界面,并内置“通用模板”和“智能转换模板”,目标是让不懂配置的家庭成员也能用起来。
请注意它与安卓上的 NekoBox 客户端只是名字相似,并不是同一个项目。
| 软件包 | luci-app-nekobox |
|---|---|
| 内核 | mihomo、sing-box |
| 实现 | PHP + Bash |
| Web 服务器 | 仅支持 uhttpd,不支持 Nginx |
本文只讲软件本身,不推荐具体服务商。客户端只是工具,节点需要另外订阅;如果还没有订阅,可以先看 性价比机场挑选与防坑指南。
官方项目地址:https://github.com/Thaolga/openwrt-nekobox
依赖与限制
需要 php8、php8-cgi、php8-mod-curl、php8-mod-intl、zoneinfo-asia、coreutils-base64 等组件。使用 sing-box 时需要 firewall4 + nftables 和 kmod-tun。
重要限制:插件默认使用 uhttpd 作为网页服务器,如果您的路由器使用 Nginx,请不要安装此插件。
安装
项目提供了一键安装脚本,通过 SSH 登录路由器后执行 README 中的命令即可下载并运行 nekobox.sh,按菜单提示安装插件和内核。也可以把源码放入 OpenWrt 的 package 目录自行编译。项目还提供配套的 luci-theme-spectra 主题。
使用
- 在插件界面中选择内核。使用机场 Clash 订阅时选择 mihomo,并套用通用模板,只需填入订阅链接。
- 使用 sing-box 时可借助智能转换模板,把订阅转换为 sing-box 配置。
- 启动服务后,在面板中选择节点。
常见问题 (FAQ)
安装后 LuCI 打不开?
检查路由器是否使用了 Nginx,插件只兼容 uhttpd。
和 OpenClash 选哪个?
openwrt-nekobox 模板化程度高,适合家庭快速部署;OpenClash 功能更全、资料更多。