规范命名并上传Docker镜像到远程公共仓库的核心是确保镜像名可读、可追溯、可自动化，避免latest误用和命名冲突；必须使用完整路径docker.io/用户名/镜像名:语义化标签（如1.2.0），用户名为Docker Hub注册账户名，镜像名仅含小写字母、数字、连字符，标签优先采用vX.Y.Z或环境+版本组合，本地镜像需先docker tag打标再逐个docker push推送。
规范命名并上传 Docker 镜像到远程公共仓库，核心是让镜像名可读、可追溯、可自动化，同时避免 latest 标签误用和命名冲突。关键不在“能不能推”，而在“推得清不清楚、管不管得住”。
命名必须带完整路径和语义化标签
公共仓库（如 Docker Hub）默认注册表是 docker.io，但显式写出更稳妥，也便于未来迁移到私有库。命名格式统一为：
docker.io/用户名/镜像名:版本标签
- 用户名必须是你在 Docker Hub 实际注册的账户名（不是邮箱），比如
myname - 镜像名用小写字母、数字、连字符，不带下划线或大写，例如
web-api或data-processor - 标签不用
latest作为唯一标识，优先用语义化版本，如1.2.0、1.2.0-prod；开发阶段可用dev-$(git rev-parse --short HEAD)
本地镜像先打标再推送
假设你本地有个未命名的镜像 ID 是 a1b2c3d4e5f6，想发布为正式版：
- 用
docker tag打上完整路径和标签：docker tag a1b2c3d4e5f6 docker.io/myname/web-api:1.2.0 - 如果还要保留一个带 Git 提交简码的调试标签：
docker tag a1b2c3d4e5f6 docker.io/myname/web-api:1.2.0-g8f3a21 - 确认打标成功：
docker images | grep web-api应看到两行对应标签
登录后推送，一次只推一个标签
Docker Hub 要求先登录才能推送，且每次 docker push 只作用于一个标签：
- 执行登录（会提示输入密码）：
docker login - 逐个推送，不要用通配符：
docker push docker.io/myname/web-api:1.2.0docker push docker.io/myname/web-api:1.2.0-g8f3a21 - 推送完成后，可在 Docker Hub 仓库页 查看镜像及所有标签
CI/CD 中推荐自动注入构建信息
人工打标易出错，接入流水线时建议由工具生成可靠标签：
- GitLab CI 示例：
DOCKER_TAG=$CI_COMMIT_TAG || $CI_COMMIT_SHORT_SHAdocker tag $IMAGE_ID docker.io/myname/app:$DOCKER_TAG - Jenkins 可用构建号 + 时间戳：
20260720-1530或v1.2.0-build-127 - 始终保留一个明确指向主干发布的标签（如
stable），但仅由发布流程手动更新，不自动生成
