本文目录
为什么要把 docker run 转换为 Docker Compose
在开发过程中，Docker 容器往往一开始只是一条随手写下的 docker run 命令。你在这里试一个参数，在那里加一个数据卷，很快这条命令就跨越多行、堆满了数十个选项。这类冗长的命令难以阅读、容易敲错，也无法有效地进行版本控制。Docker Compose 通过将同样的配置写入一个结构化的 YAML 文件来解决这一问题，该文件可读性强、可复现，也便于与团队共享。
从 docker run 转换为 Compose 文件还能解锁多容器编排能力。一旦你的服务在 compose 文件中定义好，就可以用一条命令启动整个应用栈、定义服务之间的依赖关系、自动配置网络，并以声明式方式管理数据卷。这是定义本地开发环境和简单生产部署的标准方式。
如何使用 Docker Run 转 Compose 转换工具
CheckTown 的转换工具会解析你的 docker run 命令，并即时生成一个有效的 docker-compose.yml 文件。
- 将你的 docker run 命令粘贴到输入框中——该工具支持单行命令，也支持带反斜杠续行的多行命令
- 转换工具会即时解析所有参数，包括端口、数据卷、环境变量、重启策略、网络等
- 查看生成的 YAML 输出——原始命令中的每一个参数都会映射到对应的 Compose 键
- 复制结果并将其保存为项目根目录下的 docker-compose.yml，然后运行 docker compose up
免费试用 —— 无需注册
将 docker run 转为 Compose →Docker Compose 文件最佳实践
一个结构良好的 Compose 文件能让你的基础设施清晰透明、便于维护。遵循以下准则可让配置保持整洁。
- 始终将镜像标签固定到具体版本，而不要使用 latest——这样才能在各环境间实现可复现的构建
- 尽可能使用命名卷来存放持久化数据，而不是绑定挂载——命名卷由 Docker 管理，并且可在不同主机间移植
- 定义重启策略（例如 unless-stopped 或 on-failure），使容器在崩溃或主机重启后能够自动恢复
常见问题
转换工具支持所有 docker run 参数吗？
该转换工具能处理最常用的参数，包括端口映射（-p）、数据卷（-v）、环境变量（-e）、重启策略、网络模式、容器名称、工作目录、entrypoint、命令覆盖、标签以及资源限制。极少使用或仅限 Docker 运行时的参数可能需要手动调整。
我可以把多条 docker run 命令合并到一个 Compose 文件里吗？
可以。分别转换每条 docker run 命令，然后将各个服务定义合并到同一个 docker-compose.yml 文件的 services 键下。每个容器成为一个独立命名的服务，你还可以在文件顶层定义共享的网络和数据卷。
输出使用的是哪个版本的 Compose 文件？
输出会生成一个兼容 Docker Compose V2 的现代 Compose 文件。由于 Docker Compose V2 不再要求 version 键，它会被省略——规范会被自动推断。该文件适用于 Docker Desktop 以及独立的 docker compose CLI 安装环境。