satishweb/docker-flow-proxy-cert-manager-letsencrypt-aws-route53

Docker Flow Proxy的Let's Encrypt证书管理器镜像

概述

该镜像为Docker Flow Proxy提供证书管理功能，集成Let's Encrypt和AWS Route53 DNS服务，实现SSL/TLS证书的自动申请与续期，适配多种架构，且基于Alpine Linux构建，镜像体积小巧。

核心功能

• 与Docker Flow Proxy、Let's Encrypt及AWS Route53 DNS深度集成
• 证书临近过期时自动续期（可自定义检查间隔）
• 支持通过/app-config目录执行自定义脚本
• 适配linux/amd64、linux/arm64、linux/arm/v7、linux/arm/v6架构
• 基于Alpine Linux，镜像体积轻量

使用场景

适用于需要为Docker Flow Proxy管理SSL/TLS证书的场景，尤其是依赖AWS Route53 DNS验证的环境，可自动处理证书的申请、续期流程，简化HTTPS配置。

配置说明

变量列表

• DOMAIN_*：逗号分隔的子域名列表（所有域名需属于同一父域；使用通配符时仅支持单个域名）
• CERTBOT_EMAIL：用于Let's Encrypt注册的***地址
• PROXY_ADDRESS：Docker Flow Proxy地址（支持主机名、FQDN或API URL格式）
• PROXY_SEND_MAX_RETRIES：向代理发送证书的最大重试次数
• PROXY_SEND_RETRY_INTERVAL：发送证书重试的间隔时间（秒）
• CERT_RENEW_INTERVAL：证书续期检查的间隔时间（秒）
• CERTBOTMODE：设置为"staging"时启用Let's Encrypt测试模式
• AWS_ACCESS_KEY_ID：AWS IAM访问密钥ID
• AWS_SECRET_ACCESS_KEY：AWS IAM秘密访问密钥
• AWS_REGION：AWS区域
• AWS_HOSTED_ZONE_ID：Route53服务中的域名DNS区域ID
• CERTMGR_DISABLE：设置为"yes"可禁用证书管理器但保持容器运行
• PROXY_PORT：自定义Docker Flow Proxy的API端口（若修改默认端口）

Docker Run命令示例

bash
docker run --rm -it --name cert-manager \
    -e DOMAIN_1="test.satishweb.com,test1.satishweb.com"\
    -e DOMAIN_2="test2.satishweb.com"\
    -e DOMAIN_3="*.satishweb.com"\
    -e CERTBOT_EMAIL="webmaster@satishweb.com" \
    -e PROXY_ADDRESS="proxy" \
    -e PROXY_SEND_MAX_RETRIES="10" \
    -e PROXY_SEND_RETRY_INTERVAL="30" \
    -e CERT_RENEW_INTERVAL="86400" \
    -e CERTBOTMODE="staging" \
    -e AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID} \
    -e AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY} \
    -e AWS_REGION=${AWS_REGION} \
    -e AWS_HOSTED_ZONE_ID=${AWS_HOSTED_ZONE_ID} \
    -v $(pwd)/data/letsencrypt:/etc/letsencrypt \
satishweb/docker-flow-proxy-cert-manager-letsencrypt-aws-route53:latest

Docker Stack配置示例

yaml
cert-manager:
  image: satishweb/docker-flow-proxy-cert-manager-letsencrypt-aws-route53
  hostname: cert-manager
  networks:
    - proxy
  environment:
    - DOMAIN_1="test.satishweb.com,test1.satishweb.com"
    - DOMAIN_2="test2.satishweb.com"
    - DOMAIN_3="*.satishweb.com"
    - CERTBOT_EMAIL=webmaster@satishweb.com
    - PROXY_ADDRESS=proxy
    - PROXY_SEND_MAX_RETRIES="10"
    - PROXY_SEND_RETRY_INTERVAL="30"
    - CERT_RENEW_INTERVAL="86400"
    - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
    - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
    - AWS_REGION=${AWS_REGION}
    - AWS_HOSTED_ZONE_ID=${AWS_HOSTED_ZONE_ID}
    - CERTBOTMODE="staging"
  volumes:
    - ./data/certs:/etc/letsencrypt
    # 挂载自定义脚本目录
    # - ./app-config:/app-config
  deploy:
    replicas: 1
    placement:
      constraints:
        - node.role==manager
  labels:
    - "com.satishweb.description=Certificate Manager"

构建镜像

bash
docker build . --no-cache -t satishweb/docker-flow-proxy-cert-manager-letsencrypt-aws-route53

测试脚本（无需重建镜像）

bash
docker run --rm -it --name cert-manager \
    -e DOMAIN_1="test.satishweb.com,test1.satishweb.com"\
    -e DOMAIN_2="test2.satishweb.com"\
    -e DOMAIN_3="*.satishweb.com"\
    -e CERTBOT_EMAIL="webmaster@satishweb.com" \
    -e PROXY_ADDRESS="proxy" \
    -e PROXY_SEND_MAX_RETRIES="10" \
    -e PROXY_SEND_RETRY_INTERVAL="30" \
    -e CERT_RENEW_INTERVAL="86400" \
    -e CERTBOTMODE="staging" \
    -e AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID} \
    -e AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY} \
    -e AWS_REGION=${AWS_REGION} \
    -e AWS_HOSTED_ZONE_ID=${AWS_HOSTED_ZONE_ID} \
    -v $(pwd)/data/letsencrypt:/etc/letsencrypt \
    -v $(pwd)/docker-entrypoint:/docker-entrypoint \
    -v $(pwd)/certbot.sh:/certbot.sh \
satishweb/docker-flow-proxy-cert-manager-letsencrypt-aws-route53:latest

致谢

灵感来源于：https://github.com/hamburml/docker-flow-letsencrypt