docker tag 是最标准轻量的镜像重命名方式，仅新增标签引用而不复制层，支持修改仓库路径、镜像名、添加多标签，并可通过 docker rmi 删除标签而非镜像层。

直接用 docker tag 就行，这是最标准、最轻量的方式。它不复制镜像层，只是给同一份镜像数据加个新名字（新标签），几乎零开销。

重命名镜像（改仓库名或镜像名）

本质是修改镜像标识中的 registry（仓库地址）、namespace（命名空间）或 repository（镜像名）部分。

• 把本地 nginx:latest 改成私有仓库路径：
  docker tag nginx:latest registry.example.com/myteam/nginx:v1
• 只改镜像名，不换仓库：
  docker tag nginx:latest web-server:prod
• 用镜像 ID 更稳妥（避免名称冲突或歧义）：
  docker tag a1b2c3d4 nginx-prod:2026

打多个标签（一镜多标）

一个镜像可以同时拥有多个标签，方便不同场景引用。

Docker Compose Linter

检查 docker-compose.yml 文件的安全问题、最佳实践和端口冲突

下载

• 为同一镜像添加语义化版本和别名：
  docker tag myapp:latest myapp:v1.2.0
docker tag myapp:latest myapp:stable
• 推送时可任选其一：
  docker push myapp:v1.2.0 或 docker push myapp:stable

验证与清理

执行 docker tag 后，运行 docker images 能看到新旧名称并存，IMAGE ID 完全一致——说明只是新增引用。

• 确认无误后，如需移除旧标签：
  docker rmi nginx:latest
• 注意：docker rmi 删除的是标签，不是镜像层；只要还有其他标签指向该 IMAGE ID，数据就保留
• 想彻底删掉镜像？得先删光所有标签，Docker 才会回收底层层数据

构建时直接指定名称（替代事后重命名）

更推荐在构建阶段就定好名字，省去后续操作：

• docker build -t myrepo/app:v2.1.0 .
• 配合 Dockerfile 中的 LABEL 补充元信息，比如：
  LABEL version="v2.1.0" maintainer="ops@example.com"