sing-box 订阅链接打不开怎么办？
简答：先不要急着修改 DNS 或 TUN：把 sing-box 订阅链接复制到浏览器测试，观察是 404、403、超时、登录页、HTML 还是 JSON。若链接本身能返回内容，再检查是否使用了 sing-box 可识别的远程配置格式；若已导入但网页打不开，则应转向节点、DNS、规则和系统接管排查。
定义：sing-box 订阅链接打不开，是指客户端无法访问远程配置地址、无法解析返回内容，或导入成功后配置没有正常运行的统称。
先试这一步：用浏览器确认问题在哪一层
sing-box 图形客户端支持把远程配置作为带 URL 的 Remote Profile，并由客户端定期更新；官方文档也说明，远程配置的更新来源就是 URL。sing-box.sagernet.org
- 重新复制链接：进入你获取订阅的后台，重新复制明确标注为 sing-box、sing-box JSON 或远程配置的地址。不要把登录页、邀请链接、二维码图片地址或普通网页地址当成订阅地址。
- 在浏览器地址栏打开：建议先用当前网络测试一次，再切换到手机热点或另一条可信网络测试一次。订阅地址包含访问凭据，不要把完整链接发到群聊、工单截图或公开网站。
- 记录返回现象：页面能下载配置、显示 JSON、显示 HTML 登录页、提示 404/403，还是一直加载超时。这个现象比直接改 DNS 更能缩小范围。
- 回到客户端手动更新：保存远程配置后，还要点击 Update、更新、刷新或类似按钮；保存地址不等于已经成功下载最新内容。
| 现象 | 优先检查 | 下一步 |
|---|---|---|
| 404 | 地址路径、订阅是否被撤销 | 从后台重新复制，不要手动改 URL |
| 403 或要求登录 | 权限、Token、访问来源 | 重新生成或重置订阅凭据，并联系服务方核对 |
| 一直超时 | 当前网络、DNS、系统代理或服务端响应 | 换网络测试，再比较两次结果 |
| 显示 HTML、验证码或登录页 | 复制的不是配置内容，或请求被网页验证拦截 | 回后台寻找专用订阅链接 |
| 能返回 JSON 但客户端报解析错误 | 配置格式、客户端兼容性、返回内容是否完整 | 确认是 sing-box 格式，并检查是否被截断 |
按错误提示分流处理
出现 404：优先重新生成链接
404 通常表示请求地址对应的资源不存在，但单凭 404 不能断定账号、套餐或服务状态。先从后台重新复制一条完整链接，检查开头和结尾是否被截断，再用浏览器测试。若新链接仍返回 404，应向提供链接的一方核对订阅是否已更换地址或被撤销。
出现 403：检查凭据和权限
403 表示当前请求被拒绝，可能与 Token 失效、访问权限、请求方式或服务端策略有关。不要反复修改 sing-box 配置；先重新复制订阅，必要时按后台提供的功能重置订阅凭据。重置后，旧链接可能不再可用，客户端中也要替换为新链接。
一直超时：先做网络对照
在同一设备上分别用当前 Wi-Fi、手机热点测试订阅地址。如果只有一条网络超时，问题可能位于当前网络、DNS、代理路径或出口连接；如果两条网络都超时，再重点核对链接是否有效及服务端是否正常。不要把一次超时直接判断为 sing-box 客户端故障。
出现 JSON parse error 或格式错误
sing-box 配置文件使用 JSON 结构，官方配置文档列出了 log、dns、inbounds、outbounds 和 route 等配置区域。github.com 如果浏览器返回的是登录页、验证码、错误说明或被截断的文本，客户端就可能无法按 JSON 配置解析。此时应回到后台选择明确适配 sing-box 的订阅，而不是直接把其他客户端格式的链接改后缀使用。
客户端能导入，但更新后没有节点怎么办？
- 确认配置确实更新：查看远程配置的更新时间、配置大小或内容预览。若更新时间没有变化，先检查保存的 URL 是否正确，再手动执行更新。
- 检查返回内容是否为空：浏览器能够打开一个地址，不代表返回了有效节点配置。若页面为空、只有错误文本或只有 HTML，仍需回到链接来源核对。
- 确认客户端类型：官方桌面客户端用于管理本地或远程 sing-box 配置，并提供平台相关的 TUN 功能；不同图形客户端的菜单名称可能不同。sing-box.sagernet.org 因此应优先使用客户端明确提供的 Remote Profile、远程配置或订阅入口。
- 保存后再次更新：导入地址只是建立配置来源，必须执行一次 Update 或刷新，随后再查看节点、出站组或配置日志。
- 必要时删除并重新添加：先保留原链接和现有配置，再删除损坏的远程配置，重新添加新复制的 sing-box 链接。不要在没有备份的情况下覆盖唯一可用配置。
如果订阅链接已经泄露，应优先在提供方后台重置 Token 或重新生成订阅地址。订阅链接本质上是带访问权限的凭据，不能当作普通网址公开分享。
更新成功但网页打不开：这已经不是“订阅链接”问题
如果远程配置已经成功下载、节点也能显示，但网页仍打不开，排查对象应从“获取配置”转为“运行配置”。可以按以下顺序操作：
- 先选一个节点或出站：确认当前不是空的自动选择组，也不是已经失效的节点。
- 查看客户端运行状态：确认服务已启动，并检查系统代理或 TUN 是否真的开启。TUN 属于系统流量接管功能，可能需要额外的系统权限。
- 区分 DNS 与普通连接：如果 IP 连接正常但域名打不开，可能与 DNS、规则或分流有关；先暂时关闭复杂规则或切换到较简单的配置进行对照。
- 检查日志：重点观察 DNS 查询失败、连接超时、TLS 错误、路由未命中或出站失败等信息。日志只能帮助缩小范围，不能单独证明某个节点一定失效。
- 回滚验证：关闭 TUN、恢复系统代理原状，或换回之前能运行的本地配置。如果回滚后普通网络恢复，说明问题更可能出在新配置的接管、规则或 DNS 设置。
官方文档将远程配置、客户端运行状态和配置结构分别说明；因此不要把“链接能下载”“配置能解析”“节点能连接”“网页能打开”当成同一个成功条件。sing-box.sagernet.org
Windows、macOS、Android、iOS 的检查重点
| 系统 | 先检查 | 暂时不要先改 |
|---|---|---|
| Windows | 浏览器访问、系统代理状态、客户端是否以需要的权限运行 | 不要一开始就改注册表或复杂路由 |
| macOS | 远程配置更新时间、系统代理、TUN 或网络扩展权限 | 不要直接删除所有网络服务 |
| Android | 移动网络与 Wi-Fi 对照、VPN 权限、后台限制 | 不要频繁清除应用数据导致配置丢失 |
| iOS | 配置是否完成下载、VPN 配置授权、系统网络切换 | 不要把登录页地址当作远程配置地址 |
如果只是订阅地址打不开，优先完成浏览器测试和链接重复制；如果配置已更新但无法联网，才进入代理、TUN、DNS 和规则排查。官方图形客户端规范也把远程配置作为独立的 Profile 类型管理，而不是普通网页书签。sing-box.sagernet.org
什么时候应联系链接提供方？
- 重新复制后仍然返回 404、403 或持续超时。
- 浏览器返回 HTML、登录页或错误信息，而不是配置内容。
- 确认网络可用，但多个设备和网络都无法获取同一链接。
- 后台显示订阅已过期、流量用尽、需要重新生成 Token 或更换地址。
- 链接能下载内容，但内容明显不是 sing-box 配置，客户端持续报 JSON 解析错误。
联系时不要发送完整订阅链接。可以提供错误类型、发生时间、使用系统、客户端名称和脱敏后的日志，让对方核对链接状态。
常见问题
sing-box 订阅链接可以直接在浏览器打开吗？
可以用浏览器测试是否能访问，但浏览器能打开只说明地址返回了内容，不代表内容一定是 sing-box 可运行配置。需要继续确认返回的是配置内容，而不是登录页、HTML、验证码或错误文本。
Clash 订阅链接能直接导入 sing-box 吗？
不能默认认为可以。不同客户端使用的配置结构可能不同，应优先选择提供方明确标注为 sing-box 的链接；如果返回格式不匹配，客户端可能出现解析错误或节点为空。
保存订阅链接后为什么没有自动出现节点？
保存远程配置地址不等于已经完成下载。请在客户端中手动执行 Update、更新或刷新，再查看更新时间、配置内容和节点列表。
订阅链接泄露了怎么办？
把它当作访问凭据处理，尽快在提供方后台重置 Token、重新生成订阅或联系服务方。旧链接是否立即失效以对方后台规则为准，不能继续公开分享原链接。
订阅更新成功但网页打不开，应该继续改链接吗？
通常不应继续改链接。先确认节点或出站已选择，再检查客户端运行状态、系统代理、TUN 权限、DNS、规则和日志；这属于配置运行或网络连接问题。