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 所在目录执行以下命令构建镜像：

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

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

5. 使用方法与配置说明

5.1 基本运行（`docker run`）

5.1.1 指定端口映射

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

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

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

5.1.2 随机端口映射

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

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

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

bash
docker ps

5.2 高级配置

5.2.1 挂载网站目录

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

bash
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）：

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

5.3 Docker Compose 部署示例

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

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

启动服务：