首页/云/Docker 容器速查/镜像 OCI 标签与元数据
本包目录(366 条)
基础命令50 条
镜像与构建107 条
网络与存储52 条Compose 编排55 条资源与安全50 条容器排障52 条

镜像 OCI 标签与元数据

通过构建参数或 Dockerfile 的 LABEL 写入 OCI 标准元数据(版本、来源、修订号等),便于资产盘点与供应链信息记录。

Docker 容器速查云更新于 2026-10-12
用途写入标准元数据
命令形式docker build --label 键=值
标准前缀org.opencontainers.image.*

示例

示例
docker build \
  --label org.opencontainers.image.version=1.4.2 \
  --label org.opencontainers.image.revision=abc1234 \
  -t app/web:1.4.2 .
docker image inspect app/web:1.4.2 --format '{{json .Config.Labels}}'
常见键包括 title、version、revision、source、licenses;CI 里从提交号自动注入可保证信息新鲜。

易错点

  • 标签值会随镜像分发给所有拉取者,内部地址与凭据类信息不要写进去
  • 版本或修订号忘记随构建更新会让溯源信息失真,交给流水线变量注入更可靠

数据来源与参考

  • OCI Image Spec:annotations 与 Docker 官方 label 约定(opencontainers.org / docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌