首页/云/云与容器速查/Dockerfile LABEL 元数据标签
本包目录(340 条)
云基础概念44 条计算与存储56 条网络与安全组33 条
容器与 Docker106 条
Kubernetes68 条容器排障33 条

Dockerfile LABEL 元数据标签

给镜像附加键值元数据:版本、维护者、源码地址等。OCI 规范推荐反向域名键名,便于资产管理与自动化识别;MAINTAINER 指令已废弃。

云与容器速查云更新于 2026-10-12
作用镜像级元数据,随镜像分发保留
OCI 常用键org.opencontainers.image.title/version/source/revision
替代MAINTAINER 已废弃,用 LABEL maintainer=… 代替
查看docker inspect 镜像 Config.Labels

示例

示例
LABEL org.opencontainers.image.title="myapp" org.opencontainers.image.version="1.2.3" maintainer="ops@example.com"
CI 里可用 label 反查构建来源(commit、流水线号),出问题能快速定位到构建记录。

易错点

  • 一行多个 LABEL 漏写续行:后面的键值被当作值的一部分
  • 把 LABEL 当环境变量用:运行时进程读不到,得用 ENV

数据来源与参考

  • Docker Docs:Dockerfile reference(LABEL)
  • OCI Image Spec(annotations)

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌