sing-box 添加订阅后无法连接？按格式、平台和启动顺序排查
简答：sing-box 添加订阅的关键是拿到完整的 sing-box JSON 远程配置 URL，再在客户端建立 Remote 配置并启动；Clash YAML、Base64 节点列表不能直接当作该配置使用。
定义：sing-box 订阅通常指一个可被客户端 Remote 配置读取的远程 sing-box JSON 配置 URL，而不是任意节点列表或 Clash 配置链接。
先确认：你拿到的是 sing-box JSON 订阅，不是普通节点链接
本文与 sing-box 项目及其开发者无隶属关系。不同客户端的界面可能随版本变化，以下步骤按截至2026年10月23日可核验的官方文档整理。
最快判断方法：把订阅 URL 放进浏览器或使用命令行请求，返回内容应是 JSON 配置，通常能看到 inbounds、outbounds、route 等配置字段。官方文档明确说明，sing-box 配置文件使用 JSON 格式；Remote Profile 则以 URL 作为远程配置更新来源。配置文件格式｜sing-box 官方文档 通用客户端功能｜sing-box 官方文档
| 返回内容 | 能否直接作为 Remote | 下一步 |
|---|---|---|
| 完整 sing-box JSON | 可以 | 在客户端新增 Remote，粘贴 URL 后更新。 |
| Clash YAML | 不能直接按 sing-box JSON 使用 | 向服务方索取 sing-box 格式配置，或使用可信工具转换后检查 JSON。 |
| Base64 节点列表 | 不能直接作为完整 Remote 配置 | 确认是否有 sing-box 专用订阅或完整 JSON 配置。 |
| 网页、登录页或 HTML 报错 | 不能使用 | 检查 URL 是否复制完整、是否过期或需要登录。 |
如果订阅链接包含个人令牌，不要粘贴到公开群组、论坛或不可信的在线转换站。链接泄露后的处理方式应以服务方后台提供的重置或重新生成入口为准；本文无法核实具体服务商后台按钮名称。
Android：在 Profiles 中新增 Remote 并启动
- 打开官方 sing-box for Android 客户端，进入配置文件或 Profiles 页面。官方资料显示，Android 客户端可管理并运行本地或远程 sing-box 配置文件，并提供基于 Android VpnService 的 TUN 能力。图形客户端列表｜sing-box 官方文档 sing-box for Android｜官方项目文档
- 选择新增 Remote 或远程配置，填写名称，并把服务方提供的完整 HTTPS 订阅 URL 粘贴到 URL 字段。示例中的域名必须替换为你实际获得的订阅地址。
- 保存后手动更新一次，查看更新时间和配置内容预览。正常结果是客户端能读取 JSON，且配置中存在可用的入站、出站或路由结构；如果提示 JSON 解析失败，优先回到第一节检查返回内容。
- 回到主面板选择该配置，点击启动。首次使用 TUN 或 VPN 功能时，按 Android 系统提示允许 VPN 权限。官方资料确认 Android 客户端通过 VpnService 提供非特权 TUN 实现，但具体授权弹窗文字由系统版本决定。Android 功能与 TUN 支持｜官方项目文档
- 启动后观察 Dashboard、通知栏或连接状态。判定成功至少应满足：服务状态显示运行、流量计数出现变化、目标应用能够按配置访问网络。只有配置导入成功但没有流量，不能算完整连接成功。
如果后台提供一键导入二维码或 sing-box://import-remote-profile?url=urlEncodedURL#urlEncodedName 链接，也可以直接交给支持该 URL Scheme 的图形客户端处理。官方通用文档给出了该导入格式，但不同客户端是否注册该链接协议，应以客户端自身实现为准。Remote Profile 与 URL Scheme｜sing-box 官方文档
iPhone、iPad 和 macOS：导入 Remote 后检查网络扩展授权
- 安装并打开官方 sing-box Apple 平台客户端，进入 Profiles 或配置文件页面。官方图形客户端列表将 iOS、macOS 和 Apple tvOS 归为 sing-box for Apple platforms。图形客户端列表｜sing-box 官方文档
- 新增 Remote 配置，填写名称并粘贴完整的远程 JSON 配置 URL。不要把 Clash YAML、Base64 节点文本或单条
vmess://、vless://链接直接当成完整 sing-box JSON 配置。 - 保存后执行一次手动更新，查看配置预览。如果客户端显示更新成功但节点为空，先检查服务方返回的 JSON 是否包含出站配置；本文无法替代服务方对订阅内容的核验。
- 启动连接时允许系统创建 VPN 或网络扩展。若未出现授权提示，可先停止服务、重新启动客户端，再从系统设置中检查该应用的 VPN 或网络扩展权限。
- 用浏览器或一个普通应用做验证，同时观察客户端的运行状态和流量变化。若只有 VPN 图标而没有流量，先停止其他 VPN、代理或网络过滤应用，再重新测试。
Remote Profile 的核心是“URL 作为更新来源”，官方通用文档还说明图形客户端应支持自动更新，默认更新间隔为60分钟。若你的客户端界面没有自动更新选项，不要自行假定字段名称，按当前客户端界面或项目文档操作。Remote Profile 更新机制｜sing-box 官方文档
Windows：优先使用官方 Desktop，命令行则先下载再检查配置
截至2026年10月23日，官方客户端页面列出了 sing-box for Desktop，支持 Windows 10 及更高版本，并可管理和运行本地或远程 sing-box 配置文件。官方项目 README 将其称为实验性 Windows 客户端，因此安装包和界面应以官方发布页为准。sing-box for Desktop｜官方文档 sing-box for Desktop README｜官方项目文档
- 在 Desktop 客户端中新增 Remote 配置，粘贴完整 JSON 订阅 URL，保存并执行更新。
- 选择配置并启动 TUN 或相关网络功能；若 Windows 弹出权限请求，按系统提示允许。若使用第三方 GUI，菜单名称和权限要求应以该项目文档为准。
- 如果使用命令行，先把远程文件下载到本地。以下示例中的 URL 和文件名必须替换为实际值：
curl.exe -L "https://example.com/replace-with-your-subscription" -o config.json - 检查配置格式：
sing-box.exe check -c config.json。命令返回无错误，才继续启动；如果提示未知字段、废弃字段或 JSON 解析错误，应核对客户端内核版本与服务方生成的配置版本，不要直接删除不认识的字段。 - 启动配置：
sing-box.exe run -c config.json。官方配置文档列出了check检查命令和-c配置路径参数；命令行参数可能随内核版本变化，执行sing-box.exe help可确认本机版本支持的写法。配置检查与格式命令｜sing-box 官方文档
判定标准是：check 不报错只能说明配置结构可解析，不能证明节点可用；还需要在运行日志中确认服务已启动，并通过实际应用观察是否有连接和流量。
导入失败、空节点和启动后无网络：按现象排查
| 现象 | 优先检查 | 处理方法 |
|---|---|---|
| JSON parse error | URL 返回的是否是 JSON | 用浏览器或 curl 查看开头内容；如果是 HTML、登录页或 YAML，重新获取 sing-box JSON 订阅。 |
| unknown field 或 deprecated | 内核和配置版本是否匹配 | 先记录完整报错，再向服务方索取适配当前内核的配置；不要根据字段名称自行猜测替代项。 |
| 导入成功但节点为空 | JSON 是否包含 outbounds | 查看配置预览；若服务方返回的内容没有出站配置，联系服务方确认订阅类型。 |
| 启动后无流量 | 是否选择了正确配置、是否授予 VPN/TUN 权限 | 停止其他 VPN 或代理应用，重新选择配置并授权，再用浏览器测试。 |
| 更新失败或超时 | URL 是否完整、网络是否能访问该地址 | 先在当前网络下请求 URL；如果返回403、404或超时，记录状态码并向服务方核实链接状态。 |
不要把“订阅能下载”与“节点能连接”混为一谈：前者只证明远程 URL 返回了内容，后者还取决于配置字段、节点状态、DNS、系统权限和当前网络。配置版本、客户端版本和内核版本也要分开记录，排查时一次只改变一个变量。
常见问题
sing-box 可以直接导入 Clash 订阅吗？
不能把 Clash YAML 或 Base64 节点列表直接当作完整 sing-box JSON Remote 配置使用。应向服务方索取 sing-box 格式订阅，或转换后先检查生成的 JSON。
sing-box Remote 订阅链接应该是什么格式？
Remote 使用 URL 作为远程配置来源，目标内容应是可解析的 sing-box JSON 配置，而不是网页、登录页或单条节点链接。
订阅导入成功但没有节点怎么办？
先查看配置预览和 JSON 内容，确认是否存在 outbounds。若配置结构正常但出站为空，应向提供订阅的一方核实订阅类型和生成内容。
Windows 上应该使用图形客户端还是命令行？
官方页面目前列出 sing-box for Desktop，支持 Windows 10 及更高版本；也可以使用官方命令行先下载配置、执行 check，再用 run 启动。第三方 GUI 的操作以其项目文档为准。
为什么启动后显示运行，但浏览器没有流量？
运行状态只说明服务进程已启动，不代表应用流量已经经过配置。请检查 VPN/TUN 权限、是否选择正确配置、是否存在其他 VPN 或代理软件，并观察日志和流量计数。