sing-box 订阅怎么添加？安卓 Remote 配置、更新与节点排查
简答：在 Android 上添加 sing-box 订阅，最短路径是：确认服务商提供的是 sing-box JSON 或 Remote 配置链接，打开 sing-box for Android 新建远程配置，粘贴 URL 后保存并更新，再选择节点或分组并启动 VPN。先不要把 Clash YAML、网页登录地址或单节点分享链接直接当作 sing-box 订阅；成功判据是配置能更新、出站或节点不为空、服务能启动，并完成一次实际联网测试。
定义：sing-box 订阅是一个以 URL 为更新来源的远程配置，Android 客户端将其保存为 Remote Profile，并按客户端机制重新拉取配置。
先试这三步：Android 添加 sing-box 订阅
本文是第三方使用指南，站内不代表任何品牌的官方页面。本文只讲 Android 客户端；iPhone、Windows 和 macOS 的菜单与授权方式可能不同，不建议直接套用。
- 确认格式：在订阅服务商用户中心查找明确标注为 sing-box、JSON 或 Remote 的链接。AmyTelecom 当前是否直接提供 sing-box 专用订阅、入口名称以及是否支持 Shadowsocks 对应格式，本文无法从公开资料核实，应以其用户中心和官方说明为准。
- 添加远程配置：打开 sing-box for Android，进入配置文件或 Profiles 管理区域，选择新增 Remote、远程配置或相近名称的入口，填写名称并粘贴完整 URL，然后保存。
- 更新并启动：对新建配置执行更新，确认出站、节点或分组不为空，选中该配置后启动服务，并按 Android 系统提示允许 VPN 权限。
sing-box 官方说明将 Remote Profile 定义为以 URL 为更新来源的远程配置，并要求图形客户端支持远程配置更新；Android 客户端也支持管理和运行本地或远程 sing-box 配置，可参考 sing-box 图形客户端通用说明 和 sing-box Android 客户端说明。
| 你手里的内容 | 是否应直接添加 | 正确处理方式 |
|---|---|---|
| 明确标注 sing-box、JSON 或 Remote 的 URL | 可以尝试 | 在 Android 客户端新增远程配置并更新 |
| Clash YAML 订阅 | 不能默认兼容 | 先向服务商确认是否有 sing-box JSON 输出 |
| 单个节点分享链接 | 不等于订阅 | 按客户端支持的单节点导入功能处理 |
| 网页登录地址或登录页 | 不能使用 | 返回用户中心复制真正的订阅 URL |
添加前：如何检查订阅格式和 Shadowsocks 兼容性
不要只看到“通用订阅”四个字就判断它一定能被 sing-box 识别。先看服务商页面是否明确提供 sing-box、JSON、Remote 或对应客户端格式。如果页面只有 Clash、Surge 或其他格式，先确认是否能生成 sing-box 配置；无法确认时，不要反复导入同一个链接。
如果订阅中的节点是 Shadowsocks，配置被 sing-box 正确识别后，相关出站通常需要具备 Shadowsocks 类型以及服务器地址、服务器端口、加密方法和密码等必要信息。sing-box 官方 Shadowsocks 出站文档列出了 type、server、server_port、method 和 password 等字段，详见 Shadowsocks 出站配置。
- 节点列表为空：先怀疑链接返回内容为空、格式不兼容或更新失败。
- 能看到节点但无法启动：查看日志中是否出现 Shadowsocks 字段缺失、加密方法不支持、服务器地址错误或认证失败。
- 节点名称正常但连接失败：这只能说明配置已被读取，不能证明节点参数、网络路径或服务端状态正常。
不要为了检查格式而把带凭据的订阅 URL 公开发到群聊、工单截图、代码仓库或在线转换页面。若必须进行人工检查，优先使用客户端的更新状态和日志；如曾把真实 URL 暴露在浏览器历史、截图或公开页面中，应在对应用户中心重新生成或重置链接。
Android 客户端的照做路径：新增、更新、选择、启动
下面是按 Android 图形客户端整理的最短操作路径。官方文档确认 sing-box for Android 可以运行本地或远程配置，并可通过 Android 的 VPN 服务实现 TUN 功能；实际按钮名称会随客户端版本和构建渠道变化，看到含义相近的入口即可，不要把路径理解为所有版本完全一致。
- 打开配置管理：启动 sing-box for Android，找到 Profiles、配置文件或配置管理区域。
- 新建 Remote：选择新增远程配置，填写便于识别的名称，粘贴完整订阅 URL。不要把 URL 粘贴到 JSON 编辑器中，也不要先删掉问号后的参数。
- 保存并更新：保存后对该配置执行更新或刷新。等待客户端完成拉取，再打开配置内容或状态信息确认没有解析错误。
- 确认出站：如果配置包含节点、Selector 或 URLTest 等分组，检查是否出现可选择的出站或分组。部分客户端会提供分组选择入口，具体以当前客户端功能为准。
- 选择配置并启动：返回主界面，选中刚更新的配置，启动服务。首次使用需要按 Android 系统提示允许 VPN 连接。
- 实际验证：先打开一个普通网页或目标应用测试，再回到客户端查看连接、流量或日志状态。看到节点不等于已经联网，启动后实际访问才是完整验证。
Android 客户端的运行方式可能涉及 ForegroundService 或 Android VpnService；官方功能说明列出了这两类服务，以及 TUN 在 Android 上通过 VpnService 实现的方式，详见 sing-box Android 客户端功能说明。
| 阶段 | 成功判据 | 没有达到时先检查 |
|---|---|---|
| 格式确认 | 服务商明确说明链接输出为 sing-box JSON 或 Remote | 不要把 Clash YAML 或网页登录地址直接导入 |
| 配置保存 | Remote 配置出现在列表中 | 检查名称、URL 是否完整以及是否误带空格 |
| 更新解析 | 配置内容可读取，出站或节点不为空 | 检查返回内容、链接有效期和格式 |
| 服务启动 | 服务运行并完成 VPN 授权 | 确认选中了正确配置并重新授权 |
| 联网验证 | 实际网页或应用能够访问 | 查看 DNS、超时、认证和节点连接日志 |
更新订阅和节点失效时怎么处理
首次添加和后续更新不是同一个动作。首次添加是建立 Remote Profile；更新是重新从 URL 拉取配置。节点增加、节点名称变化、旧节点失效或服务商调整配置时，应先对现有 Remote Profile 执行手动更新，不要立即删除旧配置。
- 在配置列表中找到已经保存的 Remote 配置。
- 执行更新或刷新，等待客户端返回完成、失败或解析错误状态。
- 更新成功后重新确认出站、节点或分组是否出现。
- 如果配置结构发生变化，重新选择节点或分组，再启动服务。
- 如果新链接无法更新，保留旧配置作为回滚对照，不要同时修改 DNS、TUN 和多个节点参数。
如果服务商重新生成了订阅 URL，应使用新的链接新建或替换 Remote 配置。AmyTelecom 当前是否支持重新生成链接、链接有效期以及后台具体按钮名称均未核实，实际操作以当前用户中心和官方说明为准。
常见失败：按“现象—检查—处理—回滚”排查
提示 JSON 错误或解析失败
检查：先看客户端更新状态和日志，确认返回内容不是 HTML 登录页、验证码页或错误页。不要为了检查而公开复制完整订阅 URL。处理：重新从用户中心复制链接，并确认它是 sing-box JSON 或 Remote 格式。回滚：保留原有可用配置，删除或停用刚添加的错误配置。
更新成功但节点为空
检查：确认更新是否真的完成，配置是否被选中，以及页面是否存在出站或分组。处理：重新确认服务商输出格式；如果是 Shadowsocks 节点，检查日志是否提示必要字段缺失。回滚：切回之前能读取的配置，不要立刻改动 DNS 或 TUN。
节点显示但启动失败
检查：查看日志中的协议字段、加密方法、服务器地址、端口和认证错误。处理：先更换同一订阅中的另一个节点，判断是单个节点参数问题还是整个配置问题。回滚：关闭服务并恢复之前的配置，避免覆盖原有可用配置。
服务启动但无法联网
检查：确认 Android VPN 权限已授予，查看日志中的 DNS、连接超时或 TLS 错误，并确认普通网络本身可以访问。处理：先换节点复测，再判断是单节点、配置规则还是网络问题。回滚：停止 sing-box，恢复系统原有网络设置后重新启动客户端。
后台切换后连接中断
检查：查看 Android 系统是否限制客户端后台活动或通知服务。处理：仅在系统设置中查找该应用的电池、后台运行和通知权限，具体菜单名称按手机品牌为准。回滚：先关闭省电限制变更，逐项恢复，不要一次修改多个系统网络选项。
导入前后自查清单
- 格式：是否明确确认是 sing-box JSON 或 Remote 配置，而不是仅写着“通用订阅”。
- 链接：是否完整复制，是否误删参数、加入换行或粘贴了登录页地址。
- 安全：是否避免把真实订阅 URL 放入公开截图、日志、代码仓库或在线转换页面。
- 解析：更新后是否能看到出站、节点或分组。
- Shadowsocks：若节点属于该协议，日志中是否出现字段缺失、认证失败或加密方法错误。
- 运行：是否选中了正确配置，并完成 Android VPN 授权。
- 验证：是否通过实际网页或应用访问，而不是只看见节点名称。
- 回滚：是否保留旧配置，以便区分订阅格式、节点参数和网络问题。
本文资料整理日期为 2026 年 11 月 11 日。客户端界面、菜单名称和服务商订阅格式可能变化；无法从官方资料确认的入口、版本和格式，均应以当前客户端页面及服务商说明为准。
常见问题
sing-box 可以直接添加 Clash 订阅吗？
不能默认认为可以。Clash YAML 与 sing-box JSON 是不同配置格式，除非服务商明确提供 sing-box 输出或兼容转换方案，否则应先确认格式，不要直接粘贴。
sing-box 添加订阅后没有节点怎么办？
先查看客户端更新状态和日志，确认链接返回的不是登录页、错误页或空内容，再检查是否选中了正确配置和分组。如果节点仍为空，应向服务商确认该链接是否真的输出 sing-box JSON，以及链接是否已经失效。
Shadowsocks 节点显示出来但无法启动怎么办？
先查看日志中的服务器地址、端口、加密方法、密码和认证错误，再更换同一订阅中的其他节点复测。sing-box 官方 Shadowsocks 配置要求相应出站具备必要字段；如果字段缺失或方法不支持，应重新获取兼容格式，而不是只修改节点名称。
添加 Remote 配置后一定要开启 TUN 吗？
不一定。Android 客户端可能通过 Android VpnService 运行需要 TUN 的配置，是否使用取决于配置和客户端运行方式。先按客户端提示完成 VPN 授权，再根据实际需求选择运行模式。
订阅更新失败后要不要删除旧配置？
不建议立即删除。先保留旧配置作为回滚和对照，检查 URL、网络、客户端日志和服务商链接状态；确认新链接能够成功更新后，再替换旧 Remote 配置。
订阅链接泄露后怎么处理？
把它视为需要更换的凭据。优先在对应用户中心重新生成或重置订阅链接；如果页面没有该功能，联系服务商确认处理方式，并清理公开截图、日志或代码中的旧链接。