riid/docker-letsencrypt-nginx-proxy-companion-multi

镜像概述

letsencrypt-nginx-proxy-companion-multi是https://github.com/jwilder/nginx-proxy%E7%9A%84%E8%BD%BB%E9%87%8F%E9%85%8D%E5%A5%97%E5%AE%B9%E5%99%A8%EF%BC%8C%E5%8F%AF%E8%87%AA%E5%8A%A8%E5%88%9B%E5%BB%BA%E3%80%81%E7%BB%AD%E6%9C%9FLet's Encrypt证书，支持多域名（SAN）证书及强Diffie-Hellman组生成，帮助用户快速为代理服务配置HTTPS。

核心功能

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

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

使用场景

适用于需要为多个域名自动配置HTTPS的Web服务部署场景，尤其是基于nginx-proxy的反向代理架构，可简化证书管理流程。

配置说明

基础使用

需从nginx-proxy容器声明3个可写卷：

• /etc/nginx/certs：用于创建/续期证书；
• /etc/nginx/vhost.d：修改虚拟主机配置；
• /usr/share/nginx/html：写入挑战文件。

步骤示例：

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 \
    --label com.github.jrcs.letsencrypt_nginx_proxy_companion.nginx_proxy \
    docker.xuanyuan.run/jwilder/nginx-proxy

（标签com.github.jrcs.letsencrypt_nginx_proxy_companion.nginx_proxy用于让letsencrypt容器识别nginx-proxy）

2. 启动letsencrypt容器：

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

3. 启动需代理的应用容器（需暴露端口）：

bash
docker run -d -e "VIRTUAL_HOST=foo.bar.com" ...

分离容器部署（推荐）

将nginx-proxy拆分为docker-gen和nginx两个容器，提升安全性（避免将Docker socket挂载到公开暴露的容器）。

步骤示例：

1. 下载nginx.tmpl模板：

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

2. 启动nginx容器：

bash
docker run -d -p 80:80 -p 443:443 \
    --name docker.xuanyuan.run/nginx \
    -v /etc/nginx/conf.d \
    -v /etc/nginx/vhost.d \
    -v /usr/share/nginx/html \
    -v /path/to/certs:/etc/nginx/certs:ro \
    --label com.github.jrcs.letsencrypt_nginx_proxy_companion.nginx_proxy \
    docker.xuanyuan.run/nginx

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 \
    --label com.github.jrcs.letsencrypt_nginx_proxy_companion.docker_gen \
    docker.xuanyuan.run/jwilder/docker-gen \
    -notify-sighup nginx -watch -wait 5s:30s /etc/docker-gen/templates/nginx.tmpl /etc/nginx/conf.d/default.conf

4. 启动letsencrypt容器：

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

Let's Encrypt配置

为需代理的应用容器设置以下环境变量启用证书自动生成：

• LETSENCRYPT_HOST：需与VIRTUAL_HOST一致（多域名用逗号分隔）；
• LETSENCRYPT_EMAIL：用于接收证书相关通知。

可选变量：

• LETSENCRYPT_KEYSIZE：证书密钥大小（默认4096位）；
• LETSENCRYPT_TEST：设为true使用测试证书（无每周域名证书数量限制）。

多域名证书示例：

bash
docker run -d \
    --name example-app \
    -e "VIRTUAL_HOST=example.com,www.example.com,mail.example.com" \
    -e "LETSENCRYPT_HOST=example.com,www.example.com,mail.example.com" \
    -e "LETSENCRYPT_EMAIL=foo@bar.com" \
    docker.xuanyuan.run/tutum/apache-php

强制续期证书：

bash
docker exec nginx-letsencrypt /app/force_renew

可选环境变量

• ACME_CA_URI：ACME API端点（默认生产环境，测试环境为https://acme-staging.api.letsencrypt.org/directory）；
• DEBUG：设为true启用调试模式；
• REUSE_ACCOUNT_KEYS：设为false禁用ACME账户密钥复用；
• REUSE_KEY：设为true复用证书私钥（适合HPKP）。 ===FULL_DESC===