免费工具
docker run 转 Docker Compose 工具
粘贴一条 docker run 命令或整个部署脚本,然后选择“转换”。你会得到一个 compose.yaml,其中包含每个容器的镜像、端口、环境变量、卷、网络、重启策略和健康检查,同时还会绘制服务关系图,可下载或在 Archboard 中打开。无需账号。
示例输出
使用方法
粘贴 docker run 命令
从 README、终端历史或部署脚本中粘贴命令。换行续接、sudo 和 podman run 都可以直接使用。
选择“转换”
compose.yaml 会显示在输入框旁边,并附上未转换内容的列表,服务会被绘制成图。
复制、下载或打开
复制文件、下载为 compose.yaml,或在 Archboard 中打开图来记录这套部署。注册只需 Google 或 GitHub 账号。
compose.yaml 中包含什么
- 每条 docker run 命令生成一个服务。服务名取自 --name,没有名称时取自镜像名;同名的两条命令会加上编号后缀。
- 用 -p 发布的端口、-e 设置的环境变量、标签、工作目录、用户以及镜像后面的命令,按你书写的顺序排列。
- -v 和 --mount 的命名卷和绑定挂载,以及 --network 的网络。有 docker network create 行时会在文件中声明该网络;只被使用的网络会标记为 external。
- 重启策略、健康检查、内存和 CPU 限制、主机名,以及其他在 Compose 中有对应字段的运行选项。
-e 参数中的值
“保留值”会像 docker run 那样,把每个 -e 值复制到 environment 块中。“仅名称”只写变量名,值留空,适合在把文件贴到工单或拉取请求之前使用。看起来像密码、令牌或密钥的值在两种模式下都会计入警告,这样你就知道哪些行应移到 env 文件或机密存储中。
docker run 转换器不处理的内容
- 在 Compose 中没有对应字段的参数,例如 --ulimit 或 --sysctl。它们会列在警告中,并在服务上方用 not converted 注释标出,注释只写参数名,从不写参数值。
- Shell 功能:管道、重定向及其后的内容会被截断,$(…) 命令替换保留为文本,不会执行。
- docker run 和 podman run 以外的命令,例如 docker build、docker exec 或 docker compose up,会被跳过并计数。
- 机密管理:值仍是普通环境变量。请自行把密码和令牌移到 env 文件或机密存储中。
镜像前面有未知参数时
docker run 会把第一个不是参数的单词当作镜像。对于转换器不认识的参数,它无法判断该参数是否需要值,因此会把下一个单词当作镜像,并在警告中说明:请确认显示的单词确实是镜像。如果后面还有更多单词,这条命令会被跳过,而不是去猜。把参数写成 --flag=value,或在镜像前加上 --,就不会有歧义。
docker run 转 Compose 常见问题
可以一次转换多条 docker run 命令吗?
可以。把它们依次粘贴即可,有没有反斜杠换行都行。每条命令都会成为同一个 compose.yaml 中的服务,使用同一 --network 的容器会进入同一个 Compose 网络,因此图中能看出哪些服务可以互相访问。
能读取 podman run 和 docker container run 吗?
可以。podman run、docker container run,以及以 sudo 或变量赋值开头的命令都会以同样方式读取。Compose 中没有对应字段的 Podman 专有选项会列在警告中。
为什么文件开头没有 version 行?
当前的 Docker Compose 会忽略顶层的 version 键并给出警告,所以文件直接以 services 开头。检查过各项值之后,可以直接用 docker compose up 运行。
在 Archboard 中打开图后会发生什么?
预览不会被保存。选择“在 Archboard 中打开”后,转换后的服务关系图会作为新图保存到你的工作区,你可以在那里重新排列、添加注释和分享。compose.yaml 本身不会被保存:离开页面前请复制或下载。
docker run 转换器免费吗?
免费。转换命令、复制文件和以 SVG 或 PNG 格式下载图都不需要账号。在 Archboard 中打开图需要一个免费账号。