sing-box 订阅导入教程：从复制链接到启动连接
简答：先确认你拿到的是可直接返回 sing-box JSON 配置的远程链接，而不是普通文本或其他客户端专用订阅。然后在对应客户端的 Profiles/配置页面新建 Remote，填写名称和 URL，保存后刷新配置、选择节点并启动服务；如果失败，优先检查链接格式、返回内容、VPN 权限和其他网络工具冲突。
定义：sing-box 订阅导入，是把服务方提供的远程配置 URL 添加为 sing-box 的 Remote Profile，并由客户端下载、保存、更新和运行该配置。
先判断订阅链接能不能直接导入
不要一看到“订阅链接”就直接粘贴。sing-box 官方将 Remote Profile 定义为“以 URL 作为更新来源的远程 sing-box 配置”，客户端需要能够读取这类远程配置并支持自动更新；官方文档还列出了用于导入远程配置的 URL Scheme。查看 sing-box Remote Profile 说明
| 你拿到的内容 | 常见特征 | 建议操作 |
|---|---|---|
| sing-box JSON 配置 | 打开后是 JSON 对象，通常能看到 inbounds、outbounds、route 或 dns 等字段 | 可尝试作为 Remote URL 导入 |
| Clash YAML | 内容以 YAML 结构为主，常见 proxies、proxy-groups 等字段 | 不要直接当作 sing-box JSON；先向服务方索取 sing-box 格式 |
| Base64 或纯文本订阅 | 打开后是一长段编码文本，或每行一个节点链接 | 不能据此确认可直接被 sing-box 读取，需服务方提供兼容配置 |
| 单节点链接 | 只包含一个协议链接，而不是完整配置文件 | 通常需要手动转换为 sing-box 配置，不能当作完整订阅使用 |
如果你无法判断格式，先在浏览器中打开链接，但不要把完整内容公开发送。页面返回 JSON，不等于其中的节点一定可用；它只说明下载阶段可能成功，后续仍要检查配置解析、节点选择和连接日志。
按三步导入 Remote 配置
- 先备份或新建测试配置。
如果客户端里已经有可用配置，不要先删除。保留原配置，使用一个容易识别的名称，例如“测试订阅”，方便失败后切回原配置。
- 打开配置管理页面。
在 sing-box 图形客户端中进入 Profiles、配置或类似页面，选择新增配置，再选择 Remote/远程配置类型。官方通用客户端文档明确说明，Remote Profile 需要一个作为更新来源的 URL；不同系统的按钮名称可能不同，应以当前客户端界面为准。
- 填写名称和 URL 并保存。
名称可以填写服务方或用途，URL 粘贴订阅地址，确认没有多余空格、换行或被聊天软件截断。自动更新选项如果存在，可以先保持默认；官方文档说明远程配置支持自动更新，默认更新间隔为 60 分钟，但具体客户端是否提供可编辑的间隔和界面选项，需以当前版本为准。保存后执行一次手动刷新。
如果客户端支持官方定义的导入 URL Scheme，也可以使用形如 sing-box://import-remote-profile?url=经过编码的URL#经过编码的名称 的链接唤起导入；不要手动拼接未经 URL 编码的特殊字符，实际支持情况以当前客户端为准。查看官方导入格式说明
Android 客户端官方文档确认其用途包括管理和运行本地或远程 sing-box 配置文件；Android 设备首次启动图形客户端时，还可能需要授予系统 VPN 权限。查看 Android 客户端文档
Windows、macOS、iOS 和 Android 怎么操作
不同系统的客户端入口不完全相同，但判断逻辑一致：添加 Remote、下载配置、确认解析、选择节点、启动服务。官方客户端列表目前按平台区分 Android、Apple 平台以及 Windows/Linux 桌面客户端；第三方图形界面可能使用不同的菜单名称，不能把一个客户端的截图步骤直接套用到另一个客户端。查看官方图形客户端列表
| 设备 | 导入思路 | 启动前检查 |
|---|---|---|
| Android | Profiles/配置 → 新增 → Remote → 粘贴 URL → 保存并更新 | 选择配置和节点后启动，按系统提示授予 VPN 权限；检查省电策略是否限制后台运行 |
| iOS | 进入配置或 Profiles 页面 → 新增远程配置 → 粘贴 URL → 保存 | 启动时允许系统添加 VPN 配置；界面名称和商店版本需以当前页面为准 |
| macOS | 在图形客户端配置管理页面新增 Remote 配置 | 确认系统网络扩展或代理权限已允许，避免同时运行多个代理客户端 |
| Windows | 在桌面客户端的配置页面新增远程配置；若客户端没有 Remote 入口，不要猜测配置文件路径 | 确认系统代理或 TUN 模式只由一个客户端接管，并查看日志中的配置解析结果 |
如果服务方后台提供多个格式选项，优先选择明确写有 sing-box、JSON 或完整配置的链接。ViewTurbo 等服务的后台按钮、订阅分类和链接格式未在本次公开资料中核实，具体入口应以服务方当前页面为准。
导入后没有节点、更新失败或启动后无网络
- 配置列表为空或保存失败：重新复制 URL，确认没有复制标题文字；用浏览器或命令行检查 URL 是否能返回内容。不要在公开平台粘贴完整订阅，因为其中可能包含账号凭据。
- 提示 JSON 错误或字段不支持：先停止服务，保留原配置，再查看下载到的内容是否实际为 JSON。若返回的是 HTML 错误页、Clash YAML、Base64 文本或登录页面，应向服务方索取 sing-box 兼容格式；不要直接删除所有配置。
- 导入成功但没有节点：先确认配置是否包含 outbounds 或节点组，再执行一次手动更新。节点组为空可能是订阅内容没有成功下载，也可能是客户端不支持配置中的字段；需要结合日志区分下载失败和解析失败。
- 节点能显示但启动后无网络：先确认系统 VPN、代理或网络扩展权限，再暂时关闭其他代理客户端，重新启动 sing-box。不要一开始就修改 DNS、MTU 或删除配置，因为这些改动无法区分根因。
- 网页打不开但日志显示已连接：分别测试 DNS 解析、代理握手和网页加载。一次延迟返回只能说明某个测试包有响应，不能直接证明节点可用；可更换一个节点后重复测试，并记录错误日志。
sing-box 官方文档将系统代理、虚拟接口和防火墙重定向视为不同的客户端工作方式；因此“客户端已启动”与“所有应用都能联网”不是同一个结论。查看官方客户端工作方式说明
可回滚做法：停止服务 → 切回原来的配置 → 恢复系统代理或 VPN 设置 → 再单独测试新 Remote 配置。只有在旧配置确认可恢复后，才考虑清理失败配置。
订阅链接的安全使用清单
- 不要把完整订阅 URL 发到公开群组、Issue、截图或在线转换页面。
- 订阅地址如果包含 token、用户标识或其他认证信息，应当按密码处理。
- 优先使用 HTTPS URL；如果服务方只提供 HTTP，先确认风险和来源，不要默认安全。
- 不要把“能下载配置”误认为“节点稳定”或“服务正常”。下载、解析、节点握手和网页加载应分别判断。
- 更新失败时先保留旧配置和日志，再尝试刷新；不要在没有备份的情况下删除全部配置。
如果你使用的是服务方提供的订阅，订阅格式、有效期、节点内容和后台入口都应以官方为准。本页只说明 sing-box 客户端的通用导入与排查方法。
常见问题
sing-box 可以直接导入 Clash 订阅吗？
不能仅凭“订阅链接”四个字确认兼容。Clash YAML、Base64 文本和 sing-box JSON 是不同格式；如果返回内容不是 sing-box 配置，优先向服务方索取 sing-box 格式，或使用明确可信且不会泄露订阅凭据的转换方案。
Remote 配置里的 URL、名称和自动更新怎么填？
URL 填服务方提供的远程配置地址，名称只用于本地识别，建议写成“用途+设备”或“测试订阅”。自动更新可以先使用客户端默认值；官方通用文档说明 Remote Profile 支持自动更新，但具体按钮和间隔仍以当前客户端为准。
订阅导入成功但节点列表为空怎么办？
先执行手动刷新并查看日志，确认下载结果不是登录页或错误页；再检查配置是否包含节点出站或节点组。如果仍为空，可能是订阅格式不匹配、配置字段不受当前客户端支持，或服务方返回内容不完整。
启动 sing-box 后为什么手机或电脑没有网络？
先确认系统 VPN、网络扩展或代理权限，再关闭其他代理客户端并重新启动。随后区分 DNS 解析、节点握手和网页加载三个环节，不要只根据“已连接”状态判断全部网络可用。
可以把订阅链接发给别人帮忙转换吗？
不建议。订阅链接可能包含可识别账号或访问凭据；如必须排查，先删除敏感参数或使用脱敏后的示例配置，并以服务方和客户端的安全说明为准。