NekoBox 使用教程：下载、导入订阅、sing-box 路由与常见错误

NekoBox for Android（下文简称 NekoBox）是一款开源的安卓代理客户端，使用 sing-box 作为内核，支持 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、TUIC 等常见协议。它和电脑端的 NekoRay 出自同一开发者，界面风格相近：以“分组”管理订阅和节点，通过“路由”规则决定流量走向。

和 v2rayNG 相比，NekoBox 对 Hysteria2、TUIC 等新协议的支持较早；和 Clash Meta for Android 相比，它使用的是通用订阅而不是 Clash 配置。不同版本的菜单位置有差异，名称和本文略有不同时按含义查找即可。

下载

NekoBox 的官方下载渠道是项目官方 GitHub 仓库的 Releases 页面：

1. 打开 Releases，选择最新的正式版本（不要选 Pre-release）；
2. 在 Assets 中按手机处理器架构选择 APK：
   • 绝大多数近几年的安卓手机选 arm64-v8a；
   • 很老的 32 位设备选 armeabi-v7a；
   • x86_64 一般只用于电脑上的安卓模拟器；
3. 不确定架构时，可以选择文件名中标注为通用（universal）的 APK（如果发布页提供），体积大一些但兼容所有设备。

只从官方 GitHub 下载。第三方应用市场和网盘中的“NekoBox 中文版”“去广告版”无法确认是否被篡改，NekoBox 本身没有广告且自带中文界面。

安装

1. 用浏览器下载 APK 后点击安装；
2. 如果系统提示“禁止安装未知来源应用”，按提示在设置中允许该浏览器或文件管理器安装应用；
3. 部分品牌手机安装时会弹出安全扫描警告，确认来自官方 GitHub 后继续安装即可；
4. 安装完成后打开，界面默认跟随系统语言。

导入订阅

NekoBox 使用通用订阅（Base64 编码的节点链接合集），在机场后台复制“通用订阅”或“V2Ray 订阅”。它对 Clash 订阅也有一定的解析能力，但通用订阅兼容性最好。订阅格式区别见机场订阅是什么。

1. 打开左侧菜单，进入「分组」页面；
2. 点击右上角的添加按钮，新建分组；
3. 分组类型选择“订阅”，填写名称，并在订阅链接一栏粘贴机场的订阅地址；
4. 保存后返回，NekoBox 会自动拉取订阅（若没有，手动对该分组执行更新）；
5. 回到「配置」主页，顶部会出现以分组名命名的标签页，里面就是全部节点。

订阅链接相当于账号凭证，不要截图分享。如果怀疑泄露，到机场后台重置后重新导入。

如果你同时有两家机场的订阅，可以分别建两个订阅分组，它们会在「配置」主页显示为不同的标签页，左右切换即可。当前生效的是你最后选中并连接的那个节点，与它属于哪个分组无关。

添加节点

如果只有单个节点的分享链接（ss://、vmess://、vless://、trojan://、hysteria2://、tuic:// 等）：

1. 复制链接；
2. 在「配置」主页点击右上角的添加按钮；
3. 选择从剪贴板导入；也可以选择扫描二维码，或手动新建某种协议的配置。

选择节点：在列表中点击某个节点，使其处于选中状态，再点击右下角的连接按钮。

测试延迟：在右上角菜单中可以对当前分组执行连接测试（URL 测试），节点旁会显示延迟毫秒数，超时或报错的节点暂时不要用。延迟只代表连通性，不等于下载速度。

更新订阅

• 手动更新：在「分组」页面，对订阅分组点击更新按钮；
• 自动更新：在分组的编辑页面可以开启自动更新并设置间隔，一天一次即可。

更新后节点列表可能变化，原先选中的节点如果被机场删除，需要重新选择。更新失败时，可以先连接一个可用节点再更新，或检查套餐是否已到期。

VPN 模式与仅代理模式

NekoBox 在设置里提供两种服务模式：

服务模式	原理	适用场景
VPN 模式	通过安卓系统 VPN 接口接管设备流量	日常使用，大部分应用自动走代理
仅代理模式	只在本地开启 HTTP / SOCKS 代理端口	只想让个别支持手动设置代理的应用使用

日常请保持 VPN 模式。首次点击连接时，系统会弹出“网络连接请求”对话框，点击确定即可。连接成功后，通知栏会出现常驻通知和 VPN 钥匙图标。

在 VPN 模式下，还可以使用“分应用代理”功能，只让选定的应用走代理，或者让选定的应用绕过代理，适合银行类应用需要直连的情况。分应用代理和路由规则是两层机制：前者决定某个应用的流量是否进入 NekoBox，后者决定进入后的流量走代理还是直连。一般只需要用好路由规则，分应用代理按需使用即可。

TUN 模式

安卓上的 VPN 模式本身就是基于虚拟网卡（TUN）实现的，所以 NekoBox 不需要、也没有单独的 TUN 开关。VPN 模式开启后，效果等同于电脑客户端的 TUN 模式。

设置中可以看到与 TUN 相关的选项，例如网络栈实现方式（system、gVisor 或混合）。一般保持默认即可；如果某些应用连接异常，可以尝试切换网络栈后重新连接。

规则模式

NekoBox 通过左侧菜单中的「路由」页面管理分流规则。路由页面中列出了多条规则，每条规则指定匹配的域名或 IP 以及对应的出站（代理、直连或阻断），可以单独启用或停用。

日常使用建议：

• 启用“国内域名直连”“国内 IP 直连”之类的规则（不同版本默认规则的名称不同），让国内网站和应用不走代理；
• 设置中如有“绕过局域网”选项，保持开启；
• 分流依赖 geosite / geoip 规则数据，如果分流明显不准，可以在设置中检查规则资源的更新。

修改路由规则后，需要断开再重新连接才会生效。

全局模式

NekoBox 没有显式的“全局模式”按钮。把「路由」中的直连规则全部停用后，所有流量都会走当前节点，就相当于全局代理。这种做法适合临时排查“某个网站打不开是否因为规则没命中”，排查结束后记得重新启用直连规则，否则国内应用也会绕道海外，既慢又浪费流量。流量计算方式见机场流量怎么算。

常见错误

现象	可能原因	解决方法
安装时提示解析包出错	下载了不匹配架构的 APK	改下 arm64-v8a 或通用版本
更新订阅后没有节点	订阅格式不对或订阅已过期	改用通用订阅；检查机场套餐
测试全部超时	套餐到期、流量用完或本机时间不准	登录机场后台检查；开启自动同步时间
点击连接没反应	未授予 VPN 权限或被其他 VPN 应用占用	关闭其他 VPN 类应用，重新授权
连接后一段时间自动断开	系统省电策略清理后台	在系统设置中关闭 NekoBox 的电池优化
国内应用变慢	直连规则被停用	在路由中重新启用国内直连规则
银行类应用打不开	应用检测到 VPN 或被代理	在分应用代理中让其绕过代理

更多安卓客户端可以看 Android 客户端教程。

下一步

• 寻找优质机场：机场推荐
• 获取免费节点：每日免费机场
• 领取折扣码：机场优惠码