适用范围与准备
适用于已安装 Docker Engine/Desktop 和 Compose v2、只想在自己电脑运行 SubConverter 的读者。先确认有权限管理这台电脑,且本机 25500 端口空闲;下面会创建测试容器并下载镜像,不适用于直接部署公网服务。
先区分原因
Compose 能把服务放在 services 下,但错误缩进会让字段落到顶层;YAML 语法能解析不代表 Compose 结构正确。另一个关键点是宿主机发布端口:只写 25500:25500 通常会暴露到其他接口,本机用途应明确绑定 127.0.0.1。
按顺序操作
- 在独立目录保存下方 compose.yaml,核对镜像仓库来自官方 Docker 说明。示例使用官方文档列出的 latest 标签,它会变化;拉取后记录实际镜像摘要,后续需要复现时用已核实摘要固定,不把标签当固定版本。
- 在该目录运行 docker compose -p roxi-subconvert-review config,先看展开结构和端口绑定。校验失败就修正文件,不继续启动;这一步只检查 Compose 配置,未验证服务运行。
- 确认目录、镜像和端口无误后,用 docker compose -p roxi-subconvert-review up -d 创建本次实例,再查看同一项目的 ps 与 logs。不要将日志或配置直接公开,其中可能含链接或凭据。
- 访问本机 /version,核对返回内容和版本;再按关联 API 教程在本机验证一份自己的输入。客户端只能使用自己可达的地址,手机上的 127.0.0.1 指手机自身,不是这台电脑。
services:
subconverter:
image: tindy2013/subconverter:latest
ports:
- "127.0.0.1:25500:25500"
restart: "no"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,只处理本次项目,保留自己的配置和镜像摘要。遇到端口冲突先退出并查归属,不杀掉未知服务。本文做了示例静态核对,未拉取或运行镜像,也未提交真实订阅。