docker镜像标签（tag）是标识版本、环境等的关键别名，格式为registry-host/namespace/repository:tag，支持多标签共存、语义化版本、git哈希、时间戳及组合命名，需统一团队规范并避免依赖latest。
Docker 镜像的标签（Tag）是区分不同版本、构建环境或用途的关键标识，合理使用 docker tag 命令配合清晰的命名规范，能大幅提升镜像可追溯性与协作效率。
理解 Tag 的基本结构
一个完整镜像引用格式为：registry-host/namespace/repository:tag。其中 tag 默认是 latest，但不建议在生产中依赖它。Tag 本身只是指向某次构建生成的镜像 ID 的别名，不改变镜像内容。
- Tag 不是元数据，无法通过
docker inspect查看“版本号字段”，只能从镜像名中解析 - 同一个镜像 ID 可以被打上多个 Tag（如
v1.2.0、stable、20241005） - 删除 Tag 不会删除镜像层，只有当所有 Tag 都被移除且无容器引用时，才可能被垃圾回收
常用版本号打标方式
推荐按语义化版本（SemVer）或时间戳方式打标，避免模糊标签如 new、test、final。
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
-
语义化版本：适用于有明确发布节奏的服务，如
myapp:v1.5.2、myapp:v2.0.0-rc1 -
Git 提交哈希：适合 CI/CD 中每次提交构建，如
myapp:6a8f1b3（取前7位即可） -
时间戳（ISO 或简写）：便于排序和定位构建时间，如
myapp:20241005或myapp:2024-10-05T14-22-01 -
组合标签：兼顾可读性与唯一性，例如
myapp:v1.5.2-6a8f1b3或myapp:prod-v1.5.2-20241005
实际打标操作步骤
假设你刚用 docker build 构建出一个镜像，ID 是 a1b2c3d4e5f6，希望打上多个有意义的 Tag：
- 先确认镜像 ID 或当前 latest 标签：
docker images | grep myapp - 打语义版本：
docker tag a1b2c3d4e5f6 myorg/myapp:v1.5.2 - 打 Git 版本：
docker tag a1b2c3d4e5f6 myorg/myapp:6a8f1b3 - 打环境+版本组合：
docker tag a1b2c3d4e5f6 myorg/myapp:prod-v1.5.2 - 推送全部标签：
docker push myorg/myapp:v1.5.2 && docker push myorg/myapp:6a8f1b3 && docker push myorg/myapp:prod-v1.5.2
注意：Docker 不支持一次推送多个 Tag，需逐个 push；也可用脚本批量处理。
团队命名规范建议
统一规范能减少混淆，尤其在多环境、多团队协作时：
-
仓库名（repository） 小写、短横线分隔，如
user-service、data-processor -
命名空间（namespace） 用团队/项目名，如
finance/myapp、ai-platform/llm-api -
Tag 命名层级：建议固定顺序 ——
[环境]-[版本]-[构建标识]，例如：staging-v1.5.2-6a8f1b3、prod-v1.5.2-20241005 -
保留关键标签：如
latest仅指最近稳定版（非每日构建），stable指经 QA 验证的长期支持版，dev仅供开发测试
