核心三步是登录仓库、打标签、执行推送：必须先用docker login登录目标Registry，再用docker tag将本地镜像重命名为完整路径格式（含仓库地址、命名空间和标签），最后执行docker push；未登录或标签不合规将直接失败。
用 docker push 命令推送镜像，核心就三步：登录仓库、打标签、执行推送。不登录或标签不对，命令会直接失败。
必须先登录目标 Registry
推送前得让 Docker 知道你是谁：
- 推送到 Docker Hub：运行
docker login，然后输入用户名和密码 - 推送到私有仓库（比如 Harbor 或自建 registry）：加上地址，例如
docker login my-registry.com:5000 - 推送到阿里云 ACR：用控制台生成的地址登录，如
docker login registry.cn-hangzhou.aliyuncs.com
镜像名称必须带完整路径和标签
Docker 不会自动帮你补全仓库地址，本地镜像名（如 myapp）不能直接推送。得用 docker tag 改成目标格式：
- Docker Hub 示例：
docker tag myapp:1.0 username/myapp:1.0 - 私有仓库示例：
docker tag myapp:1.0 my-registry.com/project/myapp:v1.2 - 阿里云 ACR 示例：
docker tag nginx:latest registry.cn-hangzhou.aliyuncs.com/my-ns/nginx:v1
注意：路径中不能含大写字母、下划线或中文；latest 标签不建议用于生产环境。
执行推送并确认结果
打完标签后，直接运行 docker push 加上完整镜像名：
docker push username/myapp:1.0docker push my-registry.com/project/myapp:v1.2docker push registry.cn-hangzhou.aliyuncs.com/my-ns/nginx:v1
成功时会逐层显示 Pushed，最后提示 digest；失败时常见原因包括：未登录、权限不足、网络不通、镜像名拼写错误或命名空间不存在。
推送前建议检查几件事
避免白忙活：
- 用
docker images确认本地存在要推送的镜像及对应标签 - 用
docker run -it --rm 镜像名快速验证镜像能否正常启动 - 私有仓库记得提前创建好命名空间/项目，并确保账号有写入权限
- 大镜像可加
--no-cache（但实际效果有限，主要影响构建，非推送）
