ericsciberras/docker-letsencrypt-nginx-proxy-companion

镜像概述

本镜像为docker-letsencrypt-nginx-proxy-companion的armhf架构分支，是nginx-proxy的轻量级配套容器，用于自动化管理Let's Encrypt证书，实现代理Docker容器的HTTPS服务。

核心功能

• 基于simp_le自动创建、续期Let's Encrypt（或其他ACME CA）证书；
• 仅通过http-01挑战完成域名验证；
• 证书创建/续期时自动更新并重新加载nginx配置；
• 支持多域名（SAN）证书生成；
• 启动时生成强Diffie-Hellman组；
• 兼容所有Docker版本。

使用场景

• 需要为Docker容器提供HTTPS代理的场景；
• 基于armhf架构的设备（如树莓派）部署HTTPS服务；
• 多域名服务的证书自动化管理。

配置要求

1. 主机需公开可达80和443端口；
2. 防火墙不得阻止80端口（否则http-01挑战失败）；
3. 不可使用HTTPS_METHOD=nohttp配置；
4. 目标域名需正确解析到主机；
5. DNS提供商需正确响应CAA记录请求；
6. 若域名有AAAA记录，主机需通过IPv6公开可达80和443端口。

部署示例

步骤1：启动nginx-proxy容器

shell
docker run --detach \
    --name nginx-proxy \
    --publish 80:80 \
    --publish 443:443 \
    --volume /etc/nginx/certs \
    --volume /etc/nginx/vhost.d \
    --volume /usr/share/nginx/html \
    --volume /var/run/docker.sock:/tmp/docker.sock:ro \
    jwilder/nginx-proxy

步骤2：启动letsencrypt-nginx-proxy-companion容器

shell
docker run --detach \
    --name nginx-proxy-letsencrypt \
    --volumes-from nginx-proxy \
    --volume /var/run/docker.sock:/var/run/docker.sock:ro \
    --env "DEFAULT_EMAIL=mail@yourdomain.tld" \
    ericsciberras/docker-letsencrypt-nginx-proxy-companion

步骤3：启动代理容器

shell
docker run --detach \
    --name your-proxyed-app \
    --env "VIRTUAL_HOST=subdomain.yourdomain.tld" \
    --env "LETSENCRYPT_HOST=subdomain.yourdomain.tld" \
    nginx

多端口代理示例（如Grafana）

shell
docker run --detach \
    --name grafana \
    --env "VIRTUAL_HOST=othersubdomain.yourdomain.tld" \
    --env "VIRTUAL_PORT=3000" \
    --env "LETSENCRYPT_HOST=othersubdomain.yourdomain.tld" \
    --env "LETSENCRYPT_EMAIL=***" \
    grafana/grafana