openwrt-nekobox

发布日期: 2026-09-24更新日期: 2026-10-12平台: OpenWrt类别: 客户端下载配置

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 主题。

使用

  1. 在插件界面中选择内核。使用机场 Clash 订阅时选择 mihomo,并套用通用模板,只需填入订阅链接。
  2. 使用 sing-box 时可借助智能转换模板,把订阅转换为 sing-box 配置。
  3. 启动服务后,在面板中选择节点。

常见问题 (FAQ)

安装后 LuCI 打不开?

检查路由器是否使用了 Nginx,插件只兼容 uhttpd。

和 OpenClash 选哪个?

openwrt-nekobox 模板化程度高,适合家庭快速部署;OpenClash 功能更全、资料更多。