Docker Hub 镜像发布指南

发布镜像到 Docker Hub 是开发者分享作品的标准流程。整个过程可以概括为：登录 -> 打标签 -> 推送。

以下是详细的操作步骤：

---

1. 准备工作

在开始之前，请确保：

• 你已经拥有一个 Docker Hub 账号。

• 本地已经安装并运行了 Docker。

• 你有一个已经构建好的本地镜像。你可以通过 docker images 查看。

---

2. 第一步：登录 Docker Hub

打开终端（Terminal 或 PowerShell），使用以下命令登录：

 

docker login

系统会提示你输入 Username 和 Password。登录成功后会显示 Login Succeeded。

---

3. 第二步：为镜像打标签 (Tag)

Docker Hub 要求推送的镜像必须遵循特定的命名规范：你的用户名/镜像名:标签。如果你的本地镜像名字不符合这个格式，你需要用 tag 命令重新标注它。

命令格式：

 

docker tag <本地镜像ID或名称> <你的用户名>/<仓库名称>:<版本标签>

示例： 假设你的用户名是 janesmith，本地镜像叫 my-app，你想发布为 v1.0 版本：

 

docker tag my-app janesmith/my-app:v1.0

如果不指定标签，默认会使用 latest。

---

4. 第三步：推送镜像 (Push)

现在你可以将打好标签的镜像推送到云端仓库了。

命令格式：

 

docker push <你的用户名>/<仓库名称>:<版本标签>

示例：

docker push janesmith/my-app:v1.0

推送过程中，你会看到进度条显示数据块正在上传。完成后，你就可以在 Docker Hub 的网页后台看到这个镜像了。

---

💡 进阶小贴士

• 公共 vs 私有： 免费账户通常只允许创建一个私有仓库 (Private Repository)，其余均为公开。如果你不希望别人看到你的代码，请在 Docker Hub 网页端先创建一个私有仓库，再进行推送。

• 退出登录： 如果你在公共电脑上操作，完成后建议退出登录以保护安全：

   

  docker logout

• 查看结果： 推送成功后，任何人（如果是公开仓库）都可以通过以下命令下载你的镜像：

   

  docker pull janesmith/my-app:v1.0