oberonamsterdam/apache24-fpm

Oberon Apache2.4-FPM Docker镜像

镜像概述和主要用途

本镜像基于httpd:2.4-alpine（latest标签）构建，是Oberon的默认Apache配置，集成PHP-FPM支持。使用时需搭配PHP-FPM Docker镜像（可使用PHP官方镜像或其他自定义构建的PHP-FPM镜像）。若仅需提供纯静态HTML内容，建议使用原生HTTPD容器或轻量级服务器（如nginx/lighttpd）。

核心功能和特性

启用模块

• mod_alias
• mod_rewrite
• mod_proxy_wstunnel
• mod_proxy_fcgi
• mod_proxy

额外配置

• mod_expires：对图片、CSS、JavaScript等资产设置1个月过期时间，支持svg和字体的额外MIME类型
• mod_deflate：对文本资产（html、css、js、svg、xml、plain）启用压缩，采用生产环境签名设置

使用场景和适用范围

• 适用于需要PHP-FPM支持的Web应用部署
• 不推荐用于纯静态内容服务（建议使用原生HTTPD或轻量级服务器）

使用方法和配置说明

添加自定义配置

通过将配置文件挂载到容器的/usr/local/apache2/conf/other/目录添加自定义配置：

yaml
web:
    volumes:
        - myconfiguration.conf:/usr/local/apache2/conf/other/myconfiguration.conf

注意：本镜像默认禁用HTTPS，如需启用需自行配置（因官方使用Nginx反向代理）。

环境变量

Docker部署示例

基本docker-compose配置

yaml
version: '3'
services:
    web:
        image: oberonamsterdam/apache24-fpm:latest
        restart: always
        network_mode: "bridge"
        environment:
            - "VIRTUAL_HOST=my.domain.ext"
            - "APACHE_DOCUMENTROOT=/app/web"
        links:
            - php
        depends_on:
            - php
        volumes:
            - .:/app/:delegated
    php:
        image: oberonamsterdam/php:7.1-fpm
        restart: always
        network_mode: "bridge"
        volumes:
            - .:/app/:delegated

切换PHP版本

通过使用不同的PHP-FPM镜像（需暴露9000端口）切换PHP版本。

自定义PHP-FPM主机名和端口

yaml
version: '3'
services:
    web:
        image: oberonamsterdam/apache24-fpm:latest
        restart: always
        network_mode: "bridge"
        environment:
            - "VIRTUAL_HOST=my.domain.ext"
            - "APACHE_DOCUMENTROOT=/app/web"
            - "PHP_FPM_HOSTNAME=my_php_container"  # 自定义PHP-FPM主机名
            - "PHP_FPM_PORT=9001"  # 自定义PHP-FPM端口
        links:
            - my_php_container
        depends_on:
            - my_php_container
        volumes:
            - .:/app/:delegated
    my_php_container:
        image: php:8.0-fpm  # 示例PHP 8.0镜像
        restart: always
        network_mode: "bridge"
        volumes:
            - .:/app/:delegated

OPENID CONNECT支持

镜像说明

openidc标签镜像基于httpd:2.4构建（因mod_auth_openidc模块在Alpine系统不可用），用于添加初始认证（替代htpasswd）。完整配置手册参见：https://github.com/zmartzone/mod_auth_openidc

配置示例（Google认证）

以下示例配置仅允许指定域名（如公司域名）用户访问：

apache
LoadModule auth_openidc_module /usr/lib/apache2/modules/mod_auth_openidc.so

OIDCProviderMetadataURL https://accounts.google.com/.well-known/openid-configuration
OIDCClientID <<GOOGLE-CLIENT-ID>>
OIDCClientSecret <<GOOGLE-CLIENT-SECRET>>

OIDCAuthRequestParams hd=<<YOUR-DOMAIN>>
OIDCRedirectURI https://${VIRTUAL_HOST}/redirect
OIDCCryptoPassphrase <<YOUR-RANDOM-PASSPHRASE>>
OIDCRemoteUserClaim email
OIDCScope "openid email"
OIDCAuthNHeader X-Forwarded-User

<Location />
    AuthType openid-connect
    Require claim hd:<<YOUR-DOMAIN>>
    Require valid-user
</Location>

部署配置

将上述配置文件挂载到容器：

yaml
version: '3'
services:
    web:
        image: oberonamsterdam/apache24-fpm:openidc
        volumes:
            - .:/app/:delegated
            - openidc.conf:/usr/local/apache/config/other/openidc.conf