适用范围与准备

适用于自己运行或明确可信的 SubConverter,原订阅带有问号、& 或多个参数,转换时却得到错误或不完整输入。下面是 macOS/Linux shell 中调用本机服务的示例;先确认 127.0.0.1:25500 确实是你的转换进程,并在仅本人可读的工作目录保存输出。

先区分原因

外层 /sub 的参数与原订阅自身的参数属于两层 URL。直接拼接未编码的原地址,会让内层 & 被误当成外层参数分隔。官方要求对 url 做 URL 编码;改用 POST 或随意重复编码都不是等价修复。

按顺序操作

  1. 记录转换器版本、target 和原链接由哪些参数组成,只记录参数名不记录凭据。先用下方无真实凭据的占位示例理解命令,example.invalid 故意不可用,因此不能期待转换成功。
  2. curl 使用 --get 将数据放到查询参数中,--data-urlencode 负责原 URL 的值编码。需要真实调用时,只在本机将占位地址换成自己的有效来源;已有百分号编码的整层参数不要再次按同一层重复编码。
  3. 执行前保留原配置,输出写入独立文件。记录 curl 退出码和 HTTP 状态,再在本机检查正文是配置、错误文本还是 HTML;200 和文件存在都不足以证明转换成功。
  4. 只有输出确属目标格式,才用目标内核检查副本,再核对关键字段与实际加载结果。若仍失败,区分上游订阅获取与转换过程,不继续把错误正文导入客户端。
结构示例:故意使用无效占位订阅,不含真实凭据
curl --noproxy '*' --get 'http://127.0.0.1:25500/sub' \
  --data-urlencode 'target=clash' \
  --data-urlencode 'url=https://example.invalid/sub?a=1&b=2' \
  --connect-timeout 5 --max-time 30 \
  --output converted-review.yaml \
  --write-out 'HTTP %{http_code}\n'

怎样确认有效

同一个原订阅的参数完整到达转换器,输出通过目标内核检查、关键字段保留,并在加载后完成原任务。编码正确只解决输入表达,不能修复过期账号、失效节点或不支持的协议。

无效时恢复与下一步

无效时保留脱敏错误,继续使用原生订阅或原配置副本;不为了返回 200 删除认证字段。泄露过凭据则按原服务流程更换。本文未执行真实转换或验证第三方服务可用性。