Roxi适用客户端
本文针对 SagerNet 官方 sing-box for Android（SFA），不将所有基于 sing-box 的客户端视为同一应用。通过官方客户端页进入下载入口，核对 Android 要求和发布渠道。
创建 Remote 配置
先在 Roxi 网站登录自己的账户，打开订阅区域，复制“第三方客户端”订阅地址。不要复制官网首页、邀请链接或浏览器地址栏里的登录地址。客户端不附送节点；套餐、流量、到期时间和设备限制以账户页为准。
将原 /sub/个人标识 改为 /sub/singbox/个人标识，获得完整 sing-box JSON；仍须与客户端内置核心版本匹配。
下面的 /sub/... 仅表示原链接中的路径。保留账户提供的域名、个人标识和查询参数；只替换一次路径，不把示例占位符当作真实地址，也不要重复加成 /sub/clash/clash/。已有专用链接时直接使用。不要将订阅 URL 发给公共转换站。
- 进入 Profiles 新增 Remote 类型，填写名称与完整 URL，执行下载并选为当前配置。
- 查看配置解析结果，确认没有 unknown field 或旧字段迁移错误。不要把 /sub/nodes/ 返回的节点列表当作完整 JSON。
- 启动服务，确认 Android VPN 授权；进入 Dashboard 查看状态与配置中存在的策略组，固定一个节点测试。
核心升级与配置升级必须匹配
GUI 版本和内核版本都记录下来。完整 JSON 会同时涉及 DNS、路由和 TUN 等字段，不只是节点；相同文件在两个版本上的解析结果可能不同。更新失败时保留旧配置，向来源索取适配版本，或按官方迁移说明在副本中迁移。不能直接抹掉报错字段后宣称行为相同。
Remote 更新并不等于节点已连接
远程 Profile 负责下载配置；服务启动、策略组选择和应用接管是后续步骤。前台成功后再测锁屏、Wi-Fi/蜂窝切换及分应用范围。与另一 VPN 冲突时先停止个人 VPN，再单独验证，不更改单位管理的配置。
怎样确认真正连通
- 确认这次更新成功、节点数大于零，并选中了刚导入的配置。更新失败时可能仍在使用旧缓存，不能只看列表里还有节点。
- 固定一个节点，访问实际要用的网站或应用，再查看连接或日志中的目标、规则与出口。延迟数字、VPN 图标和“已启动”都不能单独证明业务成功。
- 同时检查一个平时可直连的网站；随后断开连接，确认基础网络恢复。只在全局模式可用时回到规则排障，不把全局作为长期修复。
失败后按层排查，保留可恢复的配置
| 现象 | 先核对 | 下一步 |
|---|---|---|
| 下载失败或 401 / 403 | 订阅地址、账户状态、设备限制和当前网络 | 回账户复制新地址；看响应说明，不连续重复导入 |
| 解析失败 / 节点为零 | 下载到的是 YAML、JSON、节点列表还是登录网页 | 换成本文指定格式，保留错误字段名与客户端版本 |
| 能启动但目标打不开 | 当前节点、规则、DNS 和请求日志 | 换一条兼容节点做对照，勿删除 TLS 校验 |
| 停止后不能直连 | 系统代理、其他 VPN、断线阻止设置 | 先在客户端正常停止接管，再退出；恢复改动前设置 |
求助只提供系统与客户端/核心版本、失败阶段、发生时间和脱敏日志。升级前备份本地规则；订阅更新会替换远程内容，个性化设置尽量放在客户端支持的覆写或本地规则里。