docker tag 命令仅添加镜像标签而不复制层或占用额外存储，支持基础打标（改名、加版本）、多标签共存、推送前路径格式化及标签级清理。

直接用 docker tag 命令就行，它不复制镜像层、不新增存储，只是给已有镜像加一个新名字（即标签），开销几乎为零。

基础打标：改名 + 加版本号

语法是：docker tag 源镜像[:源标签] 目标镜像[:目标标签]。源标签省略时默认为 latest。

• 把本地 nginx:alpine 改成自己的应用名和语义化版本：
  docker tag nginx:alpine myapp:v1.5.2
• 只改镜像名，保留原标签：
  docker tag nginx:alpine web-server:alpine
• 用镜像 ID 打标更稳妥（适合没命名或怕拼错）：
  docker tag a1b2c3d4 myapp:debug

多标签管理：一个镜像多个标识

同一个镜像 ID 可以同时拥有多个标签，方便不同用途引用，所有标签共享底层数据，不额外占空间。

Docker Ctl

使用 podman 检查容器、日志和镜像

下载

• 基于当前 myapp:latest 打多个标签：
  docker tag myapp:latest myapp:v1.5.2
docker tag myapp:latest myapp:20260813
docker tag myapp:latest myapp:prod
• 执行 docker images 查看，会发现这三行的 IMAGE ID 完全一致，说明它们是同一份内容的不同别名。

为推送准备：带上仓库地址和命名空间

推送到 Docker Hub 或私有 Registry 前，必须把镜像名改成带完整路径的格式，否则 docker push 会失败。

• 推到 Docker Hub：
  docker tag myapp:v1.5.2 username/myapp:v1.5.2
• 推到私有仓库：
  docker tag myapp:v1.5.2 registry.example.com/team/myapp:v1.5.2
• 注意斜杠 / 和冒号 : 的位置不能错；Registry 地址要和实际配置完全匹配。

验证与清理

打完标签后，用 docker images 确认是否生效。若只想删掉某个标签（不是整个镜像），用 docker rmi 镜像名:标签。

• 例如删除旧标签：
  docker rmi nginx:alpine
• 只要还有其他标签指向该镜像 ID，镜像层就不会被真正删除。