适用范围与准备

适用于已安装 Docker Engine/Desktop 和 Compose v2、只想在自己电脑运行 SubConverter 的读者。先确认有权限管理这台电脑,且本机 25500 端口空闲;下面会创建测试容器并下载镜像,不适用于直接部署公网服务。

先区分原因

Compose 能把服务放在 services 下,但错误缩进会让字段落到顶层;YAML 语法能解析不代表 Compose 结构正确。另一个关键点是宿主机发布端口:只写 25500:25500 通常会暴露到其他接口,本机用途应明确绑定 127.0.0.1。

按顺序操作

  1. 在独立目录保存下方 compose.yaml,核对镜像仓库来自官方 Docker 说明。示例使用官方文档列出的 latest 标签,它会变化;拉取后记录实际镜像摘要,后续需要复现时用已核实摘要固定,不把标签当固定版本。
  2. 在该目录运行 docker compose -p roxi-subconvert-review config,先看展开结构和端口绑定。校验失败就修正文件,不继续启动;这一步只检查 Compose 配置,未验证服务运行。
  3. 确认目录、镜像和端口无误后,用 docker compose -p roxi-subconvert-review up -d 创建本次实例,再查看同一项目的 ps 与 logs。不要将日志或配置直接公开,其中可能含链接或凭据。
  4. 访问本机 /version,核对返回内容和版本;再按关联 API 教程在本机验证一份自己的输入。客户端只能使用自己可达的地址,手机上的 127.0.0.1 指手机自身,不是这台电脑。
compose.yaml:本机测试服务;不用旧稿的顶层散落字段
services:
  subconverter:
    image: tindy2013/subconverter:latest
    ports:
      - "127.0.0.1:25500:25500"
    restart: "no"
macOS/Linux 终端,或已安装 curl 的环境:只读检查本机版本
curl --noproxy '*' --connect-timeout 5 --max-time 10 \
  'http://127.0.0.1:25500/version'

怎样确认有效

Compose 结构通过、容器处于预期状态、发布地址确为本机、/version 返回 SubConverter 信息,且实际转换输出可被目标内核加载并完成任务,才完成所需层次的验证。只看到容器 running 或 HTTP 200 不能宣告订阅可用。

无效时恢复与下一步

测试结束在同一目录执行 docker compose -p roxi-subconvert-review down,只处理本次项目,保留自己的配置和镜像摘要。遇到端口冲突先退出并查归属,不杀掉未知服务。本文做了示例静态核对,未拉取或运行镜像,也未提交真实订阅。