# 安卓 NekoBox 使用教程，订阅节点配置、客户端下载
{% hint style="success" %}
💡 没有订阅？泡芙云：月付仅6元起，流畅访问ChatGPT、Netflix等平台，30秒注册立即可用。[立即开通 →](https://www.paofu.cloud/)
{% endhint %}
### NekoBox for Android 是什么?
NekoBox for Android（简称 NB4A）是一款**开源的安卓代理客户端**，由 MatsuriDayo 团队维护，是 SagerNet 停止开发后的接班产品。
它由两部分组成：
* **底层内核**：使用 Sing-Box，负责真正的代理流量处理
* **图形界面**：提供节点管理、订阅导入、流量统计等功能
主要优势包括无需 Root、协议支持极全（涵盖 SS、SSR、VMess、VLESS、Trojan、Hysteria2、TUIC、AnyTLS、WireGuard 等）、支持自定义路由规则、内置节点测速。NB4A 是 Android 平台上协议覆盖最广的代理客户端之一。
### NekoBox for Android 客户端下载
NB4A 是开源软件，所有版本均免费提供下载。由于 Google Play 商店未上架该应用，需要从 GitHub Releases 下载 APK 安装包。泡芙云提供了 NB4A 最新稳定版的镜像下载：
* Android arm64-v8a（常用）：[点击下载](https://cdn.paofu.cloud/NekoBoxForAndroid/NekoBox-arm64-v8a.apk)
* Android armeabi-v7a（老旧机型）：[点击下载](https://cdn.paofu.cloud/NekoBoxForAndroid/NekoBox-armeabi-v7a.apk)
下载完成后点击 APK 安装，首次安装时安卓系统会提示"未知来源"，按提示开启"允许此来源安装应用"即可。
### 添加订阅链接
安装完成 NekoBox for Android 之后，需要把泡芙云订阅链接导入进去，客户端才能拿到节点列表。整个过程分两步：先在泡芙云用户中心复制订阅链接，再导入到 NB4A。
{% hint style="success" %}
💡 还没有泡芙云账号？月付最低 6 元起，稳定流畅的网络访问，支持 流媒体 / AI 工具等 [立即注册 →](https://paofu.cloud/auth/register)
{% endhint %}
#### **在用户中心复制订阅链接**
登录泡芙云用户中心，主页会看到「订阅」相关区域，点击V2Ray订阅按钮复制订阅链接。
#### **导入到 NekoBox for Android**
1. 打开 NekoBox for Android 客户端
2. 点击左上角菜单选中「分组」
3. 点击右上角「**+**」按钮，在分组类型中选中「订阅」
4. 将订阅链接粘贴到「订阅链接」输入框中
5. 点击右上角「**确定**」保存
6. 回到分组页面，在列表中选择刚导入的分组
#### 验证订阅导入成功
如果导入后看不到节点，或主界面下方节点列表为空，常见原因：
• 订阅链接复制错误（漏字符或链接末尾多了空格）
• 泡芙云账号订阅已到期
• 网络问题暂时无法获取订阅内容，请确保更新订阅不要通过代理
### 选择节点连接
订阅导入成功后，下一步就是选一个节点连接。NekoBox for Android 的节点列表会在主页直接展开，点几下就能用上代理。
激活配置组后，NB4A 主页会显示该配置组下的所有节点。每个节点卡片上显示节点名、协议类型、延迟测试结果。
#### **手动切换节点**
1. 在 NB4A 主页节点列表中，**点击想使用的节点**
2. 节点卡片会高亮显示，表示已选中
3. 点击节点卡片下方的小飞机图标即可开启
{% hint style="warning" %}
如果您不熟悉路由规则设置，请勿随意变更其他规则
{% endhint %}
#### **开启代理**
1. 选中目标节点后，点击底部「**连接**」按钮（或右下角飞机图标）
2. 系统弹出 VPN 权限请求，点击「**确定**」授权
#### NekoBox for Android 的「**路由**」（在 设置 → 路由 中调整）
* **绕过中国大陆域名**：国内网址直连，国外走代理
* **绕过中国大陆IP**：国内IP直连，国外IP走代理
### 安卓 NekoBox 常见问题
#### 安卓手机是 arm64-v8a 还是 armeabi-v7a 我该下哪个？
2017 年以后发布的安卓手机基本都是 arm64-v8a 架构（64 位），下载这个版本即可。armeabi-v7a 仅给更早期的 32 位低端机型准备（2016 年之前的入门机或老旧平板）。
可以在系统「设置 → 关于手机」中查看处理器型号确认，或者安装 [CPU-Z](https://play.google.com/store/apps/details?id=com.cpuid.cpu_z) 等工具查看 ABI 字段。x86\_64 版本仅供 BlueStacks、MuMu 等安卓模拟器使用，真机用户不要选这个版本。
#### NB4A 和 Clash Meta for Android 区别在哪？
两者都支持 AnyTLS 等新协议，主要差异在内核生态：
* NB4A：基于 sing-box 内核，协议覆盖最广（含 Naive、Brook、Mieru 等冷门协议）
* CMfA：基于 Mihomo（Clash Meta）内核，沿用 Clash 配置体系，规则编辑更直观
如果只用主流协议（SS / VMess / Trojan / AnyTLS），两个客户端都行；如果你需要 sing-box 独有的协议或喜欢更精细的路由规则，选 NB4A。
#### 安装 APK 时提示"未知来源"被拦截？
NB4A 没有上架 Google Play，需要从 GitHub 下载 APK 手动安装，因此首次安装时安卓系统会拦截。开启权限的步骤：
1. 点击 APK 安装时，系统弹出"未知来源应用"提示
2. 点击「设置」跳转到对应权限页
3. 把当前应用（浏览器或文件管理器）的「允许来自此来源的应用」开关打开
4. 返回继续安装即可
Android 8.0 以上系统都通过这个弹窗授权，无需进系统设置翻找。
#### NB4A 后台一段时间就掉线？
这是安卓系统的电池优化策略导致的，NB4A 后台进程被系统休眠或杀掉。解决方法是把 NB4A 加入电池白名单：
1. 打开手机系统「设置」→「应用管理」
2. 找到 NekoBox
3. 进入「电池」或「省电策略」
4. 选择「不限制」或「允许后台运行」
#### 怎么让 NB4A 开机自启？
1. 打开手机系统「设置」→「网络和互联网」→「VPN」
2. 找到 NekoBox，点击右侧齿轮图标
3. 开启「始终开启的 VPN」
4. 同时建议开启「屏蔽未使用 VPN 的连接」（Block connections without VPN）
开启后即使重启手机，NB4A 也会自动接管流量，避免出现忘开代理的情况。
#### NB4A 启动失败或闪退怎么排查？
按以下顺序排查：
1. VPN 权限被拒绝：首次启动必须授权 VPN，被拒过的话需要重新打开 NB4A 在弹窗中点击「确定」
2. 订阅过期或无效：登录泡芙云用户中心查看订阅状态、流量余额
3. 配置组损坏：长按问题配置组选择「删除」，重新导入订阅
4. 内核版本不匹配：进入「设置」→「内核管理」更新到最新 sing-box
5. 与其他 VPN 冲突：安卓同时只能运行一个 VPN，关闭其他代理 App（如 v2rayNG、CMfA）后再试
#### 怎么自定义路由规则？
NB4A 支持通过 geosite / geoip 规则集定制流量分流。订阅默认已经配好「国内直连、国外代理」的规则，绝大多数用户不需要额外设置。
如需自定义：
1. 打开 NB4A →「路由」
2. 找到「自定义路由集」
3. 添加规则（按域名、IP等条件分流）
4. 保存后重启代理即可生效
#### NB4A 是开源软件吗？在哪查看源代码？
NekoBox for Android 是 100% 开源软件，基于 GPLv3 协议在 GitHub 公开维护。如果你对代理软件的安全性有顾虑，可以自行审计代码或从源码编译。
* 官方仓库：[github.com/MatsuriDayo/NekoBoxForAndroid](https://github.com/MatsuriDayo/NekoBoxForAndroid)
* sing-box 内核：[github.com/SagerNet/sing-box](https://github.com/SagerNet/sing-box)
* 活跃 fork（Husi）：[github.com/xchacha20-poly1305/husi](https://github.com/xchacha20-poly1305/husi)
### 机场推荐
本教程基于 [泡芙云机场](https://paofu.cloud) 的订阅服务编写。泡芙云提供稳定流畅的全球网络访问服务，最新加密协议，全球多区域节点，适合日常浏览、ChatGPT、流媒体、AI工具等使用。
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.paofu.info/android/nekobox.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.