> For the complete documentation index, see [llms.txt](https://shadowrocket-wiki.gitbook.io/shadowrocket/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shadowrocket-wiki.gitbook.io/shadowrocket/android/nekobox.md).
# NekoBox for Android 教程
## NekoBox for Android 使用教程
本教程介绍 NekoBox for Android 安卓客户端下载安装、订阅配置、节点管理、代理设置以及常见问题解决方法。
***
## NekoBox for Android 简介
NekoBox for Android 是 Android 平台上的代理客户端。
基于：
```
sing-box
```
内核开发。
支持多种代理协议：
* Shadowsocks
* VMess
* VLESS
* Trojan
* Hysteria
* Hysteria2
* TUIC
* WireGuard
* SOCKS
* HTTP
主要功能：
* 支持订阅链接
* 支持 ClashMeta 配置
* 支持 v2rayN 订阅格式
* 节点管理
* 节点测速
* 路由规则
* DNS 设置
* VPN 模式连接
***
## NekoBox for Android 下载
[点击下载客户端](https://github.com/Matsuridayo/NekoBoxForAndroid/releases)
### 下载客户端
下载 NekoBox for Android 安装包。
安装时如果提示：
```
禁止安装未知应用
```
请进入系统设置：
```
设置
↓
安全
↓
允许安装未知来源应用
```
完成安装。
***
## NekoBox 使用教程
### 第一步：获取订阅地址
登录你的订阅服务后台。
复制：
```
NekoBox 订阅地址
```
或者：
```
ClashMeta 订阅地址
```
***
## 第二步：添加订阅
打开 NekoBox。
进入：
```
分组
```
点击右上角：
```
+
```
选择：
```
从 URL 导入
```
填写：
### 名称
填写备注名称：
例如：
```
我的订阅
```
### URL
粘贴：
```
你的订阅链接
```
点击：
```
确定
```
等待节点导入。
***
## 第三步：更新订阅
进入：
```
分组
```
选择对应订阅。
点击：
```
更新
```
等待更新完成。
更新成功后：
节点列表会自动刷新。
***
## 第四步：选择节点
进入：
```
主页
```
查看服务器列表。
选择需要使用的节点。
可以根据：
* 延迟
* 地区
* 网络速度
选择节点。
***
## 节点测速
选择节点。
点击：
```
测试延迟
```
查看节点响应时间。
参考：
| 延迟 | 状态 |
| --------- | -- |
| 100ms以内 | 优秀 |
| 100-200ms | 良好 |
| 200-500ms | 一般 |
| 500ms以上 | 较慢 |
***
## 第五步：开启代理
返回首页。
点击：
```
启动
```
第一次启动：
系统会弹出 VPN 请求。
点击：
```
允许
```
启动成功后：
显示：
```
运行中
```
***
## NekoBox 路由设置
进入：
```
设置
↓
路由
```
***
### 规则模式（推荐）
使用：
```
规则分流
```
效果：
* 国内网站直连
* 海外网站代理
适合日常使用。
***
### 全局代理
所有流量经过代理。
适合测试连接。
***
### 直连模式
关闭代理。
所有流量直接连接。
***
## DNS 设置
进入：
```
设置
↓
DNS
```
可以根据需求配置 DNS。
用于解决：
* 域名解析异常
* DNS 污染问题
***
## NekoBox 常见问题
### 订阅无法更新
检查：
* 订阅是否过期
* 地址是否复制完整
* 网络是否正常
解决：
1. 重新复制订阅地址
2. 删除旧订阅
3. 重新添加
***
### 导入配置失败
可能原因：
* 订阅格式不支持
* 配置文件错误
* 地址无法访问
解决：
尝试：
```
重新获取订阅地址
```
或者：
```
使用订阅转换
```
***
### 已连接但是无法访问
检查：
#### 节点状态
确认节点可用。
#### 路由模式
建议：
```
规则模式
```
#### VPN 权限
确认系统允许 NekoBox 创建 VPN。
***
### 手机锁屏后断开
部分 Android 系统会限制后台运行。
建议：
进入：
```
系统设置
↓
应用管理
↓
NekoBox
```
开启：
```
允许后台运行
```
关闭：
```
电池优化限制
```
***
## 推荐设置
### 开启自动更新
建议：
定期更新订阅。
保持：
```
最新节点
```
***
### 使用规则模式
推荐：
```
Rule
```
优点：
* 自动分流
* 节省流量
* 提升访问速度
***
### 开启后台运行
建议开启：
```
后台运行权限
```
避免：
* 锁屏断开
* 切换应用断开
***
## 图文教程
***
## 总结
NekoBox for Android 是 Android 平台常用的 sing-box 客户端。
使用流程：
```
下载安装
↓
获取订阅地址
↓
添加订阅
↓
更新节点
↓
选择服务器
↓
开启 VPN
↓
开始使用
```
使用建议：
* 定期更新订阅
* 使用规则模式
* 选择稳定节点
* 保持客户端更新
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://shadowrocket-wiki.gitbook.io/shadowrocket/android/nekobox.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.