Docker Hello World（实战指南）

什么是 Docker？从零开始理解容器化技术

如果你是刚接触后端开发或者 DevOps 相关工作，可能会经常听到“Docker”这个词。它听起来像一个神秘的工具，但其实它的核心思想非常简单：把应用程序和它运行所需的一切打包在一起，放到一个独立的“盒子”里。

这个“盒子”就是容器。你可以把它想象成一个微型的虚拟机，但比虚拟机更轻量、启动更快。在没有 Docker 之前，开发人员常常遇到这样的问题：在本地能跑通的代码，放到服务器上就报错。原因可能是环境差异——本地用的是 Python 3.9，服务器却是 Python 3.7；或者缺少某个依赖库。

Docker 就是为了解决这种“在我机器上能跑”的尴尬而诞生的。它让开发、测试、部署环境保持一致，真正做到“一次构建，到处运行”。

接下来，我们就通过一个经典的入门案例——Docker Hello World，带你真正上手 Docker，理解它的运行机制。

Docker Hello World：你的第一个容器

很多技术教程都从“Hello World”开始，这并不是为了炫技，而是因为它足够简单，能让你快速看到成果，建立信心。Docker 的 Hello World 也不例外。

我们先来运行一个最简单的命令：

docker run hello-world

这条命令的含义是：运行一个名为 hello-world 的镜像。如果你是第一次运行，Docker 会自动从官方仓库（Docker Hub）下载这个镜像，然后启动一个容器来执行它。

执行后你会看到输出：

Hello from Docker!
This message shows that your installation appears to be working correctly.
...

看到这行提示，说明你的 Docker 环境已经成功安装并能正常工作了！

📌 小贴士：docker run 是最常用的命令之一，它的作用是“运行一个容器”。hello-world 是一个官方提供的测试镜像，只做一件事——打印一句话，然后退出。

镜像与容器：理解 Docker 的两大核心概念

在运行 docker run hello-world 之前，我们得先搞清楚两个关键概念：镜像 和 容器。

镜像（Image）

镜像是一个只读的模板，它包含了运行某个应用所需的一切：代码、运行环境、系统工具、配置文件等。你可以把镜像想象成一张“系统安装光盘”——它本身不能运行，但可以用来“安装”出一台电脑。

比如，hello-world 镜像就是一张“Hello World”程序的安装盘，它里面只包含一段打印文字的代码和必要的运行环境。

容器（Container）

容器是镜像的运行实例。当你用 docker run 命令启动一个镜像时，Docker 就会从镜像中创建一个容器。容器是可写的、临时的，就像一台正在运行的电脑。

🔄 类比：

  • 镜像 = 安装盘（只读）
  • 容器 = 正在运行的电脑（可写、可操作）

当你执行 docker run hello-world 时，Docker 会：

  1. 检查本地是否有 hello-world 镜像
  2. 如果没有，从 Docker Hub 下载
  3. 从镜像创建一个容器
  4. 启动容器并运行其中的程序
  5. 打印输出后，容器自动停止

查看你的第一个容器：docker ps 命令

我们刚刚运行了一个容器，但它很快就退出了。那它还在不在？怎么查看？

使用下面这个命令：

docker ps -a
  • docker ps：查看正在运行的容器
  • -a：显示所有容器（包括已停止的）

你会看到类似这样的输出：

CONTAINER ID   IMAGE         COMMAND       CREATED         STATUS                     PORTS   NAMES
a1b2c3d4e5f6   hello-world   "/hello"      2 minutes ago   Exited (0) 2 minutes ago           inspiring_babbage

这说明容器已经创建并运行过，状态为“Exited (0)”，表示正常退出。

💡 状态码解释：

  • Exited (0)：程序正常结束
  • Exited (1)：程序异常退出（常见于代码错误）

这个命令非常重要，是你排查问题的第一步。

构建你自己的 Docker 镜像：从零开始

现在你已经知道如何运行别人写的镜像了，下一步是：自己写一个 Docker 镜像。

我们来创建一个简单的 Python 脚本，它会输出 “Hello, Docker!”。

第一步：创建项目目录

mkdir docker-hello-world
cd docker-hello-world

第二步：创建 Python 脚本

创建一个文件 app.py，内容如下：


print("Hello, Docker!")

第三步：编写 Dockerfile

在同一个目录下，创建一个名为 Dockerfile 的文件（注意没有扩展名），内容如下：

FROM python:3.11

WORKDIR /app

COPY app.py .

CMD ["python", "app.py"]

🔍 逐行解释：

  • FROM python:3.11：使用 Python 官方镜像作为基础，版本为 3.11
  • WORKDIR /app：设置工作目录为 /app，相当于进入一个新文件夹
  • COPY app.py .：把本地的 app.py 复制到容器的当前目录
  • CMD ["python", "app.py"]：容器启动后执行的命令，相当于运行 python app.py

第四步：构建镜像

在终端执行：

docker build -t my-hello-world .
  • docker build：构建镜像
  • -t my-hello-world：给镜像打个标签，方便以后识别
  • .：表示当前目录是构建上下文

构建成功后，你会看到类似：

Successfully built a1b2c3d4e5f6
Successfully tagged my-hello-world:latest

第五步：运行你的镜像

docker run my-hello-world

输出：

Hello, Docker!

恭喜！你已经成功构建并运行了属于自己的 Docker 镜像。

常见问题与调试技巧

在学习 Docker 的过程中，你可能会遇到一些常见问题。下面列举几个典型情况和解决方法。

1. 找不到镜像或下载失败

如果你看到类似 Error response from daemon: pull access denied 的错误，说明 Docker 无法访问镜像仓库。

解决方法：

  • 检查网络是否正常
  • 如果你在公司网络，可能需要配置镜像加速器
  • 可以尝试使用国内镜像源，如阿里云的 Docker 镜像服务

2. 容器启动后立即退出

如果运行 docker run 后没有输出，容器立刻停止，可能是 CMD 指令执行完就结束了。

解决方案：

  • 确保你的程序有长时间运行的能力，比如加个 input() 或 while True 循环
  • 或者用 docker run -it 启动交互式容器，方便调试
docker run -it my-hello-world /bin/bash

这会进入容器的命令行，你可以手动运行 python app.py 查看效果。

3. 镜像构建失败

如果 docker build 报错，比如找不到文件，检查：

  • Dockerfile 是否在正确目录
  • COPY 指令中的文件路径是否正确
  • 是否忽略了一些文件（可以创建 .dockerignore 文件）

Docker Hello World 的意义：从入门到实战

Docker Hello World 不只是一个简单的示例，它是通往容器化世界的第一步。通过它，你理解了：

  • 如何运行一个镜像
  • 镜像与容器的区别
  • 如何构建自己的镜像
  • 基本的命令使用和调试方法

当你掌握了这些，就可以进一步学习：

  • 如何运行 Web 服务（如 Nginx、Node.js 应用）
  • 如何使用 Docker Compose 管理多个容器
  • 如何部署到服务器或云平台

Docker 已经成为现代开发中不可或缺的工具。无论是个人项目还是企业级应用，它都能帮助你提升开发效率、减少环境问题。

总结：动手，是学习 Docker 的唯一捷径

Docker 的学习曲线并不陡峭，关键在于“动手实践”。不要害怕犯错，每一个错误都是一次学习的机会。

从 docker run hello-world 开始，一步步构建自己的镜像，运行自己的程序。你会发现，容器化技术并没有想象中那么复杂，反而非常直观和高效。

记住：Docker Hello World 不只是一个开始，更是你掌握现代软件交付流程的起点。当你能熟练使用 Docker，你就已经站在了 DevOps 的门槛上。

继续前进吧，下一个 Docker 应用，也许就是你正在开发的项目。