Subconverter 外部配置

自 v2.3.0 起，Sublink Worker 支持将内置规则系统导出为 Subconverter 外部配置（INI 格式）。

为什么需要这个功能？

Sublink Worker 的前端页面会暴露所有配置并保存用户粘贴的订阅链接。对于隐私敏感的用户，可以：

1. 仅利用 Sublink Worker 的规则系统生成外部配置地址
2. 将实际的订阅转换交给自行部署的 Subconverter 后端完成
3. 订阅链接不经过 Sublink Worker，不会被保存

快速使用

1. 通过前端生成

在 Sublink Worker 前端页面的 高级选项 → 通用设置 下方，可以看到 Subconverter 外部配置 卡片：

• 选择规则预设（精简 / 均衡 / 全面）或自定义规则
• 可选开启按国家分组
• 可选关闭自动选择分组
• 点击复制按钮获取配置地址

2. 直接拼接 URL

# 默认均衡预设
https://your-worker.com/subconverter

# 全面预设 + 按国家分组
https://your-worker.com/subconverter?selectedRules=comprehensive&group_by_country=true

# 精简预设 + 关闭自动选择
https://your-worker.com/subconverter?selectedRules=minimal&include_auto_select=false

3. 在 Subconverter 中使用

将生成的地址作为 Subconverter 的 config 参数：

https://sub.example.com/sub?target=clash&url=你的订阅链接&config=https://your-worker.com/subconverter

参数说明

参数	类型	默认值	说明
selectedRules	string	balanced	预设名（minimal / balanced / comprehensive）或 JSON 数组
include_auto_select	boolean	true	是否包含自动选择（Auto Select）分组
group_by_country	boolean	false	按国家/地区分组（支持 30 个国家）
lang	string	zh-CN	语言代码，影响分组名称（zh-CN / en / fa / ru）

自定义规则

除了使用预设，你也可以传入 JSON 数组来精确控制规则：

/subconverter?selectedRules=["🚀 代理服务","🎬 流媒体","🤖 AI 服务","🛡️ 隐私防护","🍎 苹果服务","📢 广告拦截","🌏 国内服务","🔒 私有网络"]

TIP

自定义规则需要 URL 编码。在前端页面中勾选规则后复制即可，无需手动编码。

User-Agent 说明

自 v2.3.0 起，所有订阅端点（/singbox、/clash、/surge、/xray）会自动读取客户端请求头中的 User-Agent，用于识别客户端类型和版本。

如果需要手动指定 UA（例如调试或特殊场景），可以通过 ?ua= 查询参数覆盖：

/clash?config=...&ua=clash-verge/v2.0.0

优先级：?ua= 查询参数 > 请求头 User-Agent > 默认值