---
url: https://eoht.net/serve/antiwall/nekobox.md
description: >-
  NekoBox for Android 的客户端下载、订阅分组、节点导入与 VPN
  连接教程，说明订阅只解析节点、部分协议依赖插件，以及路由规则和连接失败的排查方法。
---

# NekoBox Android 使用教程：客户端下载、订阅导入与路由分流设置 {#nekobox-tutorial}

**NekoBox for Android** 是一款基于 **sing-box** 内核的 Android 代理客户端，支持多协议、多节点管理与灵活的路由分流，适合新手与进阶用户使用。

**支持协议**：\
HTTPS、Hysteria、NaïveProxy、Shadowsocks、SOCKS5、SSH、Trojan、TUIC、V2Ray、WireGuard、Xray 等。

| 核对项 | 说明 |
| --- | --- |
| 平台 | 本文仅讲 NekoBox for Android |
| 版本范围 | 截图为既有界面示例；本次未逐版本安装实测，菜单以当前发行版为准 |
| 导入格式 | 支持常见节点链接及多种订阅格式；订阅中的分流规则不会随节点导入 |
| 权限 | 首次连接允许 Android VPN；部分协议还需要单独安装插件 |

[原项目说明](https://github.com/MatsuriDayo/NekoBoxForAndroid/blob/main/README.md)明确：**Trojan-Go、NaïveProxy、Mieru 依赖对应插件**；订阅仅解析节点，忽略分流规则。另需注意，Google Play 同名版本自 2024 年 5 月起由第三方控制，不是此开源项目的发行版；本文使用下方原项目 Releases。

## NekoBox 客户端下载 {#nekobox-download}

<Links
:grid="2"
:items="[
 {
   image: 'https://i.eoht.net/logo/nekobox.webp',
   name: 'NekoBox for Android',
   desc: '基于 sing-box 的多协议代理客户端，支持订阅分组与路由规则。',
   link: 'https://github.com/MatsuriDayo/NekoBoxForAndroid/releases'
 }
]"
/>

## NekoBox 添加订阅 {#nekobox-subscription-setup}

### 获取订阅地址 {#nekobox-get-subscription-url}

<Links
:grid="2"
:items="[
 {
   icon: 'twemoji:airplane',
   name: 'VPN机场套餐与价格比较',
   desc: '按价格、流量和套餐类型初筛，再进入详情核对线路、解锁与优惠。',
   link: '/serve/airport/summary#vpn-airport-plan-comparison',
   linkText: '比较机场套餐'
 }
]"
/>

登录机场官网后台，复制 **订阅链接**。\
⚠️ 建议关闭浏览器自动翻译，避免订阅链接被错误处理。

### 新建订阅分组 {#nekobox-create-subscription-group}

1. 点击左上角菜单 → **分组**
2. 右上角点击 **➕**
3. 分组类型选择 **订阅**
4. 粘贴订阅地址并保存
5. 更新分组拉取节点

确认分组更新后出现节点，再返回主页选择节点连接。Clash 订阅能解析出节点，不代表其中的策略组、DNS 和规则已经迁入。

## 手动添加节点 {#nekobox-add-node-manually}

适用于单节点、自建服务器或测试用途。

### 常用导入方式 {#nekobox-node-import-methods}

* **扫码导入**：➕ → 扫描二维码
* **剪贴板导入**：➕ → 从剪贴板导入

常见节点链接前缀：

* VMess：`vmess://`
* VLESS：`vless://`
* Shadowsocks：`ss://`
* Trojan：`trojan://`
* SOCKS5：`socks5://`

> 注意复制完整链接。

### 支持手动配置的协议 {#nekobox-supported-protocols}

SOCKS / HTTP / Shadowsocks / VMess / VLESS / Trojan / Trojan-Go /\
Naïve / Hysteria / TUIC / SSH / WireGuard / ShadowTLS

路径：\
**➕ → 手动输入 → 选择协议 → 填写参数 → 保存**

## 启用代理服务器 {#nekobox-enable-proxy}

1. 主页选择任意节点
2. 点击底部 **连接**
3. 首次使用需允许 VPN 权限

底部显示“已连接”只说明 VPN 服务已启动。打开目标网站并查看连接/日志，确认请求使用了所选节点；不通时继续检查 DNS、路由和节点协议。

## 路由与分流设置 {#nekobox-routing-settings}

路径：左上角菜单 → **路由**

先检查当前规则的匹配条件、顺序和默认出口，不要假定导入订阅后自动得到“中国直连、其他代理”。按需要为域名、IP 或应用指定直连/代理/阻止，再用目标应用验证命中情况。

“屏蔽 QUIC”会阻止相关 UDP 流量，部分应用可能回退到 TCP，但不是通用提速开关；广告与跟踪拦截也可能误伤业务。一次启用一项，异常时撤回并查看日志。

## 使用建议 {#nekobox-usage-tips}

* 新手优先使用 **订阅导入**
* 节点异常先检查协议参数、插件是否安装和服务端可达性；不要随意改变服务端未提供的协议
* 高级用户可结合规则实现精细分流

## 订阅与连接排查 {#nekobox-troubleshooting}

* **更新后没有节点**：检查返回内容、订阅格式与账号状态，确认不是网页链接；查看分组更新错误，不把节点数为零当作正常导入。
* **只有某个协议失败**：检查对应插件版本与架构，按原项目的插件说明安装，不从不明镜像替换核心。
* **连接后应用仍直连**：检查分应用代理名单与本地路由；订阅里的分流规则原本就不会导入，需要自己配置。
* **切换网络或锁屏后断线**：检查其他 VPN 冲突与电池后台限制，重连后再用真实请求验证。