subconverter 订阅转换完全指南 2026：自建 Docker 部署 + pref 配置 + 多客户端格式输出 + sub-store 现代方案

一、为什么需要订阅转换#

直接把机场订阅丢进客户端，绝大多数情况下都用不顺。原因有五：

二、subconverter 是什么：工作原理#

subconverter 是一个订阅「中转处理」服务。它不生产节点，只做节点的「搬运 + 加工」：

1
         订阅URL（机场/原始链接）
2
                  │
3
                  ▼
4
   ┌─────────────────────────────┐
5
   │   subconverter（本地/自建）   │
6
   │   1. 拉取原始订阅             │
7
   │   2. 按 pref 配置处理：       │
8
   │      加emoji / 重命名 / 去广告  │
9
   │      过滤节点 / 注入规则集      │
10
   │   3. 转换成目标格式           │
11
   └─────────────────────────────┘
12
                  │
13
                  ▼
14
   输出：Clash / sing-box / SSR / Quantumult X ...
15
                  │
16
                  ▼
17
            导入客户端直接用

核心就三步：拉取 → 处理 → 输出。处理规则写在 pref 配置文件里，输出格式通过 URL 的 target 参数指定。

三、在线转换的隐患：必须自建/本地优先#

网上有很多「一键订阅转换」网页。方便，但有代价：

• 节点泄露：转换服务在服务端能完整拿到你的节点（服务器、端口、密码、UUID）。作恶或数据库泄露 = 节点被滥用 + 被精准封锁。
• 规则投毒：恶意服务可能在转换时往配置里塞它自己的节点或劫持规则。
• 订阅失效：在线服务随时跑路，转换链接就废了。

安全底线

生产环境一律自建 subconverter（一个 Docker 容器，内存占用几十 MB，跑在本地或自己的 VPS 上）。临时救急用在线服务可以，但转完立刻删掉配置、别保存转换链接。

四、自建部署：Docker Compose 部署 subconverter#

官方镜像叫 stillnesszwm/subconverter 或社区维护的 tindy2013/subconverter。下面用 Compose 跑一个本地实例。

1
mkdir -p ~/subconverter && cd ~/subconverter
2
mkdir -p data/base data/config data/template

1
version: "3"
2
services:
3
  subconverter:
4
    image: stillnesszwm/subconverter:latest
5
    container_name: subconverter
6
    restart: unless-stopped
7
    ports:
8
      - "25500:25500"
9
    volumes:
10
      - ./data/base:/base
11
      - ./data/config:/config
12
      - ./data/template:/template
13
    environment:
14
      - TZ=Asia/Shanghai

1
docker compose up -d
2
# 验证
3
curl http://localhost:25500
4
# 返回 "SubConverter" 即成功

五、pref 配置详解#

subconverter 的行为由 pref.toml（或 pref.ini）控制，放在 data/config/ 里。下面逐参数说明最常用的：

1
api_mode = true
2
backend = "https://api.dler.io"   # 默认后端，自建时可用本地或公共后端
3
default_url = ""                  # 默认订阅（留空则每次用 url 参数指定）
4
default_target = "clash"          # 默认输出格式
5

6
# 节点名美化
7
emoji = true                      # 加国旗 emoji
8
emoji_char = "🚀"                 # 自定义前缀 emoji
9
remove_old_emoji = true           # 先清掉原节点名里的 emoji 再处理
10
append_proxy_type = false         # 是否在节点名后追加类型（如 [Trojan]）
11

12
# 连接特性
13
udp = true                        # 启用 UDP 转发
14
skip_cert_verify = false          # 是否跳过证书校验（默认 false，更安全）
15
expand = true                     # 展开为多条规则
16
clash_new_field = true            # 输出 Clash.Meta 新字段（rule-providers 等）
17

18
# 节点增删
19
enable_insert = false             # 是否插入额外节点
20
insert_url = ""                   # 要插入的额外订阅
21
common_rules = ""                 # 通用规则文件路径
22

23
base_path = "sub"                 # 访问基础路径
24
api_short_url = false             # 是否用短链
25
strict_mode = false               # 严格模式

六、转换 API 与参数#

subconverter 的转换本质是拼一个 URL。格式：

1
http://<host>:25500/sub?target=<格式>&url=<订阅链接>&emoji=true&udp=true&append_proxy_type=true

七、实战一：机场订阅 → Clash Meta 配置#

假设机场给你一个 Clash 格式订阅，你想转成「带 emoji + mihomo 新字段 + 国内直连规则」的配置：

1
http://localhost:25500/sub?target=clash&url=<URL编码的订阅>&emoji=true&udp=true&clash_new_field=true&append_proxy_type=false

把返回的 YAML 保存为 config.yaml，导入 Clash Verge Rev / mihomo 即可。

1
# 在 config.yaml 末尾追加
2
rule-providers:
3
  reject:
4
    type: http
5
    behavior: domain
6
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/reject.txt"
7
    path: ./ruleset/reject.yaml
8
    interval: 86400
9
  icloud:
10
    type: http
11
    behavior: domain
12
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/icloud.txt"
13
    path: ./ruleset/icloud.yaml
14
    interval: 86400
15
  proxy:
16
    type: http
17
    behavior: domain
18
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/proxy.txt"
19
    path: ./ruleset/proxy.yaml
20
    interval: 86400
21
  direct:
22
    type: http
23
    behavior: domain
24
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/direct.txt"
25
    path: ./ruleset/direct.yaml
26
    interval: 86400
27
  lancidr:
28
    type: http
29
    behavior: ipcidr
30
    url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/clash-rules@release/lancidr.txt"
31
    path: ./ruleset/lancidr.yaml
32
    interval: 86400

八、实战二：机场订阅 → sing-box 配置#

sing-box 用 JSON 格式，target 换成 singbox：

1
http://localhost:25500/sub?target=singbox&ver=2&url=<URL编码的订阅>&emoji=true&udp=true

注意 sing-box 版本差异较大，用 singbox&ver=2（对应 1.8+ 的路由/outbound 结构）或 singbox&ver=3（最新版）匹配你客户端版本。不确定的话，打开 sing-box 客户端看它要求的订阅格式提示。

把生成的 JSON 存为 config.json，在 sing-box 客户端里加载即可。详见 《sing-box 全平台使用教程》。

九、实战三：机场订阅 → Shadowrocket / Quantumult X#

1
http://localhost:25500/sub?target=surge%26ver=4&url=<URL编码的订阅>&emoji=true

1
http://localhost:25500/sub?target=quan&url=<URL编码的订阅>&emoji=true&udp=true

十、sub-store：更现代的订阅管理方案#

如果你觉得 subconverter 的 pref + URL 参数不够灵活，可以看 sub-store——一个带 Web 界面的订阅管理面板，核心优势是「脚本化」：

• JavaScript 脚本处理：可以用 JS 对节点做任何处理（批量改名、按正则分组、按延迟排序、注入自定义字段）。
• 多订阅聚合：把一个面板里管理多家机场，统一输出。
• 本地运行：同样可 Docker 部署，数据在自己手里。
• Web UI：可视化编辑、预览、一键复制。

1
# sub-store 最简 Compose（示意）
2
services:
3
  sub-store:
4
    image: stillnesszwm/sub-store:latest
5
    container_name: sub-store
6
    restart: unless-stopped
7
    ports:
8
      - "3001:3001"
9
    volumes:
10
      - ./data:/data

sub-store 适合进阶用户：需要按延迟自动选优、批量把节点改成中文名、按地区/运营商分组、对同一份订阅做多种输出。普通用户用 subconverter 已经足够。

两者如何选

• 只想「一键把机场订阅变成 Clash/sing-box 配置」→ subconverter（简单、稳定）。
• 想精细控制节点、写脚本、聚合多机场、有 Web 界面 → sub-store（灵活、强大）。
• 实战中很多人两者并存：sub-store 管订阅，subconverter 做最终格式转换。

十一、常见问题排错#

十二、安全与隐私建议#

1. 自建优先：subconverter / sub-store 都跑在自己机器或 VPS 上，订阅链接不外泄。
2. 别存转换链接：转换出的配置导入客户端后，删掉浏览器里的转换 URL。
3. SSH 端口转发：本地用 ssh -L 25500:localhost:25500 访问 VPS 上的 subconverter，端口不暴露公网。
4. 公网开放必加 auth：Nginx 反代 + Basic Auth 或 Token，避免被扫到滥用。
5. 定期换订阅：机场订阅有泄露风险，定期在机场后台「重置订阅链接」。

十三、总结与延伸阅读#

subconverter 是「机场订阅 → 可用配置」这条链路上不可或缺的加工站：它把杂乱的原始订阅，变成带 emoji、带规则、带去广告的「开箱即用」配置，并能在 Clash / sing-box / Shadowrocket / Quantumult X 之间自由转换。自建一份只需一个 Docker 容器，安全和灵活性都远胜在线服务。

想要更精细的订阅管理，再上 sub-store 用脚本做任意处理。两者配合，订阅这件事就彻底解决了。

延伸阅读（形成完整闭环）：

• 《mihomo（Clash Meta）完全配置指南》 —— 转换出的 Clash 配置怎么深度调
• 《sing-box 全平台使用教程》 —— sing-box 客户端怎么用
• 《Clash Verge Rev 进阶配置完全指南》 —— 分流规则与性能调优
• 《Quantumult X 配置完全指南》 —— iOS 高级代理客户端
• 《Shadowrocket 新手使用教程》 —— iOS 小火箭基础