davask/d-apache-letsencrypt

davask/d-apache-letsencrypt镜像说明

镜像概述

本镜像基于Apache 2.4和Let's Encrypt Certbot工具构建，旨在简化HTTPS服务的部署流程。它支持自动SSL证书获取与更新，提供灵活的环境变量配置和卷挂载选项，适用于需要快速搭建安全Web服务的场景。

核心功能

• 集成Apache 2.4服务器，支持HTTP（80端口）和HTTPS（443端口）访问
• 内置Certbot工具，自动完成Let's Encrypt SSL证书的申请与续期
• 支持虚拟主机自动配置，识别特定命名格式（如0001-subdomain.domain.tld-80.conf.dwl）的配置文件
• 提供丰富的环境变量，可自定义服务器参数（文档根目录、管理员***、SSL证书信息等）
• 暴露关键卷用于持久化配置文件和证书数据

使用场景

• 快速部署需要HTTPS加密的Web应用
• 搭建多域名虚拟主机的Apache服务器
• 自动化管理SSL证书的更新与续期
• 开发/测试环境中快速构建HTTPS服务原型

配置说明

暴露端口

• 22（可选SSH访问，默认关闭）
• 80（HTTP服务）
• 443（HTTPS服务）

主要环境变量

• DWL_HTTP_DOCUMENTROOT: Apache文档根目录（默认/var/www）
• DWL_CERTBOT_EMAIL: Certbot注册***（用于证书续期通知）
• DWL_HTTP_SERVERADMIN: 服务器管理员***（默认admin@localhost）
• DWL_SSH_ACCESS: 是否开启SSH访问（默认false）
• DWL_SSLKEY_CN: SSL证书的Common Name（默认davask.com）

可用卷

• /etc/apache2/sites-available: 虚拟主机配置文件目录
• /etc/letsencrypt: Let's Encrypt证书存储目录
• /etc/apache2/ssl: 自定义SSL证书目录
• /home/host: 宿主用户目录

部署示例

Docker Run命令

bash
docker run -d \
  -p 80:80 \
  -p 443:443 \
  -e DWL_CERTBOT_EMAIL="your-email@example.com" \
  -e DWL_HTTP_DOCUMENTROOT="/var/www/html" \
  -v ./sites-available:/etc/apache2/sites-available \
  -v ./letsencrypt:/etc/letsencrypt \
  davask/d-apache-letsencrypt

虚拟主机配置示例

将命名格式为[0-9]{4}-subdomain.domain.tld-[0-80|443].conf.dwl的配置文件放入./sites-available目录，镜像启动时会自动启用该虚拟主机。

apache
<VirtualHost *:443>
  ServerAdmin ***
  DocumentRoot /var/www/example
  ServerName example.com
  ServerAlias [***]
  
  SSLEngine on
  SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
  SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
</VirtualHost>