dockerfiles-centos-httpd 镜像文档

1. 镜像概述与主要用途

1.1 概述

dockerfiles-centos-httpd 是一个基于 CentOS 操作系统构建的 Docker 镜像，集成了 Apache HTTP Server（httpd），旨在提供轻量、标准化的 Web 服务运行环境。

1.2 主要用途

用于快速部署 Apache httpd 服务，支持静态资源托管、HTTP 协议服务及基础 Web 应用部署，适用于开发、测试及小型生产环境。

2. 核心功能与特性

• 基于 CentOS 系统：继承 CentOS 的稳定性与兼容性，适配 Red Hat 系环境依赖。
• 集成 Apache httpd：预装 Apache HTTP Server，开箱即可启动 HTTP 服务。
• 容器化部署：通过 Docker 封装，简化环境配置，避免系统依赖冲突。
• 灵活可定制：支持通过挂载配置文件、目录等方式自定义服务配置。

3. 使用场景与适用范围

• 开发/测试环境：本地开发或 CI/CD 流程中快速搭建 Web 服务测试环境。
• 静态网站托管：部署 HTML、CSS、JavaScript 等静态资源，提供基础 Web 访问能力。
• 轻量级 Web 应用：作为小型动态应用（如配合 CGI、PHP 模块）的前端服务器（需额外配置模块）。

4. 构建镜像

4.1 构建前提

• 已安装 Docker 环境。
• 已获取镜像源码（Dockerfile 及相关文件）。

4.2 构建命令

在 Dockerfile 所在目录执行以下命令构建镜像：

docker build --rm -t <username>/httpd .

• --rm：构建完成后自动删除中间容器。
• -t <username>/httpd：指定镜像标签（<username> 为自定义用户名，如 myrepo/httpd）。

5. 使用方法与配置说明

5.1 基本运行（docker run）

5.1.1 指定端口映射

若主机 8080 端口可用，将容器内 8080 端口映射到主机 8080 端口：

docker run -d -p 8080:8080 <username>/httpd

• -d：后台运行容器。
• -p 8080:8080：主机端口:容器端口（容器内 httpd 默认监听 8080 端口）。

5.1.2 随机端口映射

若需随机分配主机端口（映射到容器 8080 端口）：

docker run -d -p 8080 <username>/httpd

执行后可通过 docker ps 查看实际映射的主机端口：

docker ps

5.2 高级配置

5.2.1 挂载网站目录

将本地网站文件目录挂载到容器内 httpd 根目录（默认 /var/www/html）：

docker run -d -p 8080:8080 -v /本地网站目录:/var/www/html <username>/httpd

• -v /本地网站目录:/var/www/html：将本地目录挂载到容器内 httpd 网站根目录，实现文件实时更新。

5.2.2 自定义 httpd 配置

通过挂载自定义配置文件覆盖容器内默认配置（httpd 主配置文件路径通常为 /etc/httpd/conf/httpd.conf）：

docker run -d -p 8080:8080 -v /本地/httpd.conf:/etc/httpd/conf/httpd.conf <username>/httpd

5.3 Docker Compose 部署示例

创建 docker-compose.yml 文件，配置如下：

version: '3'
services:
  httpd:
    image: <username>/httpd  # 替换为实际镜像标签
    ports:
      - "8080:8080"  # 主机端口:容器端口
    volumes:
      - /本地网站目录:/var/www/html  # 挂载网站目录
      # - /本地/httpd.conf:/etc/httpd/conf/httpd.conf  # 可选：挂载自定义配置文件
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动服务：

docker-compose up -d

6. 测试验证

服务启动后，通过以下命令测试访问（以主机端口 8080 为例）：

curl http://localhost:8080

若返回 Apache httpd 默认欢迎页面或自定义网站内容，说明服务运行正常。

7. 注意事项

• 端口冲突：若启动容器时提示端口被占用，需更换主机端口（如 -p 8081:8080）。
• 目录权限：挂载本地目录时，确保本地目录权限允许容器内进程（通常为 apache 用户）访问，避免文件读写失败。
• 配置生效：修改挂载的配置文件或网站目录后，无需重启容器（httpd 动态加载配置需额外配置，静态文件直接生效）。