Docker 安装 Apache（完整教程）

为什么选择 Docker 安装 Apache？

在开发 Web 应用时，Apache 是最经典、最稳定的 Web 服务器之一。它支持静态页面、PHP、反向代理等多种功能，是许多项目的基础组件。但传统的安装方式往往需要处理依赖、配置文件路径、端口冲突等问题，尤其是当你在不同环境中部署时，容易出现“在我电脑上能跑”的尴尬局面。

这时候，Docker 就像一位“标准化的搬运工”，它能把你需要的 Apache 环境打包成一个轻量级、可移植的容器。无论你是在 Windows、Mac 还是 Linux 上工作，只要装了 Docker，就能快速搭建一个一致的 Apache 环境。

简单来说，Docker 安装 Apache 的优势在于：

无需手动配置复杂的依赖
环境隔离，避免与其他服务冲突
快速启动、停止、删除容器，便于测试和迭代
一键部署，适合团队协作与 CI/CD 流程

这就像你不再需要自己去“搭房子”（配置服务器），而是直接搬进一个预制好的“集装箱”里，开箱即用。

准备工作：安装 Docker 环境

在开始 Docker 安装 Apache 之前，你需要确保你的系统已经安装并运行了 Docker。如果你还不了解 Docker 是什么，可以把它想象成一个“虚拟的沙盒”，每个容器都是一个独立的小环境，互不干扰。

下载并安装 Docker Desktop

前往 Docker 官网下载适用于你操作系统的 Docker Desktop。

Windows 用户：选择 .exe 安装包，安装时建议启用 WSL 2 支持（性能更好）
Mac 用户：下载 .dmg 文件，拖动安装即可
Linux 用户：推荐使用包管理器安装，例如 Ubuntu 上运行：

sudo apt update

sudo apt install -y ca-certificates curl gnupg lsb-release

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

安装完成后，验证 Docker 是否正常运行：

docker --version

docker info

如果输出类似 Docker version 24.0.7 且无报错，说明安装成功。

拉取 Apache 镜像并运行容器

现在我们正式进入 Docker 安装 Apache 的核心环节。

Docker 官方仓库（Docker Hub）提供了官方的 Apache 镜像，你可以直接拉取使用，无需自己构建。

拉取 Apache 镜像

运行以下命令从 Docker Hub 下载 Apache 的最新稳定版本镜像：

docker pull httpd:2.4

这条命令的作用是：

docker pull：从远程仓库下载镜像
httpd:2.4：指定镜像名称和标签（tag），httpd 是 Apache 的官方项目名，2.4 是版本号

💡 提示：如果不写版本号，默认会拉取 latest 标签。但建议明确指定版本，避免因镜像更新导致兼容性问题。

启动 Apache 容器

现在我们用这个镜像启动一个容器，让它运行 Apache 服务。

docker run -d \
  --name apache-web \
  -p 8080:80 \
  -v $(pwd)/html:/usr/local/apache2/htdocs \
  httpd:2.4

逐行解释：

docker run：运行一个新容器
-d：后台运行（detached 模式），容器启动后不占用终端
--name apache-web：为容器命名，方便后续管理
-p 8080:80：将主机的 8080 端口映射到容器的 80 端口。Apache 默认监听 80 端口，我们通过 8080 访问，避免权限冲突
-v $(pwd)/html:/usr/local/apache2/htdocs：挂载本地目录到容器内的网页目录。$(pwd) 表示当前目录，html 是本地文件夹，/usr/local/apache2/htdocs 是 Apache 的默认网页根目录
httpd:2.4：使用刚才拉取的镜像

✅ 重要：如果你没有创建 html 文件夹，系统会报错。请提前执行：
mkdir -p html
echo "<h1>Hello from Docker Apache!</h1>" > html/index.html

验证 Apache 是否正常运行

容器启动后，我们可以通过浏览器访问 http://localhost:8080 来查看效果。

如果看到页面显示：

Hello from Docker Apache!

说明 Docker 安装 Apache 成功了！

查看容器日志

如果页面无法访问，可以查看容器日志排查问题：

docker logs apache-web

常见问题包括：

端口被占用 → 换一个主机端口，如 -p 8081:80
网页文件路径错误 → 检查 -v 挂载路径是否正确
配置文件权限问题 → 确保本地文件可读

自定义 Apache 配置文件

Docker 安装 Apache 的灵活性在于，你可以轻松修改配置文件，而不影响原始镜像。

添加自定义配置文件

在本地创建一个 conf 目录，用于存放自定义配置：

mkdir -p conf

创建 conf/httpd.conf 文件，内容如下：

Listen 80

ServerName localhost

<Directory "/usr/local/apache2/htdocs">
    Options Indexes FollowSymLinks
    AllowOverride None
    Require all granted
</Directory>

DirectoryIndex index.html index.php

✅ 注释说明：

Listen 80：Apache 监听 80 端口

Directory 块控制目录访问权限

AllowOverride None：关闭 .htaccess 文件支持（生产环境建议关闭以提升性能）

DirectoryIndex：指定默认首页文件顺序

挂载配置文件到容器

修改启动命令，把自定义配置文件挂载进去：

docker run -d \
  --name apache-custom \
  -p 8080:80 \
  -v $(pwd)/html:/usr/local/apache2/htdocs \
  -v $(pwd)/conf/httpd.conf:/usr/local/apache2/conf/httpd.conf \
  httpd:2.4

注意：这次我们用 -v 挂载了 conf/httpd.conf 到容器内的配置路径。Docker 会优先读取这个文件，覆盖默认配置。

常见问题与解决方案

在使用 Docker 安装 Apache 的过程中，开发者常遇到以下问题，这里逐一说明：

问题现象	可能原因	解决方案
浏览器无法访问 `localhost:8080`	端口被占用或防火墙拦截	更换主机端口，如 `-p 8081:80`，或检查防火墙设置
页面显示 403 Forbidden	权限不足或目录配置错误	检查 `Directory` 块中的 `Require all granted` 是否存在
无法加载自定义配置	配置文件路径错误或语法错误	使用 `docker logs` 查看错误日志，检查 `httpd.conf` 语法
容器启动失败	镜像拉取失败或磁盘空间不足	运行 `docker system prune` 清理无用镜像，或检查网络

🔍 小贴士：Apache 配置语法错误会导致容器无法启动。建议使用 docker exec 进入容器检查配置：

docker exec -it apache-web /bin/bash

httpd -t

如果输出 Syntax OK，说明配置正确。

总结与进阶建议

通过本文，你已经掌握了 Docker 安装 Apache 的完整流程：从环境准备、镜像拉取、容器启动，到自定义配置与问题排查。整个过程不仅简单高效，还具备良好的可复用性和跨平台兼容性。

未来你可以基于这个 Apache 容器，进一步扩展功能：

添加 PHP 支持（使用 php:8.2-apache 镜像）
配合 Nginx 做反向代理
通过 Docker Compose 管理多个服务（如 Apache + MySQL + PHP）

记住，Docker 安装 Apache 不仅是一种技术选择，更是一种开发习惯的转变——从“我怎么配置”变成“我怎么组合”。当你能熟练使用容器化部署时，你的开发效率和环境一致性将得到质的飞跃。

最后，无论你是初学者还是中级开发者，只要动手尝试一次 Docker 安装 Apache，就会发现：原来让服务器跑起来，可以这么简单。