aptalca/nginx-letsencrypt

镜像说明

该镜像已被弃用，请使用新镜像：https://hub.docker.com/r/linuxserver/letsencrypt/%EF%BC%88%E5%9F%BA%E4%BA%8EAlpine%EF%BC%8C%E6%9B%B4%E8%BD%BB%E9%87%8F%E3%80%81%E9%AB%98%E6%95%88%E4%B8%94%E6%9B%B4%E6%96%B0%E5%8F%8A%E6%97%B6%EF%BC%89%E3%80%82

Nginx-Letsencrypt镜像概述

本容器搭建了集成Let's Encrypt客户端和Fail2Ban的Nginx Web服务器，可自动完成免费SSL服务器证书的生成与续期流程。

核心功能

1. Nginx Web服务器基础服务
2. Let's Encrypt客户端自动生成、续期SSL证书
3. Fail2Ban防暴力***（默认拦截htpasswd认证失败尝试）

使用场景

• unRaid系统通过社区应用部署带SSL的Web服务
• Ubuntu、Synology DSM等平台快速搭建安全Web服务

配置说明

unRaid安装步骤

1. 从社区应用安装该镜像
2. 高级视图填写：应用文件夹路径、服务器端口、***、域名URL、子域名（逗号分隔无空格）
3. 注意事项：
   • 确保容器443端口可从外部访问（可映射到主机其他端口，需路由器转发外部443到对应端口）
   • 证书生成前需验证域名可达性（your.domain.url:443可访问且端口转发正确）
   • 需4096位DH参数：添加环境变量DHLEVEL=4096
   • 仅子域名证书：添加环境变量ONLY_SUBDOMAINS=true

其他平台安装（Ubuntu/Synology等）

执行Docker命令部署：

bash
docker run -d \
  --privileged \
  --name="Nginx-letsencrypt" \
  -p 80:80 \
  -p 443:443 \
  -e EMAIL="你的注册邮箱" \
  -e URL="你的主域名（如example.com）" \
  -e SUBDOMAINS="www,sub1,sub2"  \
  -e TZ="你的时区（如Asia/Shanghai）" \
  -v /本地配置目录:/config:rw \
  aptalca/nginx-letsencrypt

参数说明：

• EMAIL：SSL证书注册***
• URL：主域名（支持动态DNS如username.duckdns.org）
• SUBDOMAINS：子域名列表（逗号分隔）
• TZ：时区（参考PHP时区列表）
• DHLEVEL（可选）：DH参数位数（默认2048，可设4096）
• ONLY_SUBDOMAINS（可选）：仅生成子域名证书（设为true）

额外注意：

• Fail2Ban配置：修改/config/nginx/jail.local或添加过滤文件到/config/nginx/fail2ban-filters后重启容器
• 证书更新：修改域名会触发重新生成，频繁修改可能被Let's Encrypt限流
• 自动生成pfx文件：适用于Emby等应用

访问地址：https://子域名.主域名/

变更日志（部分）

• 2016-08-19：新增仅子域名证书功能、简化续期流程、自动生成pfx文件
• 2016-06-03：支持域名修改自动更新证书、切换至Certbot客户端
• 2016-01-15：添加Fail2Ban支持（需--privileged参数）
• 2015-12-29：初始发布 ===END===