配置只发到本站做语法校验,不存储、不执行;语义检查在浏览器内完成。Ctrl+Enter 立即检查
可选:粘贴 .env(用于变量对照)
检查端口冲突、依赖是否存在、命名卷与网络是否声明、镜像 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 条 · 点问题查看答案会连接 Docker 或执行 compose 命令吗?
不会。语义检查全部在浏览器里用文本规则完成;语法校验会把配置发到本站的 YAML 校验接口(SnakeYAML),只解析、不存储、不执行,也不依赖本机装没装 Docker。
和 YAML 格式化/校验有什么区别?
这里会先复用 YAML 工具的解析器做语法校验:语法不过就直接报出错行并停止,和 YAML 工具结论一致;语法通过后才跑端口、依赖、卷等语义规则,所以不用在两个工具之间来回切。
用了锚点、extends、include 或 profiles 会怎样?
这类写法要展开后才能判断依赖和变量,静态检查容易误报,所以只保留端口、镜像、restart 等能直接确认的规则,其余跳过。
为什么变量没定义、healthcheck 没写 condition 只是提示?
变量可能来自 CI 或部署环境,condition 也不是必填;这类情况只提示,不阻断,避免把能正常启动的配置判成错误。
页面里的模板能直接用吗?
可以。单服务、web + db、web + db + redis 三份正确模板本身零告警,替换镜像、端口和密码后即可作为起点;下拉里的「错误示例」每组只演示一类问题,选中后点「检查」就能看到对应报错和修法。