inventis/httpd

Apache容器

镜像概述与主要用途

本镜像为仅支持HTTPS的Apache容器，主要用于部署Web应用，提供安全的HTTPS访问能力。支持通过环境变量指定域名自动生成证书，或挂载自定义SSL证书，可与PHP-FPM容器集成以处理PHP应用。

核心功能与特性

• 仅支持HTTPS协议，确保Web应用安全访问
• 通过CERT_DOMAIN环境变量指定域名，自动生成SSL证书
• 支持挂载自定义证书（包括通配符证书），可在宿主机存储并重复使用
• 可与PHP容器链接，通过PHP-FPM处理PHP应用请求
• 支持配置文档根目录和PHP-FPM socket地址

使用场景与适用范围

适用于需要HTTPS支持的Web应用部署场景，尤其适合与PHP应用配合使用。可用于本地开发环境（推荐使用mkcert生成有效本地SSL证书）和生产环境（使用自定义证书确保安全性）。

使用方法与配置说明

环境变量配置

卷挂载说明

• 应用代码目录：将本地项目目录挂载到容器内/var/www/app，建议使用cached模式提升性能

  - './:/var/www/app:cached'
  

• 自定义证书（可选）：挂载本地证书文件到容器指定路径

  - ~/.ssl/example.crt:/usr/local/apache2/conf/server.crt  # SSL证书
  - ~/.ssl/example.key:/usr/local/apache2/conf/server.key  # 证书私钥
  

端口映射

• 80端口：HTTP端口，可修改宿主机端口（格式：宿主机端口:80）
• 443端口：HTTPS端口，可修改宿主机端口（格式：宿主机端口:443）

Docker Compose配置示例

以下是与inventis/php容器链接的完整配置示例：

yml
    ...
    httpd:
        image: inventis/httpd:2.4
        links:
            - php  # 链接到PHP容器
        volumes:
            - './:/var/www/app:cached'  # 挂载项目代码
            # 取消下方注释并调整路径以使用自定义证书
            # - ~/.ssl/example.crt:/usr/local/apache2/conf/server.crt
            # - ~/.ssl/example.key:/usr/local/apache2/conf/server.key
        ports:
            - "80:80"  # 可修改冒号前的宿主机HTTP端口
            - "443:443" # 可修改冒号前的宿主机HTTPS端口
        environment:
            DOCUMENT_ROOT: /var/www/app/<你的项目公共目录>  # 替换为实际公共目录
            PHP_FPM_SOCKET: php:9000  # PHP容器的地址和端口
            CERT_DOMAIN: my.domain.be  # 生成证书的域名（使用自定义证书时删除此行）
    ...

证书生成工具

推荐使用https://github.com/FiloSottile/mkcert%E5%B7%A5%E5%85%B7%E5%88%9B%E5%BB%BA%E6%9C%AC%E5%9C%B0%E5%8F%AF%E4%BF%A1SSL%E8%AF%81%E4%B9%A6%EF%BC%8C%E6%94%AF%E6%8C%81%E7%94%9F%E6%88%90%E9%80%9A%E9%85%8D%E7%AC%A6%E8%AF%81%E4%B9%A6%EF%BC%8C%E7%94%9F%E6%88%90%E5%90%8E%E5%8F%AF%E5%AD%98%E5%82%A8%E5%9C%A8%E5%AE%BF%E4%B8%BB%E6%9C%BA%E5%B9%B6%E9%87%8D%E5%A4%8D%E7%94%A8%E4%BA%8E%E5%A4%9A%E4%B8%AA%E5%AE%B9%E5%99%A8%EF%BC%8C%E6%8F%90%E5%8D%87%E9%83%A8%E7%BD%B2%E6%95%88%E7%8E%87%E3%80%82