aerzas/httpd Docker Image Overview

aerzas/httpd

aerzas

无需特定用户或root权限即可运行的HTTPD Docker容器镜像，支持静态文件服务和PHP-FPM后端代理等预设配置，可通过环境变量和挂载文件自定义服务器行为。

下载次数: 0状态：社区镜像维护者：aerzas仓库类型：镜像最近更新：10 个月前

轩辕镜像，不浪费每一次拉取。点击查看

中文简介版本下载

轩辕镜像，不浪费每一次拉取。点击查看

HTTPD 容器镜像

概述和主要用途

无需特定用户或root权限即可运行的HTTPD Docker容器镜像，提供灵活的配置选项和预设场景。该镜像内置两种预设配置：default（静态文件服务）和php（将请求代理至PHP-FPM后端），适用于多种Web服务场景。

核心功能和特性

无特权运行：无需特定用户或root权限即可正常运行，提升部署安全性
预设配置：内置default（静态文件服务）和php（PHP-FPM代理）两种常用场景
环境变量驱动：通过环境变量灵活配置服务器参数、虚拟主机和日志等关键设置
动态配置替换：挂载的.tmpl格式文件会自动替换其中的环境变量，简化配置管理
可扩展配置：支持挂载额外配置文件和自定义预设，满足复杂场景需求

支持的标签

2.4-latest
2.4-2.6.0

使用场景和适用范围

静态网站部署（使用default预设）
PHP应用服务（配合PHP-FPM后端，使用php预设）
需要非root用户运行的Web服务环境
需通过环境变量动态调整配置的容器化部署场景

使用方法和配置说明

Docker Compose示例

yaml
version: '3.5'
services:
    php:
        image: aerzas/httpd:2.4-latest
        environment:
              HTTPD_VHOST_ALLOW_OVERRIDE: All  # 允许.htaccess文件覆盖配置
              HTTPD_VHOST_PRESET: php         # 使用PHP-FPM代理预设
              HTTPD_VHOST_ROOT: /var/www/html/web  # 虚拟主机根目录
        ports:
            - '80:8080'  # 映射容器端口8080到主机端口80
        healthcheck:
            test: ["CMD", "/scripts/docker-healthcheck.sh"]  # 健康检查命令
            interval: 30s  # 检查间隔
            timeout: 1s    # 超时时间
            retries: 3     # 重试次数
            start_period: 5s  # 启动等待时间

额外配置说明

额外配置文件：可将自定义配置文件挂载至/usr/local/apache2/conf/extra目录
自定义预设：自定义预设配置应挂载至/usr/local/apache2/conf/presets目录
环境变量替换：挂载为.tmpl格式的文件会自动替换其中的环境变量，实现动态配置

环境变量配置

以下是可用的环境变量及其默认值，按功能分类：

变量	默认值
服务器（Server）
`HTTPD_HOSTNAME_LOOKUPS`	`Off`
`HTTPD_KEEPALIVE`	`On`
`HTTPD_KEEPALIVE_REQUESTS`	`100`
`HTTPD_KEEPALIVE_TIMEOUT`	`75`
`HTTPD_REQUEST_WORKERS`	`100`
`HTTPD_SERVER_ADMIN`	`root@localhost`
`HTTPD_SERVER_NAME`	`localhost`
`HTTPD_SERVER_SIGNATURE`	`Off`
`HTTPD_SERVER_TOKENS`	`Prod`
`HTTPD_TIMEOUT`	`10`
`HTTPD_TIMEOUT_REQUEST`	`handshake=5 header=10 body=10`
`HTTPD_TRACE_ENABLE`	`Off`
`HTTPD_USE_CANONICAL_NAME`	`Off`
日志（Log）
`HTTPD_LOG_CUSTOM`	`/proc/self/fd/1 common env=!nolog`
`HTTPD_LOG_ERROR`	`/proc/self/fd/2`
`HTTPD_LOG_FORMAT`	`'%h %l %u %t \"%r\" %>s %b'`
`HTTPD_LOG_LEVEL`	`warn`
多处理模块（Multi-processing modules）
`HTTPD_MPM_MAX_CLIENTS`	`400`
`HTTPD_MPM_THREAD_LIMIT`	`64`
`HTTPD_MPM_THREADS_PER_CHILD`	`25`
`HTTPD_MPM_SERVER_LIMIT`	`16`
`HTTPD_MPM_START_SERVERS`	`3`
静态文件（Static）
`HTTPD_DOCUMENT_CACHE_CONTROL`	`"public"`
`HTTPD_DOCUMENT_EXPIRES_ACTIVE`	`On`
`HTTPD_DOCUMENT_EXPIRES_DEFAULT`	`"access plus 1 days"`
`HTTPD_DOCUMENT_PRAGMA`	`"cache"`
`HTTPD_STATIC_CACHE_CONTROL`	`"public"`
`HTTPD_STATIC_EXPIRES_ACTIVE`	`On`
`HTTPD_STATIC_EXPIRES_DEFAULT`	`"access plus 7 days"`
`HTTPD_STATIC_PRAGMA`	`"cache"`
虚拟主机（Vhost）
`HTTPD_VHOST_ALLOW_OVERRIDE`	`None`
`HTTPD_VHOST_HTTP2`	`true`
`HTTPD_VHOST_INDEX_FILE`	（空）
`HTTPD_VHOST_OPTIONS`	`FollowSymLinks`
`HTTPD_VHOST_PRESET`	`default`
`HTTPD_VHOST_ROOT`	`/var/www/html`
“php”预设（Preset "php"）
`HTTPD_BACKEND_HOST`	`php`
`HTTPD_BACKEND_PORT`	`9000`
`HTTPD_FCGI_PROXY_CONNECT_TIMEOUT`	`1`
`HTTPD_FCGI_PROXY_TIMEOUT`	`10`