subsing

subsing 将带有 provider 扩展字段的伪 sing-box 配置转换成原版 sing-box 配置。它只执行一次下载和展开，不提供缓存、定时更新、下载路由、健康检查或拨号/TLS 覆写。

构建和运行

make build
./subsing [--skip-existing] <输入目录> <输出目录>

也可以使用 Docker：

docker build -t subsing:latest .
docker run --rm \
  --volume ./input/config.json.template:/workdir/config.json \
  --volume ./output:/processed \
  subsing:latest

docker run --rm \
  --volume ./input/config.json.template:/workdir/config.json \
  --volume ./output:/processed \
  ghcr.io/sorubedo/subsing:latest

程序只处理输入目录当前层的 .json、.jsonc 普通文件，并按文件名顺序逐个转换、直接覆盖输出目录中的同名文件。输出目录不存在时会自动创建；已有目录不会被删除或重建，其中没有对应输入的其他文件会原样保留。如果处理中途失败，此前成功写入的文件也会保留。输入和输出可以指向同一目录，以便直接修改原配置。

--skip-existing 在解析前先检查输出目录是否已有同名文件，有则跳过，不下载、不解构、不覆盖。

环境变量替换

配置在转换前会先进行环境变量替换：形如 ${变量名} 的占位符会被替换为对应环境变量的值。变量名 只能由字母、数字和下划线组成，且必须以字母或下划线开头。

{
  "inbounds": [{
    "type": "mixed",
    "listen": "${LISTEN_ADDR}",
    "listen_port": "${LISTEN_PORT}"
  }]
}

若 ${LISTEN_ADDR} 未设置，则替换为空字符串；若 LISTEN_PORT=1080，则 listen_port 会被替换为 1080。

扩展配置

顶层远程 provider：

{
  "_providers": [
    {
      "type": "remote",
      "tag": "airport",
      "url": "https://example.com/subscription",
      "exclude": "到期|流量",
      "include": "香港|日本",
      "user_agent": "clash.meta"
    }
  ]
}

type 必须为 remote，tag 必须非空且在配置内唯一，url 必须为绝对 HTTP(S) URL。exclude/include 是 Go 正则表达式，匹配订阅中的原始节点名。

selector/urltest 引用 provider：

{
  "type": "selector",
  "tag": "proxy",
  "outbounds": ["direct"],
  "_providers": ["airport"],
  "_exclude": "实验",
  "_include": "airport/",
  "_use_all_providers": false
}

节点最终命名为 providerTag/nodeName，重复名称依次添加 (2)、 (3)。普通节点追加到顶层 outbounds，WireGuard/Tailscale 追加到顶层 endpoints，组的 outbounds 会引用相应 tag。输出时会删除所有已识别的下划线扩展字段。转换器会检查扩展字段、标签冲突和组引用，但不会加载完整 sing-box 协议实现来校验最终配置；需要时可另行运行 sing-box check -c <配置文件>。

支持 Clash/Mihomo YAML、SIP008、明文或 Base64 URI 列表，并额外以原始对象方式处理 sing-box JSON 订阅。输出会保留原配置中 JSON 对象字段和数组元素的顺序，但 JSONC 注释、空白和原排版不会保留。