smashwilson/lets-nginx

Let's Nginx

https://hub.docker.com/r/smashwilson/lets-nginx/

只需一条命令，即可为任意Docker化HTTP服务添加浏览器信任的TLS终止功能。

bash
docker run --detach \
  --name lets-nginx \
  --link backend:backend \
  --env EMAIL=我的邮箱@example.com \
  --env DOMAIN=我的域名.com \
  --env UPSTREAM=backend:8080 \
  --publish 80:80 \
  --publish 443:443 \
  smashwilson/lets-nginx

该镜像从Let's Encrypt获取证书，安装到nginx中，并通过定时任务每月自动续期证书。

⚠️ 为实现无人值守运行，此容器会代表您接受Let's Encrypt的服务条款。使用前请确保您认可其订阅协议。⚠️

前提条件

开始前，您需要：

1. 一个具有公网IP的Docker容器运行环境。
2. 已配置A记录指向您集群的域名。

核心功能

• 自动从Let's Encrypt获取浏览器信任的TLS证书
• 配置Nginx实现HTTPS反向代理
• 定时任务自动续期证书（每月）
• 支持多域名、多后端服务分发
• 提供证书和DH参数缓存机制
• 允许自定义Nginx配置

使用场景

• 个人或小型项目快速为Docker服务添加HTTPS
• 测试环境验证HTTPS部署流程
• 多服务共享同一HTTPS入口

配置说明

基础参数

• --link backend:backend：链接后端容器（根据Docker网络配置可能非必需）
• -e EMAIL：注册Let's Encrypt的***
• -e DOMAIN：服务域名（多域名用;分隔）
• -e UPSTREAM：后端服务地址（多后端用;与域名对应）
• -p 80:80/-p443:443：暴露HTTP/HTTPS端口
• -e STAGING=1：使用Let's Encrypt测试服务器（避免生产配额耗尽）

缓存配置

创建卷缓存证书和DH参数：

bash
docker volume create letsencrypt
docker volume create letsencrypt-backups
docker volume create dhparam-cache

启动时挂载卷：

bash
docker run --detach \
  --name lets-nginx \
  --link backend:backend \
  --env EMAIL=我的邮箱@example.com \
  --env DOMAIN=我的域名.com \
  --env UPSTREAM=backend:8080 \
  --publish 80:80 \
  --publish 443:443 \
  --volume letsencrypt:/etc/letsencrypt \
  --volume letsencrypt-backups:/var/lib/letsencrypt \
  --volume dhparam-cache:/cache \
  smashwilson/lets-nginx

自定义Nginx配置

基于原镜像修改配置：

docker
FROM smashwilson/lets-nginx
ADD nginx.conf /templates/nginx.conf

（nginx.conf需基于原模板调整，支持变量替换）