Docker镜像打标签和迁移仓库仅修改命名引用关系而不改变内容，操作快速低风险；需用docker tag重命名再docker push推送，注意登录认证、命名规范及权限配置。
给 Docker 镜像打标签（Tag）和迁移仓库，本质是修改镜像的命名引用关系，并推送至目标仓库。它不改变镜像内容，只更新元数据指向——所以操作快、风险低，但需注意命名规范、权限配置和网络可达性。
用 docker tag 重命名本地镜像
这是最基础的操作：将已有镜像 ID 或原标签，绑定一个新的仓库路径+标签名。
- 语法格式：docker tag SOURCE_IMAGE[:TAG] TARGET_REGISTRY/REPO/IMAGE_NAME[:TAG]
- 例如把本地构建的
myapp:latest改为推送到私有仓库：
docker tag myapp:latest harbor.example.com/dev/myapp:v1.2.0 - 若源镜像没带标签（只有 ID），可直接用 ID：
docker tag a1b2c3d4e5f6 registry.cn-hangzhou.aliyuncs.com/myteam/app:202405 - 注意：
docker tag不上传，只是本地新增一个标签引用；原标签仍存在，可同时保留多个别名。
推送镜像到新仓库（含认证与路径适配）
打完标签后，用 docker push 上传。关键在提前登录目标仓库，并确保仓库路径合法。
- 先登录（如阿里云 ACR、Harbor、GitHub Container Registry）：
docker login registry.cn-hangzhou.aliyuncs.com - 再推送：
docker push registry.cn-hangzhou.aliyuncs.com/myteam/app:202405 - 常见问题：
- 提示
unauthorized: authentication required→ 检查是否登录、Token 是否过期、账号是否有目标 namespace 写权限 - 提示
denied: requested access to the resource is denied→ 确认 namespace（如myteam）已创建且你有 push 权限 - 镜像名含下划线（
_）可能被某些仓库拒绝 → 改用短横线（-）或小写字母数字组合
- 提示
批量迁移多个镜像（含 Tag 映射与历史版本）
当要整体迁移一个项目的所有镜像（如从 Docker Hub 迁到企业 Harbor），建议脚本化处理，避免漏标或错推。
- 列出当前所有相关镜像：
docker images 'myapp*' --format "{{.Repository}}:{{.Tag}}" - 用 shell 循环批量打标并推送（示例）：
for img in $(docker images 'myapp*' --format "{{.Repository}}:{{.Tag}}" | grep -v ''); do
newtag=$(echo $img | sed 's/myapp/harbor.example.com\/prod\/myapp/');
docker tag $img $newtag && docker push $newtag;
done - 更稳妥的做法：导出镜像列表到文件，人工校验后再执行；对重要镜像，推送后用
docker pull验证拉取是否成功。
清理冗余标签（可选但推荐）
频繁打标后，本地会积累大量指向同一镜像 ID 的标签，虽不占空间，但影响管理清晰度。
- 查看悬空镜像（无标签、仅靠 ID 引用）：
docker images -f "dangling=true" - 删除所有悬空镜像：
docker rmi $(docker images -f "dangling=true" -q) - 删除特定无用标签（不删底层层）：
docker rmi myapp:old-test - 注意：
docker rmi只删标签，镜像层被其他标签引用时不会真正删除。
