Apache HTTP Server (httpd) Docker 镜像文档

镜像概述和主要用途

amd64/httpd 镜像是 Apache HTTP Server（简称 Apache）的官方 Docker 镜像，专为 amd64 架构构建。Apache 是一款广泛使用的 Web 服务器应用，在万维网发展初期发挥了关键作用，自 1996 年 4 月起一直是最流行的 HTTP 服务器之一。该镜像提供了轻量级、可移植的 Apache 运行环境，适用于快速部署静态或动态 Web 服务。

核心功能和特性

• 官方维护：由 Docker 社区维护，与上游 Apache 版本同步更新。
• 多架构支持：除 amd64 外，还支持 arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x 等架构。
• 灵活配置：可通过自定义配置文件修改 Apache 服务参数，支持 SSL/HTTPS 加密。
• 多基础镜像变体：提供基于 Debian（默认）和 Alpine Linux 的镜像，满足不同场景需求（如追求最小镜像体积）。
• 即开即用：内置默认配置，无需额外依赖即可快速启动基础 Web 服务。

支持的标签和架构

标签列表

以下标签对应不同版本和基础镜像，链接指向对应的 Dockerfile 源码：

• Debian 基础镜像：
  2.4.65, 2.4, 2, latest, 2.4.65-trixie, 2.4-trixie, 2-trixie, trixie

• Alpine 基础镜像：
  2.4.65-alpine, 2.4-alpine, 2-alpine, alpine, 2.4.65-alpine3.22, 2.4-alpine3.22, 2-alpine3.22, alpine3.22

支持的架构

该镜像支持多种硬件架构，对应不同 Docker 仓库：
amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x

使用场景和适用范围

• 静态网站部署：快速托管 HTML、CSS、JavaScript 等静态资源。
• 开发环境：本地搭建与生产环境一致的 Web 服务，验证页面效果。
• 自定义 Web 服务：通过修改配置文件支持反向代理、URL 重写、虚拟主机等高级功能。
• HTTPS 服务：配置 SSL 证书实现加密传输，满足安全要求。
• 轻量级部署：选择 Alpine 变体减少镜像体积，适合资源受限环境。

详细使用方法和配置说明

1. 通过 Dockerfile 构建镜像

适用于需要预先打包静态资源或自定义配置的场景。

步骤：

1. 在项目根目录创建 Dockerfile：

   FROM amd64/httpd:2.4
   # 将本地静态资源目录复制到 Apache 文档根目录
   COPY ./public-html/ /usr/local/apache2/htdocs/
   

   注：public-html/ 为本地存放 HTML 文件的目录，需替换为实际路径。

2. 构建并运行镜像：

   # 构建镜像（标签为 my-apache2）
   docker build -t my-apache2 .
   
   # 后台运行容器（映射主机 8080 端口到容器 80 端口）
   docker run -dit --name my-running-app -p 8080:80 my-apache2
   

3. 验证：访问 http://localhost:8080，显示 "It works!" 或自定义页面。

2. 不使用 Dockerfile 直接运行

适用于临时测试或快速挂载本地目录的场景。

直接通过 docker run 命令挂载本地目录到容器的文档根目录：

docker run -dit --name my-apache-app -p 8080:80 -v "$PWD":/usr/local/apache2/htdocs/ amd64/httpd:2.4

说明：-v "$PWD":/usr/local/apache2/htdocs/ 将当前目录（$PWD）挂载到容器内的 Apache 文档根目录，修改本地文件后无需重建镜像即可生效。

3. 自定义配置文件

Apache 配置文件路径为 /usr/local/apache2/conf/httpd.conf，可通过以下步骤自定义：

步骤：

1. 从容器中导出默认配置文件：

   docker run --rm amd64/httpd:2.4 cat /usr/local/apache2/conf/httpd.conf > my-httpd.conf
   

2. 编辑 my-httpd.conf 修改配置（如端口、虚拟主机、模块加载等）。

3. 通过 Dockerfile 覆盖默认配置：

   FROM amd64/httpd:2.4
   COPY ./my-httpd.conf /usr/local/apache2/conf/httpd.conf
   

4. 构建并运行：

   docker build -t my-custom-apache .
   docker run -dit --name my-custom-app -p 8080:80 my-custom-apache
   

4. 配置 SSL/HTTPS

实现 HTTPS 需加载 SSL 模块并配置证书，步骤如下：

步骤：

1. 准备 SSL 证书文件（server.crt 公钥和 server.key 私钥），放置于本地目录（如 ./ssl/）。

2. 修改 Apache 配置文件，启用 SSL 模块和相关配置：

   • 从容器导出默认配置（参考 3.1 步骤），编辑 my-httpd.conf，移除以下行的注释符号（#）：

     #LoadModule socache_shmcb_module modules/mod_socache_shmcb.so
     #LoadModule ssl_module modules/mod_ssl.so
     #Include conf/extra/httpd-ssl.conf
     

3. 通过 Dockerfile 复制证书和配置：

   FROM amd64/httpd:2.4
   # 复制自定义配置
   COPY ./my-httpd.conf /usr/local/apache2/conf/httpd.conf
   # 复制 SSL 证书和密钥
   COPY ./ssl/server.crt /usr/local/apache2/conf/
   COPY ./ssl/server.key /usr/local/apache2/conf/
   

   或通过 sed 命令在构建时修改默认配置（无需手动编辑文件）：

   FROM amd64/httpd:2.4
   RUN sed -i \
       -e 's/^#\(Include .*httpd-ssl.conf\)/\1/' \
       -e 's/^#\(LoadModule .*mod_ssl.so\)/\1/' \
       -e 's/^#\(LoadModule .*mod_socache_shmcb.so\)/\1/' \
       conf/httpd.conf
   COPY ./ssl/server.crt /usr/local/apache2/conf/
   COPY ./ssl/server.key /usr/local/apache2/conf/
   

4. 运行容器时映射 HTTPS 端口（443）：

   docker run -dit --name my-ssl-app -p 8080:80 -p 443:443 my-ssl-apache
   

5. 验证：访问 https://localhost，浏览器显示证书信息及页面内容。

镜像变体

amd64/httpd 提供两种基础镜像变体，适用于不同需求：

1. Debian 基础镜像（默认）

标签格式：amd64/httpd:<version>（如 2.4.65、latest）。

• 基于 Debian 系统（如 trixie 版本），包含完整的系统工具链。
• 优势：兼容性好，适合需要安装额外依赖（如 apt 包）的场景。
• 注意：镜像体积较大（约 150MB+）。

2. Alpine 基础镜像

标签格式：amd64/httpd:<version>-alpine（如 2.4.65-alpine、alpine）。

• 基于 Alpine Linux，使用 musl libc 替代 glibc。
• 优势：体积极小（约 50MB 以下），启动速度快，适合资源受限环境。
• 注意：部分依赖 glibc 的软件可能存在兼容性问题，需测试验证。

支持与反馈

• 维护者：Docker 社区（GitHub 仓库）
• 获取帮助：Docker Community Slack（链接）、Server Fault、Unix & Linux、Stack Overflow
• 提交 issue：[***]

许可信息

• 镜像中 Apache HTTP Server 的许可信息参见 Apache 官方许可。
• 镜像可能包含其他软件（如基础系统组件、Bash 等），其许可信息需参考各软件自身条款。
• 镜像用户需自行确保使用符合所有包含软件的许可要求。

镜像元数据及构建信息可在 repo-info 仓库 查看。