切换语言

Docker Hub 快速入门

目录

Docker Hub 提供了丰富的预构建镜像和资源库，可加速开发流程并减少设置时间。您可以在 Docker Hub 的预构建镜像基础上进行构建，然后通过镜像仓库与您的团队或全球数百万其他开发者共享和分发您自己的镜像。

本指南将向您演示如何查找并运行预先构建的镜像。随后，将引导您创建自定义镜像并通过 Docker Hub 进行共享。

前提条件

步骤 1：在 Docker Hub 的库中查找镜像

您可以在 Docker Hub 本身、Docker Desktop 仪表板中，或使用 docker search CLI 命令进行内容搜索。在 Docker Hub 本身进行搜索提供了最多的探索内容选项。

在 Docker Hub 上搜索或浏览内容：

  1. 导航至 Docker Hub 探索页面。

    在“探索”页面，您可以按目录或类别浏览，或使用搜索功能快速查找内容。

  2. 在 分类 下，选择 Web 服务器。

    显示结果后，您可以使用页面左侧的筛选条件进一步过滤结果。

  3. 在筛选条件中，选择 Docker 官方镜像。

    通过筛选可信内容，您可以仅查看由Docker及其经过验证的发布合作伙伴精心挑选的高质量、安全镜像。

  4. 在结果中选择 nginx 镜像。

    选择镜像将打开该镜像的页面，您可以在该页面上了解有关如何使用该镜像的更多信息。在页面上，您还可以找到用于拉取该镜像的 docker pull 命令。

现在您已经找到了镜像，是时候将其拉取并在您的设备上运行了。

步骤 2：从 Docker Hub 拉取并运行镜像

  1. 在终端中，运行以下命令以拉取并运行 Nginx 镜像。

    $ docker run -p 8080:80 --rm nginx

    docker run 命令会自动拉取并运行镜像，无需先运行 docker pull。有关该命令及其选项的更多信息，请参阅 docker run CLI 参考文档。运行该命令后，您应会看到类似于以下的输出结果。

    Unable to find image 'nginx:latest' locally
latest: Pulling from library/nginx
a480a496ba95: Pull complete
f3ace1b8ce45: Pull complete
11d6fdd0e8a7: Pull complete
f1091da6fd5c: Pull complete
40eea07b53d8: Pull complete
6476794e50f4: Pull complete
70850b3ec6b2: Pull complete
Digest: sha256:28402db69fec7c17e179ea87882667f1e054391138f77ffaf0c3eb388efc3ffb
Status: Downloaded newer image for nginx:latest
/docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration
/docker-entrypoint.sh: Looking for shell scripts in /docker-entrypoint.d/
/docker-entrypoint.sh: Launching /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh
10-listen-on-ipv6-by-default.sh: info: Getting the checksum of /etc/nginx/conf.d/default.conf
10-listen-on-ipv6-by-default.sh: info: Enabled listen on IPv6 in /etc/nginx/conf.d/default.conf
/docker-entrypoint.sh: Sourcing /docker-entrypoint.d/15-local-resolvers.envsh
/docker-entrypoint.sh: Launching /docker-entrypoint.d/20-envsubst-on-templates.sh
/docker-entrypoint.sh: Launching /docker-entrypoint.d/30-tune-worker-processes.sh
/docker-entrypoint.sh: Configuration complete; ready for start up
2024/11/07 21:43:41 [notice] 1#1: using the "epoll" event method
2024/11/07 21:43:41 [notice] 1#1: nginx/1.27.2
2024/11/07 21:43:41 [notice] 1#1: built by gcc 12.2.0 (Debian 12.2.0-14)
2024/11/07 21:43:41 [notice] 1#1: OS: Linux 6.10.11-linuxkit
2024/11/07 21:43:41 [notice] 1#1: getrlimit(RLIMIT_NOFILE): 1048576:1048576
2024/11/07 21:43:41 [notice] 1#1: start worker processes
2024/11/07 21:43:41 [notice] 1#1: start worker process 29
...

  2. 访问 https://localhost:8080 查看默认的 Nginx 页面，以确认容器正在运行。

  3. 在终端中，按 CTRL+C 停止容器。

您现在已通过一条命令运行了一个 Web 服务器，无需任何设置或配置。Docker Hub 提供对预先构建、即用型容器镜像的即时访问，让您能够快速拉取并运行应用程序，而无需手动安装或配置软件。借助 Docker Hub 庞大的镜像库，您可以轻松地实验和部署应用程序，提升工作效率，并简化尝试新工具、搭建开发环境或基于现有软件进行构建的过程。

您还可以从 Docker Hub 扩展镜像，从而快速构建并定制自己的镜像以满足特定需求。

步骤 3：构建镜像并将其推送至 Docker Hub

  1. 创建一个 Dockerfile 来指定您的应用程序：

    FROM nginx
RUN echo "<h1>Hello world from Docker!</h1>" > /usr/share/nginx/html/index.html

    此 Dockerfile 在 Docker Hub 的 Nginx 镜像基础上进行扩展，以创建一个简单的网站。仅需几行代码，您即可轻松设置、自定义并共享一个静态网站。

  2. 运行以下命令以构建您的镜像。请将 <YOUR-USERNAME> 替换为您的 Docker ID。

    $ docker build -t <YOUR-USERNAME>/nginx-custom .

    此命令用于构建您的镜像，并为其打上标签，以便 Docker 能够识别应将其推送到 Docker Hub 中的哪个仓库。有关该命令及其选项的更多信息，请参阅docker build CLI 参考文档。运行该命令后，您将看到类似于以下内容的输出。

    [+] Building 0.6s (6/6) FINISHED                      docker:desktop-linux
 => [internal] load build definition from Dockerfile                  0.0s
 => => transferring dockerfile: 128B                                  0.0s
 => [internal] load metadata for docker.io/library/nginx:latest       0.0s
 => [internal] load .dockerignore                                     0.0s
 => => transferring context: 2B                                       0.0s
 => [1/2] FROM docker.io/library/nginx:latest                         0.1s
 => [2/2] RUN echo "<h1>Hello world from Docker!</h1>" > /usr/share/  0.2s
 => exporting to image                                                0.1s
 => => exporting layers                                               0.0s
 => => writing image sha256:f85ab68f4987847713e87a95c39009a5c9f4ad78  0.0s
 => => naming to docker.io/mobyismyname/nginx-custom                  0.0s

  3. 运行以下命令以测试您的镜像。将 <YOUR-USERNAME> 替换为您的 Docker ID。

    $ docker run -p 8080:80 --rm <YOUR-USERNAME>/nginx-custom

  4. 访问 https://localhost:8080 查看页面。您 应该能看到 Hello world from Docker!。

  5. 在终端中，按 CTRL+C 停止容器。

  6. 登录 Docker Desktop。在将镜像推送到 Docker Hub 之前，您必须先登录。

  7. 运行以下命令将您的镜像推送到 Docker Hub。将 <YOUR-USERNAME> 替换为您的 Docker ID。

    $ docker push <YOUR-USERNAME>/nginx-custom

    注意

    您必须通过 Docker Desktop 或命令行登录 Docker Hub，并且还必须按照上述步骤正确命名您的镜像。

    该命令将镜像推送到 Docker Hub，如果仓库不存在，则会自动创建。要了解有关该命令的更多信息，请参阅 docker push CLI 参考。运行该命令后，您应该会看到类似于以下内容的输出。

    Using default tag: latest
The push refers to repository [docker.io/mobyismyname/nginx-custom]
d0e011850342: Pushed
e4e9e9ad93c2: Mounted from library/nginx
6ac729401225: Mounted from library/nginx
8ce189049cb5: Mounted from library/nginx
296af1bd2844: Mounted from library/nginx
63d7ce983cd5: Mounted from library/nginx
b33db0c3c3a8: Mounted from library/nginx
98b5f35ea9d3: Mounted from library/nginx
latest: digest: sha256:7f5223ae866e725a7f86b856c30edd3b86f60d76694df81d90b08918d8de1e3f size: 1985

既然您已经创建了仓库并推送了镜像，现在是时候查看您的仓库并探索其选项了。

步骤 4：在 Docker Hub 上查看您的仓库并探索选项

  1. 前往 Docker Hub 并登录。

    登录后，您应该会在仓库页面。如果不在，请前往 仓库 页面。

  2. 找到 nginx-custom 仓库并选中该行。

    选择仓库后，您应该能看到该仓库的更多详细信息和选项。

您现在已经验证了您的仓库存在于 Docker Hub 上，并且您已经发现了它的更多选项。查看后续步骤以了解更多关于其中一些选项的信息。

后续步骤

添加 仓库信息 以帮助用户查找和使用 您的镜像。