梯子Z 来自巴黎的稳定快速安全ShadowsocksR梯子返回首页

订阅转换自建怎么做?Docker、本机端口与 HTTPS 安全部署

更新于 2026-11-13 · zionladderq.shop

简答:订阅转换自建的最短路径是:先确认客户端确实需要转换,再用 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。

自建前置检查:先保护原始订阅链接

  1. 准备运行环境:本机部署需要 Docker Engine 或 Docker Desktop;VPS 部署还需要域名、DNS 解析、SSH 管理权限和可用的 80、443 端口。
  2. 准备测试订阅:不要在文章、工单、截图或公共页面中粘贴真实订阅。可以先复制到本地密码管理器,并准备一条可随时重置的测试链接。
  3. 确认目标格式:先确定客户端需要 Clash、Mihomo、sing-box、Surge 还是其他格式,再填写对应的 target。Subconverter 源码列出了多个 target 分支,但实际输出仍需结合客户端版本测试:Subconverter target 与参数源码。
  4. 决定访问范围:仅自己使用时绑定 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 项验证清单

  1. 端口范围:本机部署用 ss -lntp 或 Docker 端口列表确认服务是否仅绑定 127.0.0.1;公网部署确认只有 443 对外提供入口。
  2. 健康接口:访问 /version,再查看 docker logs,确认容器没有反复重启、配置解析失败或端口占用。
  3. 节点数量:比较原始订阅和转换结果的节点数量。数量减少不一定是服务故障,也可能是目标格式不支持某些协议,或过滤参数生效。
  4. 客户端导入:分别用目标客户端导入,检查节点名称、协议字段、策略组和规则提供者是否能被识别。不要只以浏览器能下载 YAML 或文本作为成功标准。
  5. 更新链路:修改测试订阅或等待后端更新周期,确认客户端重新拉取的是新内容;若原始订阅过期、返回 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 本机使用,则保持本机监听,不配置公网入口。

订阅转换链接泄露后只改密码够不够?

不够。订阅链接通常本身就可能包含访问令牌。应立即到服务商后台重置订阅,删除旧链接,再在自建后端和客户端中替换新链接,同时检查日志、浏览器历史和分享记录。

相关阅读

参考资料

  1. Subconverter Docker 官方文档
  2. Subconverter Releases
  3. Subconverter target 与请求参数源码
  4. Sub-Store 官方 README
  5. Docker 端口发布与映射
  6. Docker packet filtering 与防火墙
  7. Caddy 反向代理快速开始
  8. Caddy basic_auth 指令