sing-box 订阅链接怎么转换成配置?格式判断、转换与导入步骤
简答:先不要改文件后缀:sing-box 订阅链接可能已经返回可用 JSON,也可能只是 Clash/Mihomo YAML、Base64 节点列表或单条 URI。最快的处理顺序是查看返回内容→优先获取 sing-box 专用 JSON→没有时使用本地转换工具→运行 sing-box check→再导入客户端验证节点、代理和实际流量。本文适用于已安装 sing-box 或使用支持本地/远程配置的客户端;具体菜单名称以当前客户端文档为准。
定义:sing-box 订阅转换,是把服务商返回的远程配置、YAML、Base64 或节点 URI 整理为 sing-box 可读取的 JSON 配置;改名为 .json 不会改变原始内容,也不等于生成了可接管流量的完整配置。
先做这一步:5 类输入格式怎么处理
先查看订阅链接实际返回的内容,再决定是否转换。sing-box 官方配置文件使用 JSON,并提供 check、format 和 merge 命令;因此“文件能打开”“JSON 语法正确”“sing-box 能启动”“应用流量确实经过代理”是四个不同层级。参见 sing-box 官方配置说明。
| 返回内容 | 通常是什么 | 处理方式 | 成功判据 |
|---|---|---|---|
JSON 对象,含 outbounds、route 等字段 | 可能是完整 sing-box 配置 | 先保存为 JSON,运行 sing-box check,再导入 | 检查通过,客户端能读取配置 |
文本中有 proxies:、proxy-groups: | Clash/Mihomo YAML | 使用服务商提供的 sing-box 输出;没有时本地转换 | 转换后有可用出站,并检查路由和标签引用 |
| 一长段 Base64 文本 | 编码后的节点 URI 列表 | 先解码,再按 URI 列表转换 | 解码结果是节点文本,而非 HTML 或错误页 |
vless://、vmess://、ss:// 等 | 单个或多个节点 URI | 作为节点输入转换,不能直接当完整配置 | 协议、服务器、端口、认证和必要传输字段完整 |
| HTML、登录页、403、404 或错误对象 | 链接失效、权限不足或被重定向 | 重新复制授权链接,不要改后缀硬转 | 重新请求获得预期的 JSON、YAML 或节点文本 |
先记住:如果服务页面已经提供 sing-box、JSON 或远程配置选项,优先使用该输出。部分客户端或服务页面可能把远程配置称为 Remote Profile、远程配置或类似名称,但这些名称并不通用,应以当前客户端文档为准。
可复现的本地转换:Clash/Mihomo YAML 转 sing-box JSON
sing-box 核心本身负责读取和校验 sing-box 配置,并不等于自带所有第三方订阅格式转换功能。要把 Clash/Mihomo YAML 或 Base64 URI 转为 sing-box JSON,可以使用公开源码的本地转换工具;下面以 GitHub 上的 subscription-converter 为例。该项目文档列出了 auto、base64 和 clash 输入方式,并支持输出 sing-box 配置;使用前应查看项目当前说明、依赖和兼容性。
适用范围:本流程适合愿意使用命令行、能够安装 Go 环境,并且输入是 Clash/Mihomo YAML、Base64 或本地节点文件的读者。它不是把任意网页链接自动变成完整配置;协议字段、规则、DNS 和策略组能否保留,取决于输入格式与转换器支持情况。
- 从订阅页面复制链接,但不要把完整链接发到聊天、工单或截图中。订阅地址可能包含访问凭据。
- 先在本机下载原始内容,确认它不是 HTML 或登录页。Windows PowerShell 示例:
$env:SUB_URL = Read-Host "请输入订阅地址",然后执行curl.exe -L --fail --silent --show-error -D response_headers.txt "$env:SUB_URL" -o raw_subscription.txt。 - 查看响应头和文件开头:
Get-Content .\response_headers.txt,再执行Get-Content .\raw_subscription.txt -TotalCount 20。如果看到 403、404、登录页面、HTML 标签或 JSON 错误对象,应先修复链接权限。 - 按转换器文档下载源码并构建。其命令行示例为:
make build,随后使用bin/subscription-converter convert -input raw_subscription.txt -from auto -to sing-box -output config.json。-from auto用于让工具识别输入;如果识别失败,可根据实际内容改用-from clash或-from base64。 - 转换完成后先查看警告输出。警告可能表示节点被跳过、字段无法映射或规则没有完整保留,不应只看是否生成了
config.json。 - 使用 sing-box 校验:
sing-box check -c config.json。没有配置错误只说明当前 sing-box 能接受该配置,不能证明节点可用或应用流量已经接管。
macOS 或 Linux 也可以使用相同的转换命令。若订阅地址只用于本次下载,可在请求完成后执行 unset SUB_URL;但终端历史、下载文件、代理日志和 shell 记录仍可能保留敏感信息,处理完成后应删除原始文件并按订阅提供方的功能重置令牌。
最小清理示例:Windows 可执行 Remove-Item .\raw_subscription.txt, .\response_headers.txt -Force;macOS/Linux 可执行 rm -f raw_subscription.txt response_headers.txt。删除文件不能撤销已经提交到第三方服务的链接,因此含长期令牌的订阅不建议直接上传在线转换站。
Base64、单条 URI 和节点片段:为什么不能直接当完整配置
转换前要区分“节点数据”和“运行配置”。完整 sing-box 配置的顶层结构可以包含 dns、inbounds、outbounds、route 等部分;但具体是否需要 inbounds,取决于使用方式:导出节点、远程配置、系统代理和 TUN 的要求并不完全相同。官方结构说明见 配置文档。
- 完整 JSON:可能已经包含 DNS、入口、出站和路由,可先检查再导入。
- 仅有 outbounds 的 JSON:通常是节点或出站片段,可能需要合并到已有配置,不能假定它能直接接管系统流量。
- Base64:先解码为一条或多条 URI,再按转换器支持的格式处理;不能把 Base64 字符串直接保存为 JSON。
- 单条 URI:只描述一个节点。转换时还要确认协议专用字段,例如传输方式、TLS、认证和服务器名称是否完整。
- Clash/Mihomo YAML:除了节点,还可能含代理组、规则、DNS 和规则提供者;转换后这些部分是否保留,要看具体工具和输入字段。
如果生成的配置使用 selector 或 urltest,其 outbounds 列表必须引用真实存在的标签。官方 URLTest 文档明确要求填写要测试的 outbound 标签;相关说明见 URLTest 配置文档。
校验配置:分别判断语法、启动和实际流量
建议按以下三个层级验证,而不是把“导入成功”当成全部完成:
| 层级 | 操作 | 能证明什么 | 不能证明什么 |
|---|---|---|---|
| JSON 语法与配置结构 | sing-box check -c config.json | 当前程序能够解析并接受配置 | 不能证明节点可用、DNS 正常或应用会走代理 |
| 格式整理 | sing-box format -w -c config.json | 按 sing-box 规则整理 JSON | 不会自动补齐缺失节点、入口、路由或协议参数 |
| 启动与出站 | 启动客户端,查看日志和连接记录 | 配置被加载,出站是否产生连接 | 不能证明所有应用、所有域名或所有节点都正常 |
| 实际任务 | 使用目标应用访问目标服务,并检查 DNS、路由和连接记录 | 当前测试条件下任务链路是否完成 | 不能据此推断长期稳定性或其他网络环境结果 |
路由默认出口需要特别检查。官方 Route 文档说明,route.final 是默认 outbound 标签;如果为空,则使用第一个 outbound。因此,转换后应确认 route.final 指向真实存在的标签,或确认第一个 outbound 确实符合预期。参见 官方 Route 配置文档。
如果校验失败,先处理 JSON 语法、未知字段、缺少协议参数和不存在的 tag;如果校验通过但没有网络,再按入口、代理端口、DNS、路由和 TUN 分层处理。启用 TUN 前保留旧配置,出现断网时先停止服务、关闭系统代理或 TUN,确认普通网络恢复后再继续修改。
远程配置、本地 JSON 和在线转换怎么选
| 方式 | 适合场景 | 主要限制 | 建议 |
|---|---|---|---|
| 服务页面直接提供 sing-box JSON | 想保留服务页面生成的配置与更新机制 | 是否提供取决于具体服务页面 | 优先选择,先查看返回内容并运行 check |
| 本地转换 | 输入是 YAML、Base64 或 URI,且包含访问令牌 | 需要安装工具,字段映射可能不完整 | 保留原始文件和旧配置,查看转换警告 |
| 在线转换 | 临时测试、非敏感样本 | 订阅地址可能经过第三方系统 | 不要提交长期主订阅;优先使用临时链接并在测试后重置 |
| 客户端远程配置 | 客户端直接按 URL 更新 JSON | 依赖网络、权限和客户端更新机制 | 同时保留本地可回滚副本 |
客户端中的本地配置、远程配置和节点导入不是同一个概念。官方图形客户端说明将本地配置与以 URL 为更新来源的远程配置分开处理,具体菜单名称可能因客户端和平台不同而变化,参见 sing-box 图形客户端说明。
无论使用 Windows、macOS、Linux、Android 还是 iOS,推荐遵循同一顺序:添加本地或远程配置→读取或更新→选中配置→启动服务→按需开启系统代理或 TUN→查看日志和实际连接。桌面端的功能边界可参考 sing-box 桌面客户端说明;菜单名称和权限提示仍应以当前客户端为准。
转换失败、节点减少和无法联网的排查清单
- 下载后是 HTML:检查 HTTP 状态、重定向后的内容和订阅权限,不要改成
.json。 - Base64 解码后为空或乱码:确认输入确实是编码节点列表,而不是登录页、压缩文件或错误信息。
- 节点数量减少:检查转换器是否支持对应协议和字段;是否保留节点取决于输入格式与具体转换器,不能仅凭文件生成成功下结论。
- check 报未知字段:确认配置与当前安装的 sing-box 版本匹配,删除或改写不被当前版本接受的字段。
- 没有可用节点:查看
outbounds是否为空,或策略组是否引用不存在的 tag。 - 能启动但应用无流量:检查是否存在合适的 inbound,系统代理是否指向实际监听端口,
route.final是否指向有效出站。 - 域名打不开:检查 DNS 服务器、DNS 规则和路由;不要仅凭一次 IP 请求成功判断 DNS 已正常。
- 开启 TUN 后断网:先关闭 TUN 或停止服务恢复网络,再单独验证基础出站、DNS 和路由。
完整闭环可以压缩为:获取链接→查看响应→识别格式→优先使用 sing-box JSON→必要时本地转换→运行 sing-box check→导入本地或远程配置→先验证出站,再验证代理、DNS、路由和目标应用。
常见问题
sing-box 订阅链接可以直接导入吗?
只有当链接返回 sing-box 能读取的 JSON 配置,或当前客户端明确支持该格式时,才适合直接导入。Clash/Mihomo YAML、Base64 和单条 URI 应先识别,再选择服务页面输出或本地转换。
把订阅文件后缀改成 .json 有用吗?
没有。扩展名不会改变内容;HTML、登录页、Base64 文本或 YAML 改名后仍然不是 JSON。应先查看文件开头和响应头,再进行实际转换。
为什么转换后有节点,但启动后没有网络?
节点数据不一定包含入口、默认路由、DNS 或系统接管设置。先运行 sing-box check,再检查 inbound、代理端口、route.final、DNS 和 TUN;必要时先关闭 TUN,用本地代理模式验证基础连接。
在线转换订阅链接安全吗?
不能默认认为安全。订阅地址可能包含访问令牌,提交后可能经过第三方系统。优先使用服务页面直接生成的 sing-box 配置,或在本机转换;必须在线测试时,使用临时链接并在结束后重置令牌。
sing-box check 通过后就一定能联网吗?
不一定。check 主要验证当前程序能否接受配置,不能证明节点可用、DNS 可达、系统代理已经生效或目标应用会走正确路由。还要查看启动日志、连接记录,并用实际应用完成测试。
远程配置和本地 JSON 有什么区别?
本地 JSON 读取设备上的文件,适合本地转换和手动修改;远程配置以 URL 作为更新来源,适合已经有可用远程 JSON 的情况。使用远程配置时,建议保留一份本地副本,便于更新失败或配置异常时回滚。
常见问题
sing-box 订阅链接可以直接导入吗?
只有返回内容已经是 sing-box 可读取的 JSON,或客户端明确支持该格式时才适合直接导入。Clash/Mihomo YAML、Base64 和单条 URI 应先识别。
把订阅文件后缀改成 .json 有用吗?
没有。扩展名不会改变内容;HTML、登录页、Base64 或 YAML 改名后仍然不是可运行的 sing-box JSON。
为什么转换后有节点,但 sing-box 启动后没有网络?
节点列表不一定包含入口、DNS、默认路由或系统接管设置。应依次检查 check、outbounds、route.final、代理端口、DNS 和 TUN。
在线转换订阅链接安全吗?
不能默认认为安全。订阅地址可能包含访问令牌,优先使用服务页面直出或本地转换;在线测试应使用临时链接,并在结束后重置令牌。
sing-box check 通过后就一定能联网吗?
不一定。check 只说明当前程序能够接受配置,还需要验证节点、代理入口、DNS、路由和目标应用的实际流量。
远程配置和本地 JSON 有什么区别?
本地 JSON 从设备文件读取,适合本地转换和手动修改;远程配置以 URL 作为更新来源,适合已有可用远程 JSON 的场景。
相关阅读
- 继续看 sing-box 从安装到导入后的完整使用与连接验证
- 如果已经导入但订阅不生效,按内容、启动和流量三步排查
- 如果启动后没有网络,继续检查 TUN、DNS 和路由
- 配置生效后,再学习如何按延迟、速度和测试条件筛选节点