trajano/nginx-letsencrypt

Nginx + Let's Encrypt Docker镜像

该容器提供集成Let's Encrypt证书服务的Nginx，通过SSLLabs测试可获得A+评级，支持流处理和常规代理功能。

镜像概述

本镜像将Nginx与Let's Encrypt证书服务结合，实现自动SSL证书生成与续期，确保Web服务的安全加密。同时支持流处理，可满足多种网络服务场景需求。

核心功能

1. 自动生成Let's Encrypt SSL证书，支持多域名配置
2. 通过SSLLabs测试可获得A+安全评级
3. 支持流处理与常规代理功能
4. 自动调整Nginx worker进程数至可用CPU数量
5. 提供gzip压缩功能，减少网络传输流量
6. 支持自定义虚拟服务器与流配置

使用场景

• 搭建安全的HTTPS网站或API服务
• 作为反向代理服务，转发请求至后端应用
• 提供流传输服务（如视频、音频流）
• 需要自动管理SSL证书的Web服务场景

配置说明

环境变量

• EMAIL: 接收证书续期通知的***地址
• DOMAINS: 逗号分隔的FQDN列表，第一个为主要域名，证书将存储在/etc/letsencrypt/live目录下

自定义配置

• /etc/nginx/conf.d: 存放部署特定配置（通过Docker configs管理，非卷挂载），优先级高于deployment.d
• /etc/nginx/deployment.d: 存放部署特定配置（可卷挂载）
• {conf|deployment}.d/{server_name}.conf.*: 虚拟服务器配置文件，默认返回502错误
• {conf|deployment}.d/*.conf.stream: 流处理配置文件，用于直接转发请求至上游服务器

示例配置（虚拟服务器与流）

nginx
upstream intranet {
    server intranet:443;
}

map $ssl_preread_server_name $upstream {
    default default_https;
    i.trajano.net intranet;
}

注意事项

• 首次初始化时无输出，因DHPARAM生成和证书初始化需要时间
• 不建议多副本运行，尤其是证书续期时
• /.well-known/acme-challenge路径指向/tmp/.well-known/acme-challenge，用于证书续期验证

部署示例

Docker Run命令

bash
docker run -d \
  --name nginx-letsencrypt \
  -e EMAIL=your-email@example.com \
  -e DOMAINS=example.com,www.example.com \
  -p 80:80 \
  -p 443:443 \
  -v ./deployment.d:/etc/nginx/deployment.d \
  trajano/nginx-letsencrypt

Docker Compose示例

yaml
version: '3'
services:
  nginx:
    image: trajano/nginx-letsencrypt
    environment:
      - EMAIL=***
      - DOMAINS=example.com,[***]
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./deployment.d:/etc/nginx/deployment.d
    restart: always