compose.yaml

配置只发到本站做语法校验,不存储、不执行;语义检查在浏览器内完成。Ctrl+Enter 立即检查

可选:粘贴 .env(用于变量对照)
诊断结果
粘贴 compose 文件后会自动检查,也可以点「检查」。
检查端口冲突、依赖是否存在、命名卷与网络是否声明、镜像 tag、关键字段空值、未知字段、变量与 .env 是否对得上。

支持的检查项

共 0 条规则。判不准的会跳过或降级为提示:涉及锚点合并、extends、include、profiles 时,依赖与变量规则整体不跑。

档位规则判定条件

语法这一档由本站的 YAML 格式化/校验服务(SnakeYAML)判定,失败时只报第一条语法错误并停止语义检查;能判的是缺冒号、括号/引号未闭合、重复键、Tab 缩进等,更复杂的语法问题建议直接用 YAML 格式化/校验。配置只用于本次校验,不存储、不执行。

这个工具检查什么

检查的是「YAML 能解析、但跑起来会出问题」的配置:宿主机端口撞车、depends_on 写了不存在的服务、命名卷和网络没在顶层声明、服务既没有 image 也没有 build、镜像没写 tag、关键字段写成空值(container_name:、image:、restart:、build:)、服务下写了 Compose 规范里没有的字段、变量在 .env 里找不到。检查前会先把配置发到本站做 YAML 语法校验(SnakeYAML),不存储、不执行;语法不过就直接报行号并停止后续检查,语义规则全部在浏览器内完成。

错误与提示的界线

  • 错误:几乎一定会导致 docker compose up 失败或起错容器,例如端口冲突、依赖服务不存在、命名卷未声明。
  • 提示:可能是刻意为之,例如镜像用 latest、变量没有默认值(可能来自 CI)、有 healthcheck 但没写 condition。
  • 用到锚点合并、extends、include、profiles 时,依赖与变量类规则会跳过,避免误报。

模板怎么用

右上角下拉分两组:「正确模板」是三份可直接运行的起点(单服务、web + db、web + db + redis),自身零告警,替换镜像版本、端口和密码后即可使用;「错误示例」每组只演示一类问题,注释里标了该看哪一行,选中后点「检查」就能看到对应的错误或提示。需要更多写法可对照 Docker Compose 速查,挂载问题见 volumes 挂载后文件消失。

常见问题

共 5 条 · 点问题查看答案

不会。语义检查全部在浏览器里用文本规则完成;语法校验会把配置发到本站的 YAML 校验接口(SnakeYAML),只解析、不存储、不执行,也不依赖本机装没装 Docker。

这里会先复用 YAML 工具的解析器做语法校验:语法不过就直接报出错行并停止,和 YAML 工具结论一致;语法通过后才跑端口、依赖、卷等语义规则,所以不用在两个工具之间来回切。

这类写法要展开后才能判断依赖和变量,静态检查容易误报,所以只保留端口、镜像、restart 等能直接确认的规则,其余跳过。

变量可能来自 CI 或部署环境,condition 也不是必填;这类情况只提示,不阻断,避免把能正常启动的配置判成错误。

可以。单服务、web + db、web + db + redis 三份正确模板本身零告警,替换镜像、端口和密码后即可作为起点;下拉里的「错误示例」每组只演示一类问题,选中后点「检查」就能看到对应报错和修法。

相关工具

相关速查

相关文章

查看全部文章 →
Docker Compose 踩坑:volumes 挂载后容器里文件没了Nginx 504 Gateway Timeout 排查:先分清是谁超时,再改超时配置Pod 一直 CrashLoopBackOff?按 Exit Code 5 分钟定位Docker 磁盘占用暴涨?镜像、容器与构建缓存清理全流程