TAG官网 - TAG VPN套餐价格 | Bronze、Silver、Gold计划 - TAG Pro网络加速返回首页

sing-box 订阅链接怎么转换成配置?格式判断、转换与导入步骤

更新于 2026-11-09 · tagss11.buzz

简答:先不要改文件后缀: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 和策略组能否保留,取决于输入格式与转换器支持情况。

  1. 从订阅页面复制链接,但不要把完整链接发到聊天、工单或截图中。订阅地址可能包含访问凭据。
  2. 先在本机下载原始内容,确认它不是 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。
  3. 查看响应头和文件开头:Get-Content .\response_headers.txt,再执行 Get-Content .\raw_subscription.txt -TotalCount 20。如果看到 403、404、登录页面、HTML 标签或 JSON 错误对象,应先修复链接权限。
  4. 按转换器文档下载源码并构建。其命令行示例为:make build,随后使用 bin/subscription-converter convert -input raw_subscription.txt -from auto -to sing-box -output config.json。-from auto 用于让工具识别输入;如果识别失败,可根据实际内容改用 -from clash 或 -from base64。
  5. 转换完成后先查看警告输出。警告可能表示节点被跳过、字段无法映射或规则没有完整保留,不应只看是否生成了 config.json。
  6. 使用 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 的场景。

相关阅读

参考资料

  1. sing-box 官方配置说明:JSON 结构、check、format 与 merge
  2. sing-box 官方 Route 配置说明:route.final 与默认出站
  3. sing-box 官方 URLTest 配置说明:outbound 标签与测试地址
  4. sing-box 官方桌面客户端说明
  5. sing-box 图形客户端通用说明:本地配置与远程配置
  6. subscription-converter:Clash、Mihomo 与 Base64 订阅转 sing-box 配置的公开源码项目