订阅转换自建怎么做?Docker、本机端口与 HTTPS 安全部署
简答:订阅转换自建的最短路径是:先确认客户端确实需要转换,再用 Docker 启动后端,并将端口绑定到 127.0.0.1;如果必须远程访问,再通过 HTTPS 反向代理和认证开放。不要把真实订阅链接直接粘贴到陌生公共转换站。
定义:订阅转换自建,是在自己控制的电脑、局域网设备或 VPS 上运行转换后端,把原始订阅转换为 Clash、Mihomo、sing-box、Surge 等客户端能够导入的格式。
先判断:你是否真的需要自建订阅转换
订阅转换主要解决格式不兼容、多条订阅合并、节点筛选、名称重命名和规则模板套用等问题。如果服务商已经提供目标客户端的原生订阅,优先直接导入原生链接;不需要合并、筛选或改格式时,自建服务反而增加了维护环节。
需要自建的典型情况包括:手里有多条订阅,需要合并成一个客户端链接;原始格式无法被目标客户端识别;需要统一节点前缀、过滤失效节点,或需要把转换后链接放在自己控制的环境中更新。
本文是第三方指南,页面不代表任何转换项目的官方网站。项目功能和兼容性应以对应仓库当前文档为准;截至2026年11月13日,版本标签、镜像更新状态和具体协议支持仍应在发布页再次核对。
| 方案 | 适合谁 | 主要能力 | 主要注意点 |
|---|---|---|---|
| 客户端原生订阅 | 只需导入和自动更新 | 配置简单,少一个中间服务 | 不能自由合并、筛选或改模板 |
| Subconverter | 需要格式转换和参数化生成 | 支持多种 target、筛选、重命名和规则参数 | 后端接口必须限制访问,参数能力以源码和文档为准 |
| Sub-Store | 需要订阅管理、合并和持续维护 | 支持多订阅管理、格式转换和节点处理 | 需核对前端、后端、CORS 与模块域名配置 |
| 网页前端 | 希望用浏览器管理参数 | 减少手写 URL 参数 | 前端不是转换后端,不能替代后端安全控制 |
Subconverter 的 Docker 文档给出了端口映射和 /version 健康检查示例;Sub-Store 官方仓库则将其定位为订阅管理与格式转换工具,功能边界不要混为一谈。参考:Subconverter Docker 文档、Sub-Store 官方 README。
自建前置检查:先保护原始订阅链接
- 准备运行环境:本机部署需要 Docker Engine 或 Docker Desktop;VPS 部署还需要域名、DNS 解析、SSH 管理权限和可用的 80、443 端口。
- 准备测试订阅:不要在文章、工单、截图或公共页面中粘贴真实订阅。可以先复制到本地密码管理器,并准备一条可随时重置的测试链接。
- 确认目标格式:先确定客户端需要 Clash、Mihomo、sing-box、Surge 还是其他格式,再填写对应的
target。Subconverter 源码列出了多个 target 分支,但实际输出仍需结合客户端版本测试:Subconverter target 与参数源码。 - 决定访问范围:仅自己使用时绑定
127.0.0.1;局域网共享时绑定内网地址并限制来源;VPS 远程使用时让后端只监听本机,再由 HTTPS 反向代理接入。
如果订阅链接已经发到公共页面、陌生转换站或日志中,应立即到服务商后台重置订阅,再把新链接导入自建服务。不要只删除浏览器历史记录,因为链接本身可能仍然有效。
本机 Docker 部署:先绑定 127.0.0.1
Docker 未指定主机地址时,发布端口默认绑定到所有主机地址,包括 0.0.0.0 和 IPv6 的 [::]。因此,-p 25500:25500 不是“只允许本机访问”;仅当写成 127.0.0.1:25500:25500 时,才是回环地址绑定。Docker 官方文档明确说明了这一区别:Docker 端口发布与映射。
先创建工作目录,然后使用官方 Docker README 中的镜像名进行初次验证。不要把未经核实的固定版本号写进生产配置;如果要锁定版本,应先查看项目 Releases 和镜像标签,再替换示例中的 latest。
mkdir -p ~/subconverter
cd ~/subconverter
docker run -d --name subconverter --restart=always -p 127.0.0.1:25500:25500 tindy2013/subconverter:latest
curl http://127.0.0.1:25500/version
docker logs --tail=100 subconverter
看到版本接口返回后,再进行格式转换测试。上面的镜像标签来自项目 Docker 文档示例,不等于本文确认的最新版本;当前版本和可用标签请以项目发布页核对:Subconverter Releases。
如果要使用 Compose,可以保留回环绑定:
services:
subconverter:
image: tindy2013/subconverter:latest
container_name: subconverter
ports:
- "127.0.0.1:25500:25500"
restart: always
Docker 官方还提醒,Linux 上发布容器端口的流量可能在经过 UFW 配置前就被 Docker 的规则转发。因此,VPS 上不能只看 UFW 状态判断端口是否公开,应同时检查 Docker 发布地址和外部连通性:Docker packet filtering 与防火墙文档。
VPS 远程访问:后端本机监听,Caddy 提供 HTTPS
如果只是自己在 VPS 上使用,仍建议保留 127.0.0.1:25500:25500,通过 SSH 隧道或本机程序访问。只有需要从多台设备导入转换链接时,才考虑域名加反向代理。不要直接把 25500 端口暴露到公网后再把安全性寄托在普通防火墙规则上。
以 Caddy 为例,先将域名解析到 VPS,并让 80、443 端口到达 Caddy。Caddy 官方说明:使用域名作为入口时,可以自动申请并续期公开信任的 HTTPS 证书,但 DNS 和端口必须正确:Caddy 反向代理快速开始。
示例 Caddyfile 如下,其中域名、用户名和密码哈希都要替换:
convert.example.com {
basic_auth {
converter $2a$14$REPLACE_WITH_HASH
}
reverse_proxy 127.0.0.1:25500
}
Basic Auth 的密码必须写成哈希值,且不能在明文 HTTP 上单独使用。可以用 caddy hash-password 生成哈希;Caddy 官方对此有明确说明:Caddy basic_auth 指令。
完成后依次检查:域名是否解析到正确 VPS;浏览器是否能建立 HTTPS;未登录请求是否返回 401;登录后是否能访问后端接口;转换 URL 中是否仍然包含真实订阅凭据。若认证配置失误或域名证书未就绪,先回退到本机访问,不要临时改成公网明文端口。
生成转换链接:先用最小参数,再逐项增加功能
先用一个测试订阅和一个目标格式验证基础链路。常见参数思路是:target 指定输出格式,url 指向原始订阅,之后再添加筛选、重命名、规则集或更新间隔参数。具体参数名称和支持范围应以当前后端文档或源码为准,不要把其他前端的参数表直接套用。
示例仅展示结构,不包含真实凭据:
http://127.0.0.1:25500/sub?target=clash&url=https%3A%2F%2Fyour-subscription.example%2Fpath
如果通过 HTTPS 反向代理访问,则将地址替换为你的域名,并保留认证要求。真实订阅链接可能包含长期有效的令牌,生成后的链接同样需要按敏感凭据处理。多条订阅合并、节点前缀和过滤规则应一次只增加一项,便于判断是原始订阅、URL 编码还是参数逻辑导致失败。
Sub-Store 官方 README 说明其具备格式转换、订阅格式化和多订阅收集等能力;如果你的主要需求是长期管理多个来源,而不是单次生成一个目标格式,可以优先评估它。但其前端域名、CORS 允许来源和模块重写配置需要单独核对,不能仅凭页面能打开就判断后端安全:Sub-Store 官方说明。
部署完成后的 5 项验证清单
- 端口范围:本机部署用
ss -lntp或 Docker 端口列表确认服务是否仅绑定127.0.0.1;公网部署确认只有 443 对外提供入口。 - 健康接口:访问
/version,再查看docker logs,确认容器没有反复重启、配置解析失败或端口占用。 - 节点数量:比较原始订阅和转换结果的节点数量。数量减少不一定是服务故障,也可能是目标格式不支持某些协议,或过滤参数生效。
- 客户端导入:分别用目标客户端导入,检查节点名称、协议字段、策略组和规则提供者是否能被识别。不要只以浏览器能下载 YAML 或文本作为成功标准。
- 更新链路:修改测试订阅或等待后端更新周期,确认客户端重新拉取的是新内容;若原始订阅过期、返回 401/403,转换后链接也会随之失效。
如果涉及规则、策略组或模板,建议先使用最小配置完成节点导入,再单独加入规则集。这样能把“节点解析失败”和“规则文件加载失败”分开定位。
常见失败回退:按原始订阅、后端、客户端三层排查
| 现象 | 优先检查 | 处理方式 |
|---|---|---|
| 节点为空 | 原始链接是否能直接打开、后端日志、URL 编码 | 先用原始订阅导入客户端;确认返回内容不是登录页、HTML 错误页或 401/403 |
| 节点数量减少 | 目标格式兼容性、过滤参数、协议类型 | 删除筛选参数重新生成,再逐类确认目标客户端是否支持对应协议 |
| 规则不生效 | 模板、规则集 URL、客户端版本 | 先导入不含规则的基础配置,再逐个添加规则集 |
| 更新失败 | 原始订阅是否过期、反向代理认证、HTTPS 证书 | 用 curl -I 检查状态码;若订阅已泄露或失效,重置后重新导入 |
| 公网无法访问 | DNS、80/443、防火墙、Caddy 日志 | 先在 VPS 本机访问 127.0.0.1,再逐层检查域名和反向代理,不要直接放开后端端口 |
失败回退顺序建议固定为:先验证原始订阅,再验证转换后文本,接着验证客户端导入,最后检查规则和自动更新。每次只改一个变量,并保留最近一次可工作的配置备份。
维护与升级:不要把能运行等同于安全
- 镜像升级前先备份 Compose 文件、配置文件和自定义规则;不要直接把未核实的版本号写入生产命令。
- 升级后先访问健康接口,再用测试订阅验证节点数量、目标格式和客户端导入。
- 如果新镜像启动失败,回退到升级前已经核对过的标签;具体标签是否存在需查看项目 Releases 或镜像仓库。
- 限制日志保存范围,避免日志中出现完整订阅 URL、认证头或带令牌的请求地址。
- 定期检查 Caddy 认证、DNS、证书续期和 Docker 端口绑定;任何一次订阅链接泄露都应按凭据泄露处理,到服务商后台重置。
如果自建转换完成后,客户端仍然出现高延迟、丢包或连接中断,转换后端通常不是唯一变量,应继续检查 DNS、MTU、客户端模式和实际线路。了解与跨境办公连接排查相关的服务入口,可在完成本地验证后再行评估。
常见问题
订阅转换自建和直接导入原始订阅有什么区别?
直接导入不增加中间服务,维护更简单;自建转换适合需要合并多条订阅、筛选节点、重命名或生成特定客户端格式的场景。若服务商已经提供目标客户端格式,通常先用原生订阅更省排错环节。
Docker 的 -p 25500:25500 会只允许本机访问吗?
不会。未指定主机 IP 时,Docker 默认将发布端口绑定到所有主机地址。只允许本机访问应写成 127.0.0.1:25500:25500;如果使用 VPS,还要检查 Docker 端口发布规则,因为它可能绕过 UFW 的常规处理路径。
为什么转换后节点数量比原始订阅少?
常见原因包括目标格式不支持某些协议、筛选参数排除了节点、原始订阅返回不完整内容,或转换后端解析失败。先删除所有筛选和规则参数,再对比原始订阅、转换文本和客户端导入结果。
自建服务需要把 25500 端口开放到公网吗?
不建议直接开放。更安全的结构是后端绑定 127.0.0.1:25500,由 Caddy 或其他反向代理提供 HTTPS 和认证;如果只在 VPS 本机使用,则保持本机监听,不配置公网入口。
订阅转换链接泄露后只改密码够不够?
不够。订阅链接通常本身就可能包含访问令牌。应立即到服务商后台重置订阅,删除旧链接,再在自建后端和客户端中替换新链接,同时检查日志、浏览器历史和分享记录。