Apache HTTP Server (httpd) i386 架构 Docker 镜像文档

说明

本仓库是 官方 httpd 镜像 的 i386 架构专用构建版本。更多信息请参见官方镜像文档中的 "非 amd64 架构说明" 和官方镜像 FAQ 中的 "镜像源码在 Git 中变更后如何处理？"。

快速参考

维护者

Docker 社区

支持渠道

Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应 Dockerfile 链接

• 2.4.65, 2.4, 2, latest, 2.4.65-trixie, 2.4-trixie, 2-trixie, trixie
• 2.4.65-alpine, 2.4-alpine, 2-alpine, alpine, 2.4.65-alpine3.22, 2.4-alpine3.22, 2-alpine3.22, alpine3.22

其他快速参考

• 问题反馈地址：[***]
• 支持的架构（更多信息）：amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x
• 镜像制品详情：repo-info 仓库的 repos/httpd/ 目录（历史记录）（包含镜像元数据、传输大小等）
• 镜像更新：official-images 仓库的 library/httpd 标签、official-images 仓库的 library/httpd 文件（历史记录）
• 本文档来源：docs 仓库的 httpd/ 目录（历史记录）

镜像概述和主要用途

Apache HTTP Server（简称 Apache 或 httpd）是一款广泛使用的 Web 服务器应用程序，在万维网的早期发展中发挥了关键作用。其最初基于 NCSA HTTPd 服务器开发，1995 年初 NCSA 代码开发停滞之后，Apache 的开发工作启动。Apache 迅速超越 NCSA HTTPd 成为主流 HTTP 服务器，并自 1996 年 4 月起一直是使用最广泛的 HTTP 服务器。

!logo

主要用途：

• 提供 HTTP/HTTPS 协议的 Web 服务
• 托管静态网页、动态内容及 Web 应用
• 作为反向代理服务器转发请求
• 支持模块化扩展以增强功能（如 SSL、身份验证、缓存等）

核心功能和特性

1. 官方上游兼容性：基于 Apache 官方上游代码构建，保留默认配置和功能，确保与官方版本一致性。
2. 多架构支持：除 i386 外，还提供 amd64、arm 系列、ppc64le 等多种架构版本，适配不同硬件环境。
3. 轻量化变体：提供基于 Alpine Linux 的 -alpine 标签版本，镜像体积显著减小（约 5MB 基础镜像），适合资源受限场景。
4. 灵活配置：支持通过挂载或复制自定义配置文件修改 Apache 服务参数，满足个性化需求。
5. SSL/HTTPS 支持：内置 SSL 模块，可通过简单配置启用 HTTPS 加密传输。
6. 易于扩展：可作为基础镜像，通过 Dockerfile 添加 PHP 等运行时环境或扩展模块。

使用场景和适用范围

1. 开发环境：快速搭建本地 Web 服务，用于前端页面调试、静态资源预览。
2. 静态网站部署：托管纯 HTML/CSS/JS 静态网站，如个人博客、项目文档站点。
3. 自定义 Apache 配置场景：需要修改默认端口、启用特定模块（如 rewrite、gzip）或配置虚拟主机的场景。
4. HTTPS 服务：需通过 SSL 证书加密传输的 Web 应用，如电商网站、需要身份验证的后台系统。
5. CI/CD 流水线：作为构建或测试环节的临时 Web 服务节点，提供集成测试环境。

详细的使用方法和配置说明

基础部署方法

使用 Dockerfile 部署

1. 在项目中创建 Dockerfile：

   FROM i386/httpd:2.4
   COPY ./public-html/ /usr/local/apache2/htdocs/
   

   （其中 public-html/ 为项目中存放 HTML 文件的目录）

2. 构建并运行镜像：

   $ docker build -t my-apache2 .
   $ docker run -dit --name my-running-app -p 8080:80 my-apache2
   

3. 访问 http://localhost:8080，将显示默认页面或自定义的静态内容。

不使用 Dockerfile 直接运行

通过挂载本地目录到容器内 Web 根目录，无需编写 Dockerfile：

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

（"$PWD" 为当前工作目录，需包含待托管的 HTML 文件）

Docker Compose 部署示例

创建 docker-compose.yml 文件：

version: '3'
services:
  httpd:
    image: i386/httpd:2.4
    container_name: my-apache-service
    ports:
      - "8080:80"  # 映射 HTTP 端口
      # - "443:443"  # 如需 HTTPS，取消注释并映射 443 端口
    volumes:
      - ./public-html:/usr/local/apache2/htdocs  # 挂载静态文件目录
      # - ./my-httpd.conf:/usr/local/apache2/conf/httpd.conf  # 如需自定义配置，取消注释并挂载配置文件
    restart: unless-stopped  # 容器退出时自动重启（非手动停止除外）

启动服务：

$ docker-compose up -d

配置自定义

获取默认配置文件

如需修改 Apache 配置，先从容器中提取默认配置：

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

应用自定义配置

通过 Dockerfile 复制自定义配置：

FROM i386/httpd:2.4
COPY ./my-httpd.conf /usr/local/apache2/conf/httpd.conf  # 替换默认配置

或通过运行时挂载配置文件：

$ docker run -dit --name my-custom-apache -p 8080:80 -v "$PWD/my-httpd.conf":/usr/local/apache2/conf/httpd.conf i386/httpd:2.4

SSL/HTTPS 配置

1. 准备证书文件：将 server.crt（证书）和 server.key（私钥）放置在本地目录（如 ./ssl/）。

2. 修改配置启用 SSL 模块： 编辑自定义配置文件 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 自动启用 SSL（可选）：

   FROM i386/httpd:2.4
   # 启用 SSL 模块并包含 SSL 配置
   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. 运行容器并映射 443 端口：

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

镜像变体

i386/httpd 镜像提供多种标签变体，适用于不同场景：

i386/httpd:<version>（如 2.4.65, 2.4, latest）

• 基础：基于 Debian 系统（如标签中的 trixie 对应 Debian 发行版代号）。
• 特点：包含完整的系统工具链，兼容性好，适合需要安装额外依赖包的场景。
• 适用场景：对系统兼容性要求高、需安装 Debian 包的生产或开发环境。

i386/httpd:<version>-alpine（如 2.4.65-alpine, alpine）

• 基础：基于 Alpine Linux，使用 musl libc 替代 glibc。
• 特点：镜像体积极小（约为 Debian 基础版本的 1/5），启动速度快，资源占用低。
• 注意事项：musl libc 与部分依赖 glibc 的软件可能存在兼容性问题，且默认不包含 bash、git 等工具，需通过 apk add 手动安装。
• 适用场景：对镜像大小和资源占用敏感的场景，如边缘计算、容器编排平台（Kubernetes）中的微服务。

许可证信息

本镜像包含的软件许可证信息请参见 Apache 官方许可证页面。

与所有 Docker 镜像一样，本镜像可能包含其他软件（如基础系统的 Bash 等），这些软件可能具有各自的许可证。

部分自动检测到的额外许可证信息可在 repo-info 仓库的 httpd/ 目录 中找到。

对于任何预构建镜像的使用，镜像用户有责任确保其使用行为符合镜像内所有软件的相关许可证要求。