Roxi同名应用不一定来自同一项目
这里指 MatsuriDayo/NekoBoxForAndroid。官方 README 明确提醒：自 2024 年 5 月起，Google Play 上的同名版本由第三方控制，不是该项目的开源版本。应从原仓库的 Releases 入口核对下载，不能仅凭图标、名称或商店排名认定来源。
官方文档把 Android 项目标为缓慢更新；NekoRay / NekoBox for PC 则是另一个已归档项目。两者的平台与维护状态不能混写。准备新设备时，应先检查所需协议和新系统是否仍兼容，再决定继续使用还是迁移。本文不承诺后续版本或维护频率。
已有用户先保住能用的配置
- 记下安装来源、应用版本和可用节点；在自己的离线存储保存必要配置，确认能从服务提供方重新获取订阅。
- 遇到签名不同、版本冲突时，先核对 APK 来源，不要为了覆盖安装直接卸载旧版本。
- 新配置用独立分组做对照，保留旧分组。不要同时修改 DNS、路由、协议栈和多路复用，否则无法判断故障由哪项引入。
按格式导入，不把完整配置当成节点列表
官方说明列出了 Clash Meta、v2rayN、Shadowsocks 和部分 sing-box 内容等导入支持，同时指出旧格式及非标准分享链接可能不兼容。兼容范围还受应用版本影响；看到 YAML 或 JSON 后缀不等于整份文件都能被原样使用。优先选择服务提供方为 NekoBox 生成的入口。
| 拿到的内容 | 处理方式 | 要验证什么 |
|---|---|---|
| 订阅 URL | 按链接导入或添加订阅分组 | 更新后节点是否出现 |
| 单条节点链接 | 用分享链接导入 | 地址、协议与所需字段是否保留 |
| 完整 sing-box JSON | 按官方自定义配置说明处理 | GUI 路由是否还会参与 |
| 其他客户端内部备份 | 回到原应用导出兼容格式 | 不能靠改扩展名转换 |
官方说明特别指出，导入完整自定义配置时 GUI 路由等功能可能不再生效；内部 sn:// 分享信息也不保证跨版本兼容。若你改了界面规则却没效果，先确认配置类型，不要一直添加重复规则。陌生在线转换站可能获得整条订阅凭据。
先接管应用，再决定应用流量走哪里
“分应用代理”决定哪些应用进入 NekoBox 的 VPN 接管；“路由”决定已进入的流量走代理、直连还是被阻止。某应用被排除后，即便为它写了代理路由，也可能根本没有流量进入内核。两层设置应分别核对。
- 选一个节点并启动 VPN 模式，确认 Android 授权属于此应用。
- 先用默认配置访问目标应用，确认基础连通；再只调整一个应用的包含或排除状态。
- 重启 VPN 连接，重新打开目标应用，结合日志核对请求。浏览器能用不能代替对该应用的验证。
- 需要路由器、打印机或 NAS 时，先检查“绕过局域网”的设置及文档适用条件，保留原值以便回退。
导入成功但不能用，按阶段找原因
列表有节点只说明解析出了配置。启动失败先查内核错误和协议支持；连通测试失败再查远端、DNS 与当前网络。官网能开而订阅更新失败，则重点看下载响应和凭据。不要把过时字段、网络超时和套餐授权混成一个问题。
排障时撤销自己刚加的设置，回到保存过的可用分组。正常停止服务后验证基础联网；如果之前开启了 Android 无 VPN 阻断策略，按实际需求恢复。迁移到其他客户端时，优先重新获取其支持的订阅，逐个验证必要应用，最后再处理旧软件。