umputun/nginx-le

NGINX-LE - 带有自动Let's Encrypt的Nginx Web服务器和代理

基于Alpine的轻量级Nginx镜像，集成Let's Encrypt证书自动管理功能，可作为Web服务器或反向代理使用，简化HTTPS配置流程。

核心功能和特性

• 自动证书管理：集成Let's Encrypt支持，自动完成证书申请、安装和续期
• Alpine基础：基于Alpine Linux，镜像体积小，资源占用低
• HTTP到HTTPS重定向：默认配置自动将HTTP请求重定向至HTTPS
• 多域名支持：可通过逗号分隔的方式配置多个域名
• 自定义证书支持：支持手动指定SSL证书（当关闭Let's Encrypt时）
• 高安全性：SSL配置达到SSL Labs A+评级

!https://github.com/umputun/nginx-le/blob/master/rating.png

使用场景

• 需要快速部署HTTPS网站的个人或小型项目
• 作为反向代理，为后端服务提供HTTPS支持
• 需要自动管理SSL证书的Web应用
• 多域名服务的统一入口

使用方法

基本配置步骤

1. 获取https://github.com/umputun/nginx-le/blob/master/docker-compose.yml%E5%B9%B6%E4%BF%AE%E6%94%B9%E4%BB%A5%E4%B8%8B%E9%85%8D%E7%BD%AE%EF%BC%9A

   • 设置时区（如TZ=UTC，更多时区值可查看/usr/share/zoneinfo目录）
   • 启用Let's Encrypt：设置LETSENCRYPT=true（自动证书管理）
   • 配置***：LE_EMAIL填写您的***地址
   • 配置域名：LE_FQDN填写域名，多域名用逗号分隔（如LE_FQDN=aaa.example.com,bbb.example.com）
   • 若禁用Let's Encrypt（LETSENCRYPT=false），需手动指定证书路径：SSL_CERT（证书）、SSL_KEY（密钥）、SSL_CHAIN_CERT（链证书）

2. 自定义服务配置： 使用提供的etc/service-example.conf作为模板创建etc/service.conf，保留以下SSL指令：

   nginx
   ssl_certificate SSL_CERT;
   ssl_certificate_key SSL_KEY;
   ssl_trusted_certificate SSL_CHAIN_CERT;
   

3. 调整卷挂载：确保docker-compose.yml中的volumes配置指向您的自定义服务配置文件

4. 支持多配置文件：可在compose中挂载多个自定义配置文件（如service2.conf，参考https://github.com/umputun/nginx-le/blob/master/docker-compose.yml%E7%A4%BA%E4%BE%8B%EF%BC%89

启动与管理

• 拉取镜像：docker-compose pull
• 构建自定义镜像（如需）：docker-compose build
• 启动服务：docker-compose up -d

实现细节

• HTTP到HTTPS重定向：提供的https://github.com/umputun/nginx-le/blob/master/conf/nginx.conf%E5%B7%B2%E9%BB%98%E8%AE%A4%E5%A4%84%E7%90%86HTTP%E5%88%B0HTTPS%E7%9A%84%E9%87%8D%E5%AE%9A%E5%90%91%EF%BC%8C%E6%97%A0%E9%9C%80%E5%9C%A8%E8%87%AA%E5%AE%9A%E4%B9%89%60service.conf%60%E4%B8%AD%E9%87%8D%E5%A4%8D%E9%85%8D%E7%BD%AE%E3%80%82%E8%8B%A5%E9%9C%80%E5%9C%A880%E7%AB%AF%E5%8F%A3%E9%85%8D%E7%BD%AE%E8%87%AA%E5%AE%9A%E4%B9%89HTTP%E6%9C%8D%E5%8A%A1%EF%BC%8C%E9%9C%80%E7%A1%AE%E4%BF%9D%E6%AD%A3%E7%A1%AE%E5%A4%84%E7%90%86%60/.well-known/%60%E8%B7%AF%E5%BE%84%EF%BC%88Let's Encrypt验证所需）

• 证书续期机制：script/entrypoint.sh脚本负责申请证书，并每10天检查一次证书状态，当证书剩余有效期不足30天时自动续期

• 依赖组件：使用Alpine的certbot包处理Let's Encrypt证书

• 镜像地址：https://hub.docker.com/r/umputun/nginx-le/

替代方案

• Træfik：HTTP反向代理和负载均衡器，原生支持Let's Encrypt
• Caddy：原生支持Let's Encrypt的Web服务器
• https://github.com/artyom/leproxy%EF%BC%9A%E8%BD%BB%E9%87%8F%E7%BA%A7%E7%8B%AC%E7%AB%8BHTTPS%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%EF%BC%8C%E6%94%AF%E6%8C%81%E8%87%AA%E5%8A%A8Let's Encrypt
• https://github.com/search?utf8=%E2%9C%93&q=nginx+lets+encrypt

示例

• https://github.com/umputun/nginx-le/tree/master/example/webrtc%EF%BC%9A%E9%80%82%E7%94%A8%E4%BA%8E%E9%9C%80%E8%A6%81%E5%9C%A8%E5%8D%95%E4%B8%AA%E5%9F%9F%E5%90%8D%E4%B8%8B%E9%80%9A%E8%BF%87%E5%A4%9A%E4%B8%AA%E7%AB%AF%E5%8F%A3%E8%AE%BF%E9%97%AE%E4%B8%8D%E5%90%8C%E5%90%8E%E7%AB%AF%E6%9C%8D%E5%8A%A1%E7%9A%84WebRTC%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88