magnaz/nginx-acme

magnaz/nginx-acme镜像说明

镜像概述

这是一个体积小巧、易于使用的Docker容器，包含Nginx web服务器和Let's Encrypt客户端ACME.sh。证书初始签发后，容器内的cron服务会自动更新证书，无需手动干预。

核心功能

• 集成Nginx与ACME.sh，实现SSL证书的自动签发与更新
• 提供Alpine（轻量）和Debian两种基础镜像版本
• 支持多个Nginx版本（1.10/1.11/1.12/1.13）
• 容器内通过cron实现证书周期性自动更新

使用场景

• 个人或企业网站的HTTPS加密服务部署
• 快速搭建带有自动SSL证书管理的Nginx服务器
• 需要简化证书生命周期管理的Web服务场景

配置说明

支持版本

• 1.12-alpine/latest：基于Alpine Linux的Nginx 1.12版本（体积最小）
• 1.12-debian：基于Debian的Nginx 1.12版本
• 1.13-alpine：基于Alpine Linux的Nginx 1.13版本
• 1.13-debian：基于Debian的Nginx 1.13版本
• 旧版本：1.10-alpine/1.10-debian/1.11-alpine/1.11-debian

部署步骤

1. 创建卷目录

   sh
   mkdir -p /var/docker/nginx/ssl /var/docker/nginx/conf.d
   

2. 生成DH参数文件

   sh
   openssl dhparam -out /var/docker/nginx/ssl/dhparam.pem 2048
   

3. 配置Nginx
   在/var/docker/nginx目录下创建配置文件，参考https://github.com/magna-z/docker-nginx-acme/tree/master/example-configs%E6%88%96https://mozilla.github.io/server-side-tls/ssl-config-generator/%E3%80%82

4. 创建网络

   sh
   sudo docker network create nginx
   

5. 启动容器

   sh
   sudo docker run \
   --name nginx \
   --hostname nginx \
   --network nginx \
   -p 80:80 \
   -p 443:443 \
   -e ACCOUNT_CONF_PATH=/etc/nginx/ssl/acme.sh.conf \
   -v /etc/timezone:/etc/timezone:ro -v /etc/localtime:/etc/localtime:ro \
   -v /var/docker/nginx/nginx.conf:/etc/nginx/nginx.conf:ro \
   -v /var/docker/nginx/conf.d:/etc/nginx/conf.d:ro \
   -v /var/docker/nginx/ssl:/etc/nginx/ssl:rw \
   -v /var/docker/nginx/logs:/var/log/nginx:rw \
   -v /var/docker/nginx/www:/var/www:rw \
   -d --restart always \
   magnaz/nginx-acme:1.12-alpine
   

6. 初始化证书

   sh
   sudo docker exec nginx \
   acme.sh --issue \
   -w /var/www/example.com \
   -d example.com -d [***]