Appearance
openwrt-nekobox 快速配置与详细使用指南
openwrt-nekobox 是软路由 OpenWrt 生态中一颗极其耀眼的新星。随着 NekoBox / NekoRay 在桌面端代理圈子里大杀四方，这款以强大的 Xray (V2ray) 和 Sing-box 为核心的“猫咪盒子”也被开源大神们成功移植到了软路由平台上。
相较于传统的 OpenClash，openwrt-nekobox 以极低的资源占用、原生的跨协议解析能力（完美支持 VLESS-Reality、Hysteria2 等最新黑科技），成为了许多极致性能追求者的首选。一旦在您的家庭路由器上部署成功，全家所有设备（手机、智能电视、PS5/Xbox）都能享受到纵享丝滑的“透明代理”体验。
1. 软件下载与路由器安装准备
在 OpenWrt 路由器上部署插件需要进行一定的包管理操作。请确认您的路由器拥有足够的可用空间。
第一步：获取最新插件安装包
- 访问项目的官方 GitHub Release 页面。
- 下载对应您路由器芯片架构的
.ipk安装包或打包文件。 - 重要提醒：软路由玩家通常下载
x86_64架构版；如果是基于 ARM 芯片的硬路由或 N1 盒子，请务必认准aarch64或对应的arm架构版本。一旦下错，将无法在路由器上执行。
👉 点击前往 openwrt-nekobox 官方 Github 页面 (请以开源社区最新的发布地址为准)
第二步：上传与安装至路由器
- 电脑连接路由器的网络，在浏览器输入管理地址（如
192.168.1.1）登录 LuCI 网页后台。 - 依次点击左侧菜单的 系统 -> 软件包。
- 点击“上传文件”，选中您刚刚下载的
.ipk插件包并点击安装。 - 如果您是硬核极客，可以通过 SSH 登录路由，将包 SCP 至
/tmp目录，然后执行opkg install /tmp/luci-app-nekobox*.ipk。 - 安装完毕后，刷新路由器后台网页，在顶部的 “服务 (Services)” 菜单栏就能找到 NekoBox 的专属控制面板。
2. 获取机场订阅链接
路由器全天候挂机，对节点的稳定性要求极其苛刻。
- 登录您的机场服务商后台（如果您还在寻找极其稳定、适合家庭长期挂机的节点，欢迎查看本站为您整理的 👉 2026 优质稳定机场精选）。
- 在网站的用户控制面板中找到 “一键订阅” 区域。
- 点击 “复制 V2ray 订阅”、“复制 Sing-box 订阅” 或者 “复制 Clash 订阅”。得益于 Neko 强大的解析核心，这几类主流格式它全部都能吃下。
3. 导入节点与开启透明代理（图文流程）
在 LuCI 界面下配置 openwrt-nekobox，逻辑极其清晰：
步骤一：进入节点配置管理
在插件的主界面，找到 订阅 / 节点管理 (Subscriptions) 选项卡。这里用于配置远端机场。
步骤二：添加配置文件并更新
点击添加按钮，随意填入一个识别名称。将刚刚复制的机场订阅 URL 粘贴进地址栏。保存后，点击 “更新 (Update)”，等待插件从云端拉取上百条节点及分流规则。
步骤三：选择底层代理内核
回到 基本设置 (Basic Settings)。在核心引擎选择上，您可以根据喜好选择 Sing-box 或 Xray 内核。为了网络最大兼容，透明代理模式推荐使用默认的 Tproxy 模式。
步骤四：启动 NekoBox 服务
在基本设置页面的顶部，勾选 “启用 (Enable)” 选项，并点击页面最下方的“保存并应用”。等待数十秒，直到页面显示核心运行中，此时路由器的 iptables 已被接管，全家流量翻墙成功。
步骤五：进入 Web 网页控制台
在插件界面上点击 “打开面板 (Open Web UI)”。在独立的图形化面板中，您可以直观地测试所有节点的延迟，并手动指定走哪一条高速出海专线。
4. 进阶玩法：局域网设备控制与游戏加速
软路由最强悍的特性在于其精准的“上帝视角”分流能力。
- Mac 地址 / IP 白名单直连：如果您家里的某些国产智能家电（如智能音箱、扫地机器人）因为走了代理而连不上服务器，请进入 访问控制 (Access Control) 面板。把这些设备的 Mac 地址或 IP 加入“直连”列表，它们的流量将彻底绕过 NekoBox 内核，不再受影响。
- 主机游戏加速：如果您玩 PS5/Switch 联机游戏，请务必在插件设置中开启 UDP 流量转发 功能，同时在网页控制台中确保分流模式为“规则 (Rule)”。这能有效降低 NAT 限制等级，减少卡顿。
5. 常见问题排查与 FAQ
在路由器级别排障，逻辑要极为严谨，请看以下 5 大高频解答：
1. 为什么导入订阅时一直提示“wget/curl 下载失败”？
这是因为您的路由器目前尚未翻墙，遇到了 DNS 污染，无法解析机场的订阅域名。 解决办法：请联系机场客服索取一个国内能直连的“备用防污染订阅链接”。如果还是不行，请先在电脑上下载好订阅配置文件，在 NekoBox 界面里通过“离线上传”的方式导入路由器。
2. 插件显示“运行中”，但手机连上 Wi-Fi 连国内百度都打不开？
这是最典型的软路由 DNS 冲突或防火墙劫持失败现象。 解决办法：请检查并暂时关闭路由器上的其他网络插件（如 AdGuard Home 或 Turbo ACC），确保 NekoBox 拥有唯一的 DNS 接管权。或者在基本设置中尝试将 Tproxy 模式切换回 Redir 模式，并重启整个路由器。
3. 为什么在 Web 面板里测速，所有节点都显示 Timeout？
这说明底层的 Xray/Sing-box 核心无法与任何海外节点建立通信。
- 请先登录机场官网检查套餐流量是否耗尽或已过期。
- 可能是当前使用的节点 IP 已被防火墙大规模阻断，请去“订阅管理”重新拉取最新的节点库。
4. 为什么装了这款插件后，测速跑不到宽带的最大极限？
代理流量的加密和解密非常考验路由器 CPU 的单核算力。 解决办法：如果您使用的是老旧硬路由或算力一般的 N1 盒子，跑不满是正常物理现象。想榨干千兆宽带，请务必升级使用 J4125、N100 甚至性能更强的 x86 软路由设备。
5. 如何安全、彻底地卸载该插件？
如果在不想用时直接粗暴卸载插件包，会导致路由器防火墙残留劫持规则，全家直接断网！ 解决办法：务必先在基本设置中取消勾选“启用”，点击“保存并应用”，让插件自动清理掉 iptables 中的透明代理规则。确认手机上网恢复正常后，再去系统的“软件包”列表里卸载 .ipk 安装包。