Docker Compose YAML关键字区分及官方速查表查询咨询

核心结论 #

• 你示例中出现的listenOn、connector、credentials等字段不属于Docker Compose官方标准关键字，属于对应开源项目自定义的扩展字段
• Docker Compose官方提供了对应各版本的配置字段规范，所有官方支持的关键字都收录在对应版本的规范文档中，可作为类似Python关键字表的速查依据

非官方字段的处理逻辑 #

Docker Compose解析配置文件时，仅会识别处理官方规范内定义的关键字，所有未纳入规范的自定义字段会被直接忽略，不会对容器的构建、运行逻辑产生任何影响。这类自定义字段由对应开源项目自己的配置解析工具读取使用，和Docker本身的能力无关，相关说明需要到对应项目的文档中检索。

快速区分官方/自定义字段的方法 #

官方Compose配置的字段层级逻辑非常固定，你可以通过层级快速判断：

• 一级关键字：version、services、networks、volumes、secrets、configs均为官方固定定义的关键字
• services下的第一级字段为用户自定义的服务名称，无固定命名限制
• 服务名称下的二级字段中，和容器构建、运行、网络、存储、调度相关的配置均为官方关键字，比如build、image、ports、environment、volumes、command、restart等，和项目业务功能强相关的字段大概率为项目自定义字段

注：你提供的第二个配置片段虽然标注了version: "2"，但字段结构完全不符合标准Compose配置的逻辑，本质是项目借用yml格式和Compose版本标识自定义的业务配置文件，不属于标准的Docker Compose配置。

内容的提问来源于stack exchange，提问作者Zubair Hassan