推送Docker镜像到Docker Hub需三步：先用docker tag重命名为用户名/仓库名:标签格式，再docker login登录账号，最后docker push推送指定标签镜像。
推送 docker 镜像到 docker hub 不是单条命令能完成的事，而是一套连贯操作。核心命令只有 docker login 和 docker push，但前提必须满足：镜像已构建、命名合规、账号已登录。下面分关键环节说明。
确保镜像名称符合 Docker Hub 规范
Docker Hub 要求推送的镜像名必须是 用户名/仓库名[:标签] 格式（如 xiaoming/my-web-app:v1.2.0）。如果你本地镜像叫 my-web-app，它默认属于“本地命名空间”，不能直接推送。
- 用
docker images查看当前镜像名和 ID - 用
docker tag重命名：docker tag my-web-app xiaoming/my-web-app:v1.2.0 - 再次运行
docker images，确认新标签已出现
登录 Docker Hub 账号
必须先登录，否则 docker push 会报错 “unauthorized: authentication required”。
- 终端执行：
docker login - 按提示输入你的 Docker Hub 用户名和密码（支持邮箱）
- 成功后显示
Login Succeeded - ⚠️ 注意：密码不会回显，输完直接回车即可
执行推送命令
推送的是你打过标签的完整名称（含用户名前缀），不是原始镜像名。
- 命令格式：
docker push xiaoming/my-web-app:v1.2.0 - 如果省略标签，默认推
:latest：docker push xiaoming/my-web-app - 推送过程会逐层上传，终端显示压缩、上传、校验进度
- 完成后可在 Docker Hub 个人仓库页 看到该镜像
常见问题快速排查
推送失败大多源于三类原因：
-
名称不匹配：检查
docker images输出中是否有xiaoming/my-web-app:v1.2.0，没有就说明docker tag没生效 -
未登录或登录失效：运行
docker logout再重新docker login - 网络或权限问题：确认 Docker Hub 上已创建同名公开仓库（私有仓库需额外设置权限），且账号未被限流
