从零定制Docker镜像：基于CentOS 7.9配置Yum源并部署Nginx

🚀 30+款热门AI模型一站整合，DeepSeek/GLM/Qwen 随心用，限时 5 折。 👉 点击领海量免费额度

在实际容器化开发和运维工作中，我们经常遇到一个核心需求：如何将一个标准的操作系统镜像，快速定制成一个包含特定软件和配置的、可直接部署服务的应用镜像。很多初学者会直接进入容器内部，通过 yum install 安装软件，但这种方式创建的容器状态是临时的，无法复用。Docker 的核心优势在于通过 Dockerfile 实现构建过程的自动化与版本化，从而生成可重复、可移植的镜像。

本文将以一个典型的 Linux 服务部署场景为例，手把手带你完成从零定制一个简单 Docker 镜像的全过程。我们将以 CentOS 7.9 为基础镜像，目标是在镜像内配置一个可用的 Yum 软件仓库，并成功安装并部署一个常用服务（例如 Nginx）。通过这个实践，你将清晰理解 Dockerfile 的编写逻辑、镜像构建的步骤，以及如何验证容器内的服务状态。无论你是刚开始接触 Docker，还是希望巩固镜像定制的基本功，这篇文章都将提供一条可复现的路径。

1. 理解 Docker 镜像定制：从容器临时操作到 Dockerfile 固化

在深入操作之前，必须厘清一个关键概念：我们最终要交付的是一个“镜像”（Image），而不是一个手动配置好的“容器”（Container）。容器是镜像的运行实例，你可以进入一个运行中的容器，随意安装软件、修改配置，但这些改动只存在于当前这个容器实例的生命周期内。一旦容器被删除，所有改动都会丢失。

Dockerfile 是解决这个问题的核心。它是一个文本文件，包含了一系列的指令（Instruction），每一条指令都会在镜像构建过程中创建一个新的“层”（Layer）。这些指令层叠起来，最终形成一个完整的、只读的镜像。当你运行 docker build 命令时，Docker 引擎会逐行执行 Dockerfile 中的指令，并缓存每一层的结果。这种分层机制使得镜像构建高效且可复用。

对于我们的目标——在 CentOS 镜像中配置 Yum 源并安装服务，如果只在容器内操作，步骤大致是：

1. 启动一个基础 CentOS 容器。
2. 进入容器，备份旧的 Yum 源配置文件。
3. 下载并替换为国内镜像源（如阿里云、清华源）以加速下载。
4. 执行 yum install -y nginx 安装服务。
5. 配置服务并启动。

而使用 Dockerfile，我们需要将这些手动步骤翻译成 Dockerfile 指令，例如 RUN 、 COPY 、 WORKDIR 等，从而实现自动化构建。最终，我们通过 docker build -t my-nginx:1.0 . 这样的命令，就能生成一个名为 my-nginx 、标签为 1.0 的镜像。任何人拿到这个 Dockerfile 和构建命令，都能生成一模一样的镜像，这就是“基础设施即代码”思想在容器领域的体现。

2. 环境准备与项目初始化

在开始编写 Dockerfile 之前，需要确保你的开发环境已经就绪。我们将在一个干净的目录中完成所有工作。

2.1 宿主机环境要求与验证

首先，你需要一台安装了 Docker 的 Linux 或 macOS 机器，Windows 用户可以使用 WSL2 或 Docker Desktop。通过以下命令验证 Docker 是否已正确安装并运行：

# 检查 Docker 客户端和服务端版本
docker --version
docker-compose --version # 如果用到 Compose

# 更详细地查看 Docker 系统信息，确认服务状态
docker info

# 运行一个测试容器，验证 Docker 引擎功能是否正常
docker run hello-world

如果 hello-world 容器能成功运行并输出欢迎信息，说明 Docker 环境基本正常。接下来，为我们的镜像定制项目创建一个独立的工作目录，这有助于管理构建上下文（Build Context）。

# 创建一个项目目录并进入
mkdir -p ~/projects/custom-centos-nginx && cd ~/projects/custom-centos-nginx

2.2 规划镜像内容与 Dockerfile 结构

在动手写 Dockerfile 之前，先明确我们要构建的镜像包含哪些内容：

1. 基础镜像 ：选择 centos:7.9.2009 。选择特定版本而非 centos:latest 是生产环境的最佳实践，可以避免因基础镜像版本自动升级带来的不可预测行为。
2. Yum 仓库配置 ：将 CentOS 默认的国外源替换为国内镜像源（如阿里云），以大幅提升软件包下载速度。
3. 目标服务 ：安装并配置 Nginx，这是一个轻量级 Web 服务器，非常适合作为演示。
4. 容器行为 ：定义当容器启动时，自动运行 Nginx。

对应的 Dockerfile 指令规划如下表：

3. 编写 Dockerfile 定制镜像

现在，我们在项目目录中创建 Dockerfile 并逐步实现上述规划。

3.1 创建 Dockerfile 并指定基础镜像

使用文本编辑器（如 Vim、Nano 或 VS Code）创建名为 Dockerfile 的文件（注意没有后缀名）。

# Dockerfile
# 使用官方 CentOS 7.9 特定版本作为基础镜像，确保环境一致性
FROM centos:7.9.2009

# 设置镜像的作者信息（元数据，非必需）
LABEL maintainer="your-email@example.com"

FROM 指令必须是 Dockerfile 的第一条有效指令（除了 ARG ）。它定义了构建过程的基础层。

3.2 配置国内 Yum 镜像源

CentOS 7 默认的 Yum 源速度可能较慢。我们将使用阿里云的镜像源进行替换。这一步需要在容器内执行 shell 命令，因此使用 RUN 指令。

# 配置 Yum 仓库为阿里云镜像，加速软件安装
RUN mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup \
    && curl -o /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo \
    && sed -i -e '/mirrors.cloud.aliyuncs.com/d' -e '/mirrors.aliyuncs.com/d' /etc/yum.repos.d/CentOS-Base.repo \
    && yum clean all \
    && yum makecache

指令详解 ：

• RUN ：在构建过程中，于当前镜像层之上执行命令并提交结果。每一条 RUN 都会创建一个新的镜像层。
• && ：将多个命令串联在一个 RUN 指令中。 这是一个重要的最佳实践 。Docker 镜像的每一层都是只读的，减少 RUN 指令的数量可以有效减少镜像的层数，从而缩小最终镜像的体积。如果分多条 RUN 写，每条都会增加一层。
• yum clean all && yum makecache ：清理旧的缓存并生成新的元数据缓存，确保后续安装使用新的镜像源。

注意 ：网络搜索材料中提到了检查内核版本和下载 Yum 源，但那是 在宿主机上安装 Docker 引擎 的步骤，与我们 在容器内配置 Yum 仓库 是两件不同的事情，切勿混淆。本文的 RUN 指令是在构建镜像时，在未来的容器内部环境中执行的。

3.3 安装并初步配置 Nginx

配置好高速源后，安装 Nginx 就非常简单了。

# 安装 Nginx
RUN yum install -y nginx

# 可选：创建一个简单的自定义首页，替换 Nginx 默认页面
RUN echo '<h1>Hello, Docker! This is a custom CentOS with Nginx.</h1>' > /usr/share/nginx/html/index.html

第一个 RUN 使用 yum install -y nginx 安装软件包。 -y 参数表示自动确认安装，避免构建过程因等待用户输入而挂起。 第二个 RUN 创建了一个简单的 HTML 文件，覆盖 Nginx 的默认欢迎页，这样当我们访问容器时，能立刻看到定制化的内容，便于验证。

3.4 定义容器运行时行为

安装完成后，我们需要告诉 Docker 这个镜像运行时应该做什么。

# 声明容器运行时对外暴露的端口号
EXPOSE 80

# 设置容器启动时执行的默认命令
CMD ["nginx", "-g", "daemon off;"]

指令详解 ：

• EXPOSE 80 ：这是一个元数据指令，用于 声明 容器内的应用程序将监听 80 端口。它并不会自动在宿主机上打开端口映射，实际的端口映射需要在 docker run 时通过 -p 参数指定。
• CMD ["nginx", "-g", "daemon off;"] ：指定容器启动时的默认执行命令。这里以“前台进程”模式启动 Nginx（ daemon off; ）。 这是关键点 ：Docker 容器需要有一个前台进程持续运行，如果进程退出，容器就会停止。Nginx 默认以守护进程（daemon）模式启动，会立即在后台运行并退出启动进程，这会导致 Docker 容器启动后立刻退出。使用 -g "daemon off;" 让 Nginx 保持在前台运行。

至此，一个完整的 Dockerfile 就编写完成了。完整内容如下：

# 定制 CentOS 7.9 并部署 Nginx 的 Dockerfile
FROM centos:7.9.2009
LABEL maintainer="dev@example.com"

# 1. 配置国内 Yum 源 (阿里云)
RUN mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup \
    && curl -o /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo \
    && sed -i -e '/mirrors.cloud.aliyuncs.com/d' -e '/mirrors.aliyuncs.com/d' /etc/yum.repos.d/CentOS-Base.repo \
    && yum clean all \
    && yum makecache

# 2. 安装 Nginx 并创建自定义首页
RUN yum install -y nginx \
    && echo '<h1>Hello, Docker! This is a custom CentOS with Nginx.</h1>' > /usr/share/nginx/html/index.html

# 3. 声明暴露端口和定义启动命令
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

4. 构建镜像与运行验证

有了 Dockerfile，我们就可以将其构建成真正的 Docker 镜像，并运行容器进行验证。

4.1 执行镜像构建命令

在包含 Dockerfile 的项目目录 ( ~/projects/custom-centos-nginx ) 下，执行构建命令：

# 构建镜像，-t 参数用于给镜像打标签，格式为 name:tag
# 最后的 `.` 表示构建上下文为当前目录，Docker 引擎会将该目录下的所有文件发送给守护进程（因此不要放无关大文件）
docker build -t my-centos-nginx:v1.0 .

命令执行后，Docker 守护进程会逐行解析 Dockerfile，下载基础镜像（如果本地没有），并执行每一层指令。你会看到类似下面的输出：

Sending build context to Docker daemon  2.048kB
Step 1/5 : FROM centos:7.9.2009
7.9.2009: Pulling from library/centos
Digest: sha256:...
Status: Downloaded newer image for centos:7.9.2009
 ---> a6d4c6c1a6ec
Step 2/5 : LABEL maintainer="dev@example.com"
 ---> Running in abcd1234
 ---> bcde2345
Step 3/5 : RUN mv /etc/yum.repos.d/CentOS-Base.repo ... && yum makecache
 ---> Running in cdef3456
...
Complete!
 ---> 7890abcd
Step 4/5 : RUN yum install -y nginx ...
 ---> Running in defg4567
...
Installed:
  nginx.x86_64 1:1.20.1-9.el7
Complete!
 ---> 8901bcde
Step 5/5 : CMD ["nginx", "-g", "daemon off;"]
 ---> Running in efgh5678
 ---> 9012cdef
Successfully built 9012cdef
Successfully tagged my-centos-nginx:v1.0

构建成功后，使用 docker images 查看本地镜像列表，应该能看到新构建的 my-centos-nginx 镜像。

docker images | grep my-centos-nginx

4.2 运行容器并验证服务

现在，从我们自定义的镜像启动一个容器。

# 运行容器
# -d: 后台运行
# -p 8080:80: 将宿主机的 8080 端口映射到容器的 80 端口
# --name my-web: 给容器起一个名字，便于管理
docker run -d -p 8080:80 --name my-web my-centos-nginx:v1.0

运行后，可以通过以下命令检查容器状态：

# 查看正在运行的容器
docker ps
# 应该能看到 my-web 容器状态为 Up

# 查看容器日志，确认 Nginx 启动无报错
docker logs my-web

最关键的一步是验证服务是否可达。Nginx 正在容器内的 80 端口监听，我们通过宿主机的 8080 端口访问。

# 方法1：使用 curl 命令（如果宿主机有）
curl http://localhost:8080

# 方法2：直接在浏览器中访问 http://<宿主机IP>:8080

如果一切正常， curl 命令会返回我们之前写入的 HTML 内容： <h1>Hello, Docker! This is a custom CentOS with Nginx.</h1> 。浏览器访问也会显示这个标题。

4.3 进入容器内部检查

为了更深入地验证我们的构建结果，可以进入运行中的容器内部，检查 Yum 源和已安装的软件。

# 使用 exec 命令在运行中的容器内启动一个交互式 shell
docker exec -it my-web /bin/bash

进入容器后，执行以下检查命令：

# 检查 Yum 源是否已替换为阿里云
cat /etc/yum.repos.d/CentOS-Base.repo | grep -i aliyun

# 检查 Nginx 是否已安装且版本正确
nginx -v

# 检查 Nginx 服务进程
ps aux | grep nginx

# 检查我们创建的自定义首页
cat /usr/share/nginx/html/index.html

完成检查后，输入 exit 退出容器。

5. 常见问题排查与优化实践

在构建和运行自定义镜像的过程中，你可能会遇到一些问题。下面列出一些典型场景及其解决方法。

5.1 构建阶段常见问题

5.2 运行阶段常见问题

5.3 镜像优化与生产环境建议

我们构建的镜像是一个可用的起点，但为了用于开发测试甚至生产环境，还需要考虑以下优化点：

1. 使用更小的基础镜像 ： centos:7.9.2009 体积较大（约 200MB）。可以考虑使用 alpine （仅 5MB）或 debian:bullseye-slim 等更精简的镜像作为基础，能显著减少镜像拉取时间和磁盘占用。但需要注意软件包管理命令（ apk vs apt ）和库的差异。
2. 多阶段构建（Multi-stage Build） ：如果你的应用需要编译（如 Golang、Java），可以在一个大的“构建镜像”中完成编译，然后将编译好的二进制文件复制到一个干净的“运行镜像”中。这可以避免将编译工具、源代码等冗余文件打包进最终镜像。
3. 非 root 用户运行 ：默认情况下，容器内的进程以 root 用户运行，存在安全风险。应在 Dockerfile 中创建并切换到一个非 root 用户来运行应用。

   RUN groupadd -r nginx-group && useradd -r -g nginx-group nginx-user
   USER nginx-user
   

4. 健康检查（HEALTHCHECK） ：添加 HEALTHCHECK 指令，让 Docker 引擎能够判断容器内应用的健康状态，这对于编排工具（如 Kubernetes）非常重要。

   HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
     CMD curl -f http://localhost/ || exit 1
   

5. 环境变量与配置外置 ：不要将配置文件硬编码在镜像里。使用 ENV 指令定义环境变量，或通过 docker run -e 传入。对于配置文件，可以使用 VOLUME 指令挂载宿主机目录或配置卷，实现配置与镜像分离。

通过以上步骤，你不仅完成了一个从定制 Yum 源到安装服务的完整 Docker 镜像构建流程，还掌握了排查常见问题的方法和面向生产环境的优化思路。下次当你需要为一个简单的应用制作 Docker 镜像时，就可以遵循这个模式：明确需求、编写 Dockerfile、构建测试、优化调整。

🚀 30+款热门AI模型一站整合，DeepSeek/GLM/Qwen 随心用，限时 5 折。 👉 点击领海量免费额度