Docker 镜像推送命令如何用

核心三步是登录仓库、打标签、执行推送：必须先用docker login登录目标Registry，再用docker tag将本地镜像重命名为完整路径格式（含仓库地址、命名空间和标签），最后执行docker push；未登录或标签不合规将直接失败。

用 docker push 命令推送镜像，核心就三步：登录仓库、打标签、执行推送。不登录或标签不对，命令会直接失败。

必须先登录目标 Registry

推送前得让 Docker 知道你是谁：

1. 推送到 Docker Hub：运行 docker login，然后输入用户名和密码
2. 推送到私有仓库（比如 Harbor 或自建 registry）：加上地址，例如 docker login my-registry.com:5000
3. 推送到阿里云 ACR：用控制台生成的地址登录，如 docker login registry.cn-hangzhou.aliyuncs.com

镜像名称必须带完整路径和标签

Docker 不会自动帮你补全仓库地址，本地镜像名（如 myapp）不能直接推送。得用 docker tag 改成目标格式：

1. Docker Hub 示例：docker tag myapp:1.0 username/myapp:1.0
2. 私有仓库示例：docker tag myapp:1.0 my-registry.com/project/myapp:v1.2
3. 阿里云 ACR 示例：docker tag nginx:latest registry.cn-hangzhou.aliyuncs.com/my-ns/nginx:v1

注意：路径中不能含大写字母、下划线或中文；latest 标签不建议用于生产环境。

执行推送并确认结果

打完标签后，直接运行 docker push 加上完整镜像名：

1. docker push username/myapp:1.0
2. docker push my-registry.com/project/myapp:v1.2
3. docker push registry.cn-hangzhou.aliyuncs.com/my-ns/nginx:v1

成功时会逐层显示 Pushed，最后提示 digest；失败时常见原因包括：未登录、权限不足、网络不通、镜像名拼写错误或命名空间不存在。

推送前建议检查几件事

避免白忙活：

1. 用 docker images 确认本地存在要推送的镜像及对应标签
2. 用 docker run -it --rm 镜像名 快速验证镜像能否正常启动
3. 私有仓库记得提前创建好命名空间/项目，并确保账号有写入权限
4. 大镜像可加 --no-cache（但实际效果有限，主要影响构建，非推送）