devopsansiblede/apache

Apache Web服务器容器镜像文档

镜像概述

本镜像基于Apache HTTP Server构建，旨在提供一个轻量级、易于部署的Web服务器容器化解决方案。通过Docker容器化技术，可快速搭建支持HTTP/HTTPS协议的Web服务，适用于开发、测试及小型生产环境。

镜像源代码仓库：https://github.com/devops-ansible/apache

核心功能与特性

Apache服务核心特性

• 支持HTTP/1.1、HTTP/2协议
• 模块化架构，可扩展支持PHP、Python等多种编程语言
• 虚拟主机配置，支持多域名站点部署
• 完善的日志记录功能（访问日志、错误日志）
• 支持SSL/TLS加密（需配置证书）

Docker镜像特性

• 轻量级设计，基于官方基础镜像优化
• 即开即用，无需复杂环境配置
• 容器化隔离，避免系统环境冲突
• 支持配置文件和网站目录挂载，便于自定义

使用场景与适用范围

• 开发环境：快速搭建本地Web服务，用于网页开发和调试
• 测试环境：CI/CD流程中作为Web服务组件，验证前端资源或API接口
• 小型生产环境：部署静态网站、小型动态网站（如基于PHP的博客系统）
• 学习环境：用于Apache服务器配置学习和实践

使用方法与配置说明

镜像获取

通过Docker命令拉取镜像（假设镜像已发布至Docker Hub）：

bash
docker pull docker.xuanyuan.run/devops-ansible/apache

基本运行示例

简单启动（默认配置）

bash
docker run -d -p 80:80 --name apache-server docker.xuanyuan.run/devops-ansible/apache

• -d：后台运行容器
• -p 80:80：将容器内80端口映射到主机80端口
• --name apache-server：指定容器名称为apache-server

启动后，访问http://localhost即可看到Apache默认欢迎页面。

挂载自定义网站目录

将本地网站文件目录挂载到容器内Apache的默认网站根目录（通常为/usr/local/apache2/htdocs）：

bash
docker run -d -p 80:80 \
  --name apache-server \
  -v /path/to/your/website:/usr/local/apache2/htdocs \
  docker.xuanyuan.run/devops-ansible/apache

• -v /path/to/your/website:/usr/local/apache2/htdocs：将主机/path/to/your/website目录挂载到容器内网站根目录

自定义配置文件

挂载自定义Apache配置文件（如httpd.conf）：

bash
docker run -d -p 80:80 \
  --name apache-server \
  -v /path/to/your/httpd.conf:/usr/local/apache2/conf/httpd.conf \
  -v /path/to/your/website:/usr/local/apache2/htdocs \
  docker.xuanyuan.run/devops-ansible/apache

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  apache:
    image: docker.xuanyuan.run/devops-ansible/apache
    ports:
      - "80:80"
    volumes:
      - ./website:/usr/local/apache2/htdocs  # 挂载网站目录
      - ./conf/httpd.conf:/usr/local/apache2/conf/httpd.conf  # 挂载配置文件
      - ./logs:/usr/local/apache2/logs  # 挂载日志目录
    restart: always  # 容器退出时自动重启

启动服务：

bash
docker-compose up -d

配置说明

端口映射

默认暴露80端口（HTTP），如需启用HTTPS，需在配置中开启443端口并映射：

bash
docker run -d -p 80:80 -p 443:443 ...

日志查看

通过容器日志命令查看Apache运行日志：

bash
docker logs apache-server

或挂载日志目录后直接查看主机日志文件：

bash
tail -f /path/to/mounted/logs/access.log

注意事项

• 自定义配置文件需确保语法正确，否则容器可能启动失败
• 生产环境建议启用SSL/TLS加密，并定期更新镜像以修复安全漏洞
• 高并发场景可能需要结合负载均衡或优化Apache配置参数（如最大连接数）

更多详细配置请参考镜像源代码仓库文档：https://github.com/devops-ansible/apache