本文详解 Sub-Converter 自建全流程，涵盖 Docker 部署、规则定制及代理组优化,助您构建稳定的国际网络加速环境。
为什么需要 Sub-Converter 自建服务
在跨境办公需求日益增长的今天，订阅链接的格式兼容性与节点筛选能力直接决定了网络体验，公共转换服务存在隐私泄露风险且功能受限，通过 Sub-Converter 自建，用户可完全掌控数据流向，自定义分流规则，并实现订阅内容的深度清洗，本文将指导您快速部署专属转换后端，解决 Clash 客户端无法识别特定协议或节点延迟过高的问题。
核心部署流程：Docker 一键落地
自建 Sub-Converter 最简便的方式是使用 Docker 容器，无需配置复杂的 PHP 环境。
- 准备环境：确保服务器已安装 Docker 及 Docker Compose，推荐选择位于海外的 VPS 以保证转换速度。
- 拉取镜像：执行
docker pull tindy2093/subconverter获取最新稳定版镜像。 - 启动容器：使用以下命令映射端口并挂载配置文件目录：
docker run -d --name subconverter -p 25500:25500 -v $(pwd)/config:/subconverter/config tindy2093/subconverter
- 验证服务：访问
http://IP:25500，若看到 API 文档页面即表示部署成功。
完成 Sub-Converter 自建后，您即可在 URL 后拼接参数调用 API，将原始订阅转化为 Clash Meta 或 Clash Premium 内核支持的 YAML 格式。
深度定制：代理组与分流规则优化
转换工具的核心价值在于对配置文件的二次加工，在 config/config.yml 中,您可以精确定义代理组行为。
代理组类型详解
- select（手动选择）：适用于对特定网站有固定线路需求的场景,用户可手动切换最优节点。
- url-test（自动测速）：系统定期测试节点延迟，自动连接速度最快的节点,适合日常浏览。
- fallback（故障转移）：主节点断开时自动切换备用节点，保障业务连续性,适合关键任务。
分流规则优先级
Clash 内核按顺序匹配规则,理解优先级至关重要：
- DOMAIN：精确匹配域名,优先级最高。
- DOMAIN-SUFFIX：匹配域名后缀，如
.google.com。 - IP-CIDR：匹配 IP 段，需处理 DNS 解析后的流量。
- GEOIP：基于地理位置数据库，如
GEOIP,CN,DIRECT实现国内直连。
proxy-groups:
- name: "AutoSelect"
type: url-test
proxies: [".*"]
url: "http://www.gstatic.com/generate_204"
interval: 300
rules:
- DOMAIN-SUFFIX,google.com,AutoSelect
- GEOIP,CN,DIRECT
- MATCH,AutoSelect
通过 Sub-Converter 自建，您可以预置这些规则，让每次生成的订阅都自动包含最优策略,无需客户端重复设置。
常见问题排查 (FAQ)
现象：转换后的订阅在 Clash 中无法更新，提示 YAML 解析错误。 原因：原始订阅包含非标准字符或编码格式不统一。 解决方法：在自建后台开启"移除无效节点"和"UTF-8 强制转码"选项,重新生成链接。
现象：游戏延迟高且频繁掉线。 原因：未启用 TUN 模式，UDP 流量未被接管。 解决方法：确认客户端开启 TUN 模式，并在 Sub-Converter 规则中强制游戏域名走代理组，避免走系统代理仅支持 TCP 的限制。
现象：部分流媒体网站提示区域限制。
原因：节点 IP 被识别或分流规则未覆盖。
解决方法：利用自建功能添加特定的 DOMAIN-KEYWORD 规则,强制相关流量通过高端专线节点。
结语与维护建议
维护 Sub-Converter 自建服务需定期更新镜像以修复安全漏洞，对于追求极致稳定的用户，建议结合 GitHub Actions 实现配置文件的自动化同步与备份。
合理的节点筛选是高效上网的前提，如果您尚未拥有高质量的节点资源，可参考我们整理的全球网络加速节点订阅推荐，选择支持多协议、低延迟的优质服务，配合您的自建转换后端，打造完美的跨境访问体验，掌握 Sub-Converter 自建技术，意味着您不再受制于第三方工具的更新节奏,真正实现了网络配置的自主可控。
