arm64v8/httpd

Apache HTTP Server (arm64v8) 镜像文档

注意： 这是https://hub.docker.com/_/httpd%E7%9A%84%60arm64v8%60%E6%9E%B6%E6%9E%84%E7%89%88%E6%9C%AC%E4%BB%93%E5%BA%93%E3%80%82%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/official-images#architectures-other-than-amd64%E2%80%9D%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E2%80%9D%E3%80%82

快速参考

• 维护者：
  https://github.com/docker-library/httpd

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应Dockerfile链接

• https://github.com/docker-library/httpd/blob/684a447a23a8035356d5cce42e1f85212cfd39a3/2.4/Dockerfile

• https://github.com/docker-library/httpd/blob/42b1c8997488557ae90e80ff64a90830b1563d75/2.4/alpine/Dockerfile

快速参考（续）

• 问题提交地址：
  https://github.com/docker-library/httpd/issues?q=

• 支持的架构：（https://github.com/docker-library/official-images#architectures-other-than-amd64%EF%BC%89
  https://hub.docker.com/r/amd64/httpd/%E3%80%81https://hub.docker.com/r/arm32v5/httpd/%E3%80%81https://hub.docker.com/r/arm32v6/httpd/%E3%80%81https://hub.docker.com/r/arm32v7/httpd/%E3%80%81https://hub.docker.com/r/arm64v8/httpd/%E3%80%81https://hub.docker.com/r/i386/httpd/%E3%80%81https://hub.docker.com/r/ppc64le/httpd/%E3%80%81https://hub.docker.com/r/riscv64/httpd/%E3%80%81https://hub.docker.com/r/s390x/httpd/

• 镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/httpd%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/httpd%EF%BC%89
  （包含镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fhttpd
  https://github.com/docker-library/official-images/blob/master/library/httpd%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/httpd%EF%BC%89

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/httpd%EF%BC%88https://github.com/docker-library/docs/commits/master/httpd%EF%BC%89

什么是 httpd？

Apache HTTP Server（俗称Apache）是一款Web服务器应用，在万维网的初期发展中发挥了关键作用。它最初基于NCSA HTTPd服务器，1995年初NCSA代码开发停滞之后，Apache的开发工作开始。Apache迅速取代NCSA HTTPd成为主流HTTP服务器，自1996年4月以来一直是使用最广泛的HTTP服务器。

***.org/wiki/Apache_HTTP_Server

!https://raw.githubusercontent.com/docker-library/docs/8e367edd887f5fe876890a0ab4d08806527a1571/httpd/logo.png

如何使用本镜像

本镜像仅包含Apache httpd及上游默认配置，未安装PHP，但可轻松扩展。如需带Apache httpd的PHP环境，可查看https://hub.docker.com/_/php/%E7%9A%84%60-apache%60%E6%A0%87%E7%AD%BE%E3%80%82%E8%8B%A5%E9%9C%80%E8%BF%90%E8%A1%8C%E7%AE%80%E5%8D%95HTML%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E5%8F%AF%E5%9C%A8%E9%A1%B9%E7%9B%AE%E4%B8%AD%E6%B7%BB%E5%8A%A0Dockerfile%EF%BC%8C%E5%85%B6%E4%B8%AD%60public-html/%60%E4%B8%BA%E5%8C%85%E5%90%AB%E6%89%80%E6%9C%89HTML%E6%96%87%E4%BB%B6%E7%9A%84%E7%9B%AE%E5%BD%95%E3%80%82

在项目中创建 Dockerfile

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

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

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

访问 http://localhost:8080 即可看到 "It works!"。

不使用 Dockerfile

若不想在项目中包含Dockerfile，可直接执行以下命令：

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

配置

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

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

然后通过COPY将自定义配置复制为/usr/local/apache2/conf/httpd.conf：

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

SSL/HTTPS

若需通过SSL运行Web服务，最简单的设置是将server.crt和server.key复制或挂载（-v）到/usr/local/apache2/conf/，然后修改/usr/local/apache2/conf/httpd.conf，移除以下行的注释符号：

apacheconf
...
#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命令实现：

dockerfile
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。

镜像变体

arm64v8/httpd镜像有多种变体，适用于不同场景。

arm64v8/httpd:<version>

这是默认镜像。若不确定需求，建议使用此版本。它既可作为临时容器（挂载源代码并启动容器运行应用），也可作为构建其他镜像的基础。

部分标签包含如trixie等名称，这些是Debian的版本代号，表示镜像基于该Debian版本。若需在镜像中安装额外包，建议显式指定此类标签，以减少Debian新版本带来的兼容性问题。

arm64v8/httpd:<version>-alpine

此镜像基于流行的Alpine Linux项目（可在https://hub.docker.com/_/alpine%E4%B8%AD%E8%8E%B7%E5%8F%96%EF%BC%89%E3%80%82Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此能生成更精简的镜像。

当最终镜像大小是首要考虑因素时，此变体非常有用。需要注意的是，它使用musl libc而非glibc及相关库，因此软件可能因libc依赖/假设而出现问题。更多讨论参见此Hacker News评论线程。

为最小化镜像大小，Alpine-based镜像通常不包含额外工具（如git或bash）。如需添加，可在Dockerfile中自行安装（参见https://hub.docker.com/_/alpine/%E4%BA%86%E8%A7%A3%E5%8C%85%E5%AE%89%E8%A3%85%E6%96%B9%E6%B3%95%EF%BC%89%E3%80%82

许可证

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

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

部分自动检测到的额外许可证信息可在https://github.com/docker-library/repo-info/tree/master/repos/httpd%E4%B8%AD%E6%89%BE%E5%88%B0%E3%80%82

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