sing-box 订阅链接怎么使用：各平台导入、更新与连接排查
简答：先确认链接返回的是 sing-box JSON，再在对应客户端新建 Remote 或远程配置，粘贴 URL、更新配置，授权 VPN 或网络扩展，启动后选节点并验证；Clash 格式不能默认直接导入。
定义：sing-box 订阅链接通常是一个由服务端提供、客户端按 URL 远程读取并更新的 sing-box JSON 配置地址，不等同于本地配置文件或任意代理分享链接。
先判断链接格式：不要把任意订阅地址直接导入
本文是第三方使用指南，与 sing-box 项目及其开发者无隶属关系。sing-box 官方文档说明，配置文件使用 JSON 格式，常见顶层字段包括 inbounds、outbounds、route 等，可参考sing-box 配置文件官方说明。
| 检查项目 | 正常表现 | 不符合时怎么做 |
|---|---|---|
| 浏览器打开订阅 URL | 返回可读取的 JSON 文本，而不是登录页、HTML 错误页或空白页 | 回到提供方后台重新复制 URL；不要把后台页面地址当订阅地址 |
| 配置结构 | 能看到 JSON 对象，通常包含 outbounds，可能还包含 inbounds、dns 或 route | 如果返回 YAML、纯文本节点列表或其他格式，先确认是否有 sing-box 专用链接 |
| 链接权限 | 在未登录或客户端请求时也能返回配置 | 若出现 401、403 或跳转登录，检查链接是否过期、是否需要单独的认证信息 |
| 格式名称 | 后台明确标注 sing-box、SFA、SFI、SFM 或 Remote JSON | Clash、Surge 等格式不能默认直接粘贴到 sing-box；应优先选择明确标注 sing-box 的版本 |
订阅链接不是“打开后就能联网”的网页地址，而是客户端获取远程配置的入口。浏览器只能帮助你观察响应内容，真正的导入、更新和运行要在支持 Remote profile 的客户端中完成。官方图形客户端规范把 Remote profile 定义为“以 URL 作为更新来源的远程 sing-box 配置”，并说明图形客户端应支持自动更新，可参考sing-box 图形客户端 Remote profile 说明。
通用操作路径：复制、创建 Remote、更新、启动、验证
- 复制链接：在提供方后台找到 sing-box 专用订阅或远程配置 URL，完整复制
https://开头的地址。不要公开粘贴到群聊、截图或不必要的第三方转换页面，因为 URL 可能包含令牌或账号凭据。 - 创建远程配置：打开客户端的 Profiles、配置、Profiles/配置文件或 Remote/远程配置入口，选择新建远程配置。不同版本的菜单名称可能不同，但要找的是“远程配置”而不是“新建空白 JSON”。
- 填写地址：把 URL 粘贴到地址栏，名称可填写“主订阅”或设备名称；如果客户端单独提供 Secret、Basic Auth 或用户名密码字段，只按提供方说明填写，未知时不要自行猜测。
- 更新配置：保存后点击 Update、更新、Fetch 或立即更新。判定标准是客户端显示更新时间、配置内容可查看，且没有 JSON 解析错误。
- 启动服务：点击 Start、启动或连接。Android、iOS、iPadOS 通常会弹出 VPN 权限；macOS 可能请求网络扩展权限。首次授权时选择允许，拒绝后客户端通常不能接管系统流量。
- 选择节点：如果配置包含 Selector 或 URLTest 等出站组，进入 Dashboard 或 Groups 选择节点；如果没有分组，客户端可能只能使用配置中的默认出站。官方图形客户端规范说明，存在 Selector 或 URLTest 组时，Dashboard 应提供组选择入口，可参考sing-box 图形客户端 Dashboard 说明。
- 验证连接：先访问一个普通网页，再查看客户端状态、流量计数或日志。正常标准是服务状态为运行、访问测试页面有响应、日志没有持续出现解析失败或连接失败。
如果浏览器能打开订阅 URL，但客户端提示解析失败，优先怀疑返回格式、认证、编码或客户端版本兼容性；如果配置能更新但启动后无网络，再检查 VPN 权限、节点选择、DNS 和路由模式，不要反复刷新订阅。
Android：在 SFA 中导入远程配置
Android 官方客户端文档说明，SFA 可以管理并运行本地或远程 sing-box 配置，并在需要 TUN 时通过 Android 的 VpnService 工作，可参考sing-box for Android 官方文档和Android 客户端功能说明。
- 打开 SFA，进入 Profiles 或配置文件页面。
- 点击新增配置，选择 Remote、远程配置或通过远程 URL 添加。
- 填写配置名称和订阅 URL，保存后执行更新。
- 打开该配置的详情，确认更新时间和配置内容能够读取。
- 回到 Dashboard，选择需要使用的出站组或节点。
- 点击启动；Android 弹出 VPN 连接请求时选择允许。
- 访问普通网页并观察通知栏 VPN 图标、客户端状态和流量变化。
Android 上如果显示已启动但应用无法联网，先检查是否启用了按应用代理或排除列表。SFA 的 TUN 功能支持通过界面选择应用进行包含或排除，但具体选项会受配置内容和客户端版本影响；先恢复为全局包含或不设置排除项，再测试是否恢复。
iPhone 和 iPad：创建 Remote 配置并授权网络扩展
sing-box 的 Apple 客户端覆盖 iOS、macOS 和 tvOS，官方仓库将其列为 Apple 平台客户端，可参考sing-box for Apple 官方仓库。不同版本的应用名称和菜单可能变化，以下按共同的远程配置逻辑操作。
- 打开客户端的配置或 Profiles 页面，点击新增配置。
- 选择 Remote、远程配置或从 URL 导入；不要选择仅用于粘贴本地 JSON 的 Local。
- 粘贴订阅 URL，填写名称后保存。
- 点击更新，确认配置可以读取且没有 JSON 解析报错。
- 选择配置并点击启动。首次启动时，在系统弹窗中允许添加 VPN 或网络扩展。
- 回到客户端选择节点或出站组；没有组选择项时，使用配置预设的默认出站。
- 打开网页验证，并在客户端日志或状态页确认服务正在运行。
如果 iPhone 或 iPad 显示配置可用但无法启动，先到系统设置确认 VPN 配置仍存在，再关闭其他 VPN、过滤器或网络扩展后重试。若更新时提示 403 或 404，通常应重新复制订阅 URL并确认它没有被截断；这属于链接访问问题，不是节点选择问题。
Windows：用支持 Remote profile 的图形客户端导入
官方 sing-box-for-desktop 仓库将 Windows 客户端标注为 experimental，Linux 支持状态也可能随项目变化，因此 Windows 用户应以所安装客户端的实际菜单为准，可参考sing-box for desktop 官方仓库。下面只使用通用的 Remote profile 操作，不假定某个第三方客户端的固定版本或菜单。
- 打开 Windows 图形客户端，找到 Profiles、配置文件或 Remote 配置页面。
- 选择新增远程配置，粘贴订阅 URL并保存。
- 点击 Update 或更新，检查是否出现可查看的 JSON 配置和更新时间。
- 在 Dashboard、Groups 或出站组中选择节点；如果客户端没有组入口，说明当前配置可能没有 Selector 或 URLTest 组，不能强行添加一个不存在的节点列表。
- 点击启动服务。若客户端提供系统代理开关，再开启系统代理；只启动内核但不启用系统代理时，部分应用不会自动使用它。
- 先用浏览器访问网页，再看客户端连接数、流量或日志。判定正常的最低标准是服务运行、浏览器请求有响应、日志没有连续的启动错误。
如果 Windows 图形客户端要求管理员权限，按客户端提示重新启动；不要把管理员权限问题与订阅格式问题混为一谈。若远程配置能更新但 TUN 无法启动，先关闭其他 VPN 或网络过滤工具，再检查客户端的系统权限和网络扩展设置。
macOS：远程配置与网络扩展权限
macOS 客户端属于 Apple 平台客户端。官方功能说明显示，Apple 客户端通过 NetworkExtension 提供 TUN 能力，可参考Apple 客户端功能说明。
- 打开 macOS 客户端，进入 Profiles 或配置页面。
- 新建 Remote profile，粘贴订阅 URL并保存。
- 点击更新，确认配置内容可读取，且更新时间发生变化。
- 选择远程配置，进入 Dashboard 或状态页选择节点或出站组。
- 点击启动；macOS 首次可能要求允许网络扩展或系统 VPN 配置。
- 授权后重新启动服务，再访问网页并查看日志。
macOS 上如果客户端显示运行但流量没有经过它，先检查系统设置中的 VPN 或网络扩展是否为允许状态，再确认客户端是否同时启用了系统代理或 TUN。不同模式的覆盖范围不同：系统代理主要依赖应用主动使用代理，TUN 才是虚拟接口接管方式，具体支持取决于配置和客户端实现。
常见错误快速排查：先看错误类型，再决定重导入还是查网络
| 提示或现象 | 优先判断 | 处理顺序 |
|---|---|---|
| JSON parse error、解析失败 | 返回内容不是 sing-box JSON，或配置字段不兼容 | 浏览器查看响应；重新复制 sing-box 专用 URL；更新客户端；仍失败时让提供方确认配置格式 |
| 401、403、404 | 链接需要认证、已失效或路径错误 | 重新登录后台复制；检查 URL 是否完整；若客户端有 Secret 或 Basic Auth 字段，按说明填写 |
| 证书错误、TLS error | 订阅地址或节点地址的 HTTPS/TLS 校验失败 | 确认设备日期时间正确；不要为了绕过错误随意关闭证书校验；更换为提供方确认有效的 URL |
| 配置能更新但没有节点 | 返回的是空配置、错误格式或没有可用出站组 | 查看 JSON 中是否存在 outbounds；让提供方确认返回内容，不要只看链接能否打开 |
| 启动后完全没网 | VPN 权限、TUN、DNS、系统代理或节点本身异常 | 停止其他 VPN；重新授权；先切换到配置中的其他节点；查看日志后再判断 DNS 或路由 |
| 更新后本地改动消失 | 远程配置被重新下载覆盖 | 把长期修改写入本地配置或使用客户端支持的覆盖项；不要直接把远程配置当永久本地文件编辑 |
如果电脑上安装了 sing-box 命令行核心，可用官方提供的检查命令验证本地 JSON：sing-box check。该命令需要已安装并可执行的 sing-box，且示例文件名必须替换为本地实际路径，例如 sing-box check -c config.json；正常标准是命令返回通过而不是显示字段错误。官方配置文档同时列出了 sing-box format 等命令，可参考配置检查与格式化说明。
订阅更新和安全注意事项
- 远程配置会变化：更新订阅后，节点、出站组和路由可能发生变化；本地客户端显示“更新成功”只代表文件被读取，不代表每个节点都可用。
- 不要公开 URL：订阅地址可能携带可识别账号或访问令牌。截图、工单、论坛发帖前应遮住完整 URL，必要时在后台重置链接。
- 不要盲目转换格式：Clash、Surge 或其他客户端链接不能默认直接导入 sing-box。优先使用提供方明确标注的 sing-box JSON；无法确认时写“未核实”，不要把解析失败归因于网络。
- 不要混淆三个对象：Local 是本地文件，Remote 是 URL 远程配置，Dashboard 是运行后的状态与出站管理界面。先完成 Remote 更新，再谈节点选择和连接排查。
- 版本差异要留痕：菜单可能叫 Profiles、配置、Remote 或远程配置；教程中的按钮名称不一致时，以功能含义为准，不要因为名称不同就重复添加多个配置。
常见问题
sing-box 订阅链接可以直接粘贴到浏览器使用吗？
浏览器可以用来检查链接是否返回 JSON，但不能代替客户端导入和启动。真正使用时，应在客户端的 Remote 或远程配置入口粘贴 URL，并完成更新、VPN 或网络扩展授权。
Clash 订阅链接能直接导入 sing-box 吗？
不能默认认为可以。Clash、Surge 和 sing-box 的配置格式不完全相同，优先选择后台明确标注 sing-box、SFA、SFI、SFM 或 Remote JSON 的链接；没有明确标注时应视为未核实。
订阅更新成功，但 sing-box 里没有节点怎么办？
先查看远程配置内容是否包含 outbounds，以及是否存在 Selector 或 URLTest 出站组。若配置为空、返回格式不对或节点由服务端动态生成，应回到提供方后台重新复制链接并确认返回内容。
sing-box 启动后手机或电脑没网，先查什么？
先停止其他 VPN、代理或网络过滤工具，再确认 VPN 或网络扩展权限已允许；随后切换配置中的其他节点，查看 DNS、路由和启动日志。不要一开始就修改大量 JSON 字段。
远程配置多久更新一次？
更新频率由客户端和远程配置实现决定，不能把某个版本的默认间隔当成所有客户端都适用。手动点击 Update 或更新通常最容易验证，自动更新是否生效要看客户端状态和最后更新时间。