docker镜像构建时用label声明元数据，需写在dockerfile中、值加引号，推荐用oci标准键名并结合arg动态注入，构建后用docker inspect验证。
Docker 镜像构建时写 LABEL，核心是用键值对声明元数据，语法简单但需注意格式规范和实际用途。
基本写法和语法要求
LABEL 指令必须写在 Dockerfile 中，每行一个或多个键值对，值要用引号包裹（尤其含空格、特殊字符时）：
LABEL maintainer="dev@example.com"LABEL version="1.2.0" release-date="2024-06-15"LABEL description="Production-ready API service with Redis cache"
多个 LABEL 可合并为一行（用空格分隔），也可拆成多行，Docker 会自动合并。不推荐跨行写单个 label，易出错。
常用且实用的 Label 键名建议
虽无强制标准，但社区常用语义化键名便于协作与自动化识别：
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
-
org.opencontainers.image.source：指向 Git 仓库地址（如https://github.com/user/repo） -
org.opencontainers.image.version：对应软件或镜像版本（比自定义version更规范） -
org.opencontainers.image.revision：Git 提交哈希（可用BUILD_ARG注入） -
org.opencontainers.image.created：ISO8601 时间戳（如$(date -u +"%Y-%m-%dT%H:%M:%SZ")） -
com.example.team或com.example.environment：内部团队/环境标识，按需定义
结合构建参数动态注入 Label
用 ARG + LABEL 实现灵活赋值，适合 CI/CD 场景：
- 在 Dockerfile 开头声明：
ARG BUILD_VERSION - 后续使用：
LABEL org.opencontainers.image.version="${BUILD_VERSION}" - 构建时传入：
docker build --build-arg BUILD_VERSION=2.1.0 -t myapp .
注意：未传 --build-arg 且未设默认值时，该 label 值为空字符串，建议在 CI 脚本中确保必填。
验证和查看 Label 是否生效
构建完成后，用以下命令检查：
-
docker inspect myapp | jq '.[0].Config.Labels'（需安装 jq） - 或直接看：
docker inspect myapp --format='{{json .Config.Labels}}'
若返回 null 或缺失字段，常见原因是：LABEL 写在 FROM 之前、引号不匹配、键名拼写错误、或构建时未传入依赖的 ARG。
