sing-box怎么导入订阅：从复制链接到启动连接
简答：sing-box导入订阅的最短流程是：在订阅提供方后台复制兼容 sing-box 的远程配置链接，在客户端新增 Remote 配置，更新内容后选择节点并启动。不要把 Clash YAML、Base64 文本或单节点链接默认当作 sing-box JSON。本文按设备给出可照做的步骤，并用错误现象帮助你定位格式、权限、更新和网络问题。
定义：sing-box订阅导入，是把订阅提供方生成的远程配置地址添加到 sing-box 客户端，由客户端获取配置、节点和路由信息，而不是手动逐项填写服务器参数。
先判断订阅格式：不要把所有链接都当成 sing-box 配置
本文适用于已经拥有订阅地址、准备在 sing-box 图形客户端中使用的场景，不负责创建服务端节点，也不提供未经核验的订阅地址。本文是第三方使用指南，不是任何客户端或订阅服务的官方站点；后台按钮名称以订阅提供方实际页面为准。
| 你拿到的内容 | 常见特征 | 处理方式 |
|---|---|---|
| sing-box远程配置 | 提供方明确标注 sing-box、JSON 或 Remote | 优先直接添加为 Remote 配置 |
| Clash配置 | 常见为 YAML，可能出现 proxies、proxy-groups 等字段 | 不要直接当作 sing-box JSON，向提供方索取 sing-box 格式 |
| Base64订阅 | 打开后是一段编码文本，不能直接阅读为 JSON | 先确认提供方是否提供 sing-box 专用链接 |
| 单节点链接 | 只描述一个节点或一种协议 | 按客户端支持的单节点方式导入，不等同于完整订阅 |
sing-box官方文档说明其配置文件使用 JSON 结构，并提供配置校验相关能力。看到一个订阅链接，并不代表返回内容一定是可用的 sing-box 配置。可以在浏览器中查看响应内容或类型，但不要把包含完整参数的订阅链接发到公开群组或不可信网站。参考：sing-box官方配置结构说明。
Android：新增 Remote 配置并启动
- 在订阅提供方后台找到类似“订阅链接”“sing-box订阅”或“JSON订阅”的入口。页面没有明确标注时，不要仅凭链接外观猜格式。
- 复制完整链接，检查开头和结尾是否完整，避免把说明文字、空格或换行一起复制。
- 打开 sing-box Android 图形客户端，进入配置文件、Profiles 或类似配置管理入口。官方客户端列表将 Android、Apple 平台和 Desktop 客户端分开列出，具体应用入口以官方页面为准：sing-box官方图形客户端列表。
- 选择新增配置，类型选择 Remote，填写名称，把订阅地址粘贴到 URL 字段，然后保存或创建。不同版本可能显示为 Add、Create、Save 或加号。
- 回到配置列表，执行更新、刷新或拉取远程配置。保存 URL 不等于已经下载节点；列表为空时先查看更新结果和日志。
- 进入节点或分组页面，选择一个节点，再启动服务。首次启动通常需要允许 Android 建立 VPN 连接；如果拒绝权限，配置可能存在但系统流量不会进入 VPN。
- 先用普通代理方式验证网页或应用，再考虑 TUN、DNS 等进阶设置。官方文档将系统代理、防火墙重定向和虚拟接口视为不同代理方式，覆盖范围并不相同：sing-box官方客户端代理方式说明。
验证顺序：确认配置已更新、节点或分组不为空、服务状态为运行中，再分别测试普通网页和目标应用。一次网页打开成功，不能证明所有应用都已使用代理。
iPhone、iPad、Windows和macOS：按客户端类型处理
iPhone/iPad：在 Apple 平台图形客户端中添加远程配置，更新配置后选择节点并启动。首次启动需要允许系统添加 VPN 配置；如果没有允许，配置可能已经保存，但不会接管系统流量。官方说明显示，Apple 平台客户端可管理和运行本地或远程 sing-box 配置，并提供平台相关功能：sing-box Apple 平台客户端说明。
Windows：sing-box for Desktop 可管理和运行本地或远程配置，并提供包括 TUN 在内的平台功能。导入时选择远程配置或添加 URL，保存后更新，再选择节点并启动服务。若导入的是 JSON 文件，则属于本地配置，不是 Remote 订阅。Windows 系统要求和下载方式以官方说明为准：sing-box for Desktop官方说明。
macOS：先确认使用的是图形客户端还是命令行核心。图形客户端可以管理本地或远程配置；命令行核心则需要准备本地 JSON 文件，并先完成配置检查再运行。不要把“配置已经下载”当成“系统流量已经接管”，还要确认系统代理或 TUN 相关权限已启用。
如果客户端提示字段不支持，先记录报错字段，再更新到与配置要求匹配的客户端版本，或向提供方索取适配当前版本的 sing-box 配置。修改前保存原配置，不要删除唯一可回滚配置。
导入后怎么更新、选节点并理解 Rule、Global、Direct
订阅导入后通常还要完成“更新配置—选择分组或节点—启动服务”三步。更新解决远程内容是否拉取，选择节点决定当前流量使用哪个出站，启动服务决定系统或应用是否开始使用客户端。
| 模式 | 适合场景 | 排查用途 |
|---|---|---|
| Rule | 按配置中的规则分流 | 适合日常使用，但规则、DNS 和默认出站会共同影响结果 |
| Global | 暂时让大部分匹配流量使用指定节点 | 便于验证节点本身是否可用，但不代表所有系统流量都会被接管 |
| Direct | 停用代理路径，测试本地网络 | 用于判断问题来自本地网络，还是订阅、节点和客户端配置 |
以上是排查中的通用理解，不代表每个客户端的按钮名称完全相同。sing-box官方路由文档说明，route.final用于指定默认出站；为空时使用第一个出站。修改配置前先备份，出现问题时优先恢复原配置：sing-box官方路由配置文档。
导入失败和启动后无法联网：按错误现象分流
- JSON parse error：链接返回的不是合法 JSON，或复制内容不完整。重新获取明确标注为 sing-box 的链接，检查是否误用了 Clash、Base64 或网页地址；不要只改文件后缀。
- 字段不支持或版本不兼容：客户端核心版本可能无法识别配置字段。记录报错字段，更新客户端或向提供方索取适配版本的配置，不要随意删除未知字段。
- HTTP 403、404 或更新超时：检查链接是否过期、是否复制完整，以及当前网络能否打开该地址。浏览器同样无法获取内容时，问题更可能在订阅地址、权限或网络路径。
- 导入成功但节点为空：检查更新日志和返回内容，确认不是空文件、HTML 登录页或不兼容格式，再重新获取订阅链接。
- 启动后无法联网：先切换到 Direct 测试本地网络，再检查节点是否选中、Android 或 Apple 是否允许 VPN、Windows 或 macOS 是否启用了对应系统代理或 TUN 权限。不要一开始同时修改 DNS、MTU、TUN 和规则。
- 只有部分应用不通：系统代理并不覆盖所有应用协议，且可能存在 UDP 等流量限制。先用浏览器验证，再判断目标应用是否需要 TUN 或其他接管方式。相关代理方式差异可参考sing-box官方客户端说明。
订阅链接的安全操作与恢复顺序
订阅链接应按账号凭据对待：不要公开粘贴，不要上传到不可信的转换站，也不要把带完整参数的链接放进截图或工单。确实需要转换时，先确认提供方是否已经给出目标格式，优先使用本地工具或可信来源；如果链接已经泄露，应考虑重新生成。
- 导入前保存当前可用配置或截图记录。
- 一次只改一个变量，例如先换订阅格式，再测试；不要同时开启 TUN、修改 DNS 和调整 MTU。
- 记录报错原文、客户端版本、系统版本和更新时间。
- 无法恢复时，删除新建的 Remote 配置，恢复备份配置，再分别测试 Direct 和普通代理。
本文不对任何具体订阅服务的可用性、速度、价格或稳定性作结论，相关信息应以服务提供方页面和实际测试结果为准。
常见问题
sing-box可以直接导入Clash订阅吗？
不能默认直接导入。Clash订阅通常是 YAML，而 sing-box 配置使用 JSON。只有提供方明确说明兼容，或经过可核验的转换并生成合法 sing-box 配置时，才应尝试导入。
为什么Remote配置保存后没有节点？
保存 URL 只代表记录了远程地址，还需要执行更新或刷新。若更新后仍为空，检查链接是否过期、是否返回登录页或错误页，以及是否误用了其他格式订阅。
sing-box启动了但手机或电脑无法联网怎么办？
先停止服务或切换 Direct，确认本地网络正常；随后检查是否选中了节点、移动设备是否允许 VPN、Windows 或 macOS 是否启用了对应系统代理或 TUN 权限。一次只改一个设置。
订阅链接可以发给别人帮忙转换吗？
不建议。订阅链接可能包含获取配置所需的权限信息，不应公开分享或上传到不可信网站。优先向提供方索取 sing-box 格式，必要时使用本地或可信工具，并在泄露后重新生成链接。