mickaelperrin/docker-letsencrypt-nginx-proxy-companion

镜像概述

letsencrypt-nginx-proxy-companion是nginx-proxy容器的轻量辅助工具，用于自动管理Let's Encrypt SSL证书的创建与续期，简化HTTPS环境的配置流程。

核心功能

• 自动创建/续期Let's Encrypt证书，与nginx-proxy协同工作
• 支持多域名（SAN）证书生成
• 自动生成强Diffie-Hellman组，助力SSL服务器测试获得A+评级
• 兼容所有Docker版本

注意：首次启动容器时会生成新的Diffie-Hellman组文件，此过程可能需要数分钟，请耐心等待。

使用场景

适用于基于nginx-proxy的反向代理环境，需要为多个网站自动配置HTTPS证书的场景。

配置说明

关键环境变量

• LETSENCRYPT_HOST：需与VIRTUAL_HOST一致，指定证书域名（多域名用逗号分隔）
• LETSENCRYPT_EMAIL：Let's Encrypt注册***
• LETSENCRYPT_TEST：设为true可生成测试证书（无每周域名证书数量限制）
• ACME_CA_URI：自定义CA API端点（测试环境可用https://acme-staging.api.letsencrypt.org/directory）
• DEBUG：设为true开启调试模式
• NGINX_PROXY_CONTAINER：指定nginx-proxy容器名称/ID（无法使用--volumes-from时）

部署示例

普通方式

1. 启动nginx-proxy容器：

bash
docker run -d -p 80:80 -p 443:443 \
    --name nginx-proxy \
    -v /path/to/certs:/etc/nginx/certs:ro \
    -v /etc/nginx/vhost.d \
    -v /usr/share/nginx/html \
    -v /var/run/docker.sock:/tmp/docker.sock:ro \
    jwilder/nginx-proxy

2. 启动辅助容器：

bash
docker run -d \
    -v /path/to/certs:/etc/nginx/certs:rw \
    --volumes-from nginx-proxy \
    -v /var/run/docker.sock:/var/run/docker.sock:ro \
    mickaelperrin/docker-letsencrypt-nginx-proxy-companion

3. 启动应用容器：

bash
docker run -d \
    -e "VIRTUAL_HOST=foo.bar.com" \
    -e "LETSENCRYPT_HOST=foo.bar.com" \
    -e "LETSENCRYPT_EMAIL=your-email@example.com" \
    your-app-image

分离容器方式（推荐）

1. 启动官方nginx容器：

bash
docker run -d -p 80:80 -p 443:443 \
    --name nginx \
    -v /etc/nginx/conf.d \
    -v /etc/nginx/vhost.d \
    -v /usr/share/nginx/html \
    -v /path/to/certs:/etc/nginx/certs:ro \
    nginx

2. 下载nginx.tmpl模板：

bash
curl https://raw.githubusercontent.com/jwilder/nginx-proxy/master/nginx.tmpl > /path/to/nginx.tmpl

3. 启动docker-gen容器：

bash
docker run -d \
    --name nginx-gen \
    --volumes-from nginx \
    -v /path/to/nginx.tmpl:/etc/docker-gen/templates/nginx.tmpl:ro \
    -v /var/run/docker.sock:/tmp/docker.sock:ro \
    jwilder/docker-gen \
    -notify-sighup nginx -watch -only-exposed -wait 5s:30s /etc/docker-gen/templates/nginx.tmpl /etc/nginx/conf.d/default.conf

4. 启动辅助容器：

bash
docker run -d \
    --name nginx-letsencrypt \
    -e "NGINX_DOCKER_GEN_CONTAINER=nginx-gen" \
    --volumes-from nginx \
    -v /path/to/certs:/etc/nginx/certs:rw \
    -v /var/run/docker.sock:/var/run/docker.sock:ro \
    mickaelperrin/docker-letsencrypt-nginx-proxy-companion

5. 启动应用容器同上。