首页/云/Docker 容器速查/LABEL 镜像元数据标签
镜像与构建107 条

LABEL 镜像元数据标签

为镜像添加 key=value 元数据,OCI 推荐 org.opencontainers.image.* 系列;取代已废弃的 MAINTAINER 指令。

Docker 容器速查云更新于 2026-10-12
用途镜像元数据:作者/版本/来源/许可证
语法LABEL key=value(多标签可合并在一条)
查看docker inspect -f '{{.Config.Labels}}' 镜像

示例

示例
LABEL org.opencontainers.image.title="web-api" \
      org.opencontainers.image.version="1.0.0" \
      org.opencontainers.image.source="https://example.com/repo" \
      org.opencontainers.image.licenses="MIT"
合规与审计场景常用标签记录版本与来源;镜像仓库页面、扫描工具也会读取这些标签。

易错点

  • 一条 LABEL 内多行赋值合并可少占用层,逐条写会多出多份元数据层
  • 标签值是字符串,写成未加引号的特殊字符(如空格)会解析异常

数据来源与参考

  • OCI Image Spec:Annotations(github.com/opencontainers/image-spec)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌