library/httpd
Apache HTTP服务器项目是由Apache软件基金会主导开发的开源HTTP服务器，作为全球使用最广泛的Web服务器之一，它支持跨平台运行（包括Linux、Windows等多种操作系统），采用模块化设计以灵活扩展功能，具备高性能、高可靠性及强大的安全性，通过活跃的全球开发者社区持续更新维护，广泛应用于从小型个人网站到大型企业级网络服务的各类场景，为互联网基础设施提供稳定高效的Web服务支持。
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Apache HTTP Server (httpd) Docker镜像使用指南
快速参考
维护方
[Docker社区]
获取帮助渠道
[Docker社区Slack] 、[Server Fault] 、[Unix & Linux Stack Exchange] 或 [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]
快速参考（续）
提交issue地址
[[]]
支持的架构
（[更多信息] ）
[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服务器开发，1995年初NCSA代码开发停滞后续航，Apache迅速取代NCSA HTTPd成为主流HTTP服务器，自1996年4月起持续保持使用率第一。
![Apache logo]
如何使用本镜像
基础说明
本镜像仅包含Apache httpd的上游默认配置，未预装PHP。如需PHP+Apache环境，可参考[PHP镜像] 的-apache标签。若需运行简单HTML服务，可在项目中添加Dockerfile，将public-html/目录（存放HTML文件）复制到镜像中。
方法一：通过Dockerfile使用
1. 在项目中创建Dockerfile
dockerfileFROM docker.xuanyuan.run/httpd:2.4 COPY ./public-html/ /usr/local/apache2/htdocs/
2. 构建并运行镜像
执行以下命令：
console$ docker build -t my-apache2 . $ docker run -dit --name my-running-app -p 8080:80 my-apache2
访问`[] works!”即成功。
方法二：不使用Dockerfile
直接通过-v参数挂载本地目录到容器：
CODE_TOKEN_2
配置自定义
获取默认配置文件
先从容器中导出上游默认配置：
CODE_TOKEN_3
修改并应用配置
在Dockerfile中复制自定义配置文件覆盖默认配置：
CODE_TOKEN_4
SSL/HTTPS设置
基础步骤
- 将
server.crt和server.key复制或挂载（-v）到/usr/local/apache2/conf/目录。 - 编辑
httpd.conf，移除以下行的注释符号（#）：
CODE_TOKEN_5 conf/extra/httpd-ssl.conf会自动使用上述证书文件，并监听443端口。运行容器时需添加-p 443:443端口映射。
快捷配置（通过Dockerfile）
可使用sed命令批量移除注释：
CODE_TOKEN_6
注意：以上步骤适用于开发环境，生产环境需参考[Apache官方文档] 优化配置。
镜像版本说明
httpd:<version>
默认版本，基于Debian系统。适合大多数场景，可直接作为临时容器（挂载代码启动）或基础镜像构建其他镜像。标签中含trixie等名称时，表示基于Debian对应版本（如trixie为Debian 13），如需安装额外依赖，建议显式指定此类标签以减少版本变更影响。
httpd:<version>-alpine
基于[Alpine Linux] （[alpine官方镜像] ），体积极小（约5MB基础镜像），适合对镜像大小敏感的场景。
注意事项
- 使用musl libc替代glibc，部分依赖glibc的软件可能兼容性问题（参考[相关讨论] ）。
- 为精简体积，通常不含
git、bash等工具，需在Dockerfile中自行安装（参考[alpine镜像说明] ）。
许可证
软件许可证
查看[Apache许可证信息] 。
镜像包含软件的许可证
所有Docker镜像可能包含基础系统（如Bash）及依赖软件，其许可证可能不同。部分自动检测的许可证信息可在[repo-info仓库的httpd/目录] 查看。
使用责任
使用预构建镜像时，用户需自行确保符合所有包含软件的许可证要求。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull httpd:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"