httpd (arm32v5) 镜像文档

注意：这是 httpd官方镜像 的 arm32v5 架构构建的“按架构”仓库——更多信息，请参见官方镜像文档中的“除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

快速参考（续）

• 问题提交地址：
  [***]

• 支持的架构：(更多信息)
  amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x

• 已发布镜像 artifact 详情：
  repo-info 仓库的 repos/httpd/ 目录 (历史记录)
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/httpd 标签
  official-images 仓库的 library/httpd 文件 (历史记录)

• 本描述的来源：
  docs 仓库的 httpd/ 目录 (历史记录)

什么是 httpd？

Apache HTTP Server（俗称Apache）是一款Web服务器应用，因在万维网初期发展中发挥关键作用而闻名。最初基于NCSA HTTPd服务器，Apache的开发始于1995年初，当时NCSA代码的开发停滞。Apache迅速超越NCSA HTTPd成为主流HTTP服务器，自1996年4月起一直是使用最广泛的HTTP服务器。

***.org/wiki/Apache_HTTP_Server

!logo

如何使用此镜像

此镜像仅包含Apache httpd及其上游默认配置。未安装PHP，但扩展起来并不困难。另一方面，如果您需要带Apache httpd的PHP环境，请参见 PHP镜像 并查看 -apache 标签。如果您想运行简单的HTML服务器，可在项目中添加一个简单的Dockerfile，其中 public-html/ 是包含所有HTML文件的目录。

在项目中创建 Dockerfile

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

然后，运行以下命令构建并运行Docker镜像：

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

访问 http://localhost:8080，您将看到“It works!”。

不使用 Dockerfile

如果不想在项目中包含 Dockerfile，执行以下命令即可：

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

配置

要自定义httpd服务器的配置，首先从容器中获取上游默认配置：

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

然后，您可以将自定义配置 COPY 为 /usr/local/apache2/conf/httpd.conf：

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

SSL/HTTPS

如果想通过SSL运行Web流量，最简单的设置是将您的 server.crt 和 server.key COPY 或挂载（-v）到 /usr/local/apache2/conf/，然后通过移除以下行的注释符号来自定义 /usr/local/apache2/conf/httpd.conf：

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

conf/extra/httpd-ssl.conf 配置文件将使用先前添加的证书文件，并告诉守护进程同时监听443端口。确保在 docker run 中添加类似 -p 443:443 的参数以转发https端口。

这可以通过类似以下的 sed 命令行实现：

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

上述步骤适用于开发环境，但建议为生产环境自定义配置文件，更多SSL设置信息请参见 httpd.apache.org。

许可证

查看此镜像中包含的软件的 许可证信息。

与所有Docker镜像一样，这些镜像可能还包含其他软件，这些软件可能具有其他许可证（例如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。

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

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可证。