kyleondy/docker-letsencrypt-dns-companion

docker-letsencrypt-dns-companion

镜像概述

本镜像为辅助型Docker镜像，旨在通过DNS挑战方式简化Let's Encrypt SSL证书的生成与续期流程。它使用dehydrated工具与Let's Encrypt交互，结合lexicon工具更新DNS记录，支持多种主流DNS提供商。

核心功能

• 支持多种DNS提供商（通过lexicon实现，可参考其官方文档查看支持列表）
• 自动生成和续期Let's Encrypt SSL证书
• 可配置证书输出路径、续期间隔及测试环境（ACME staging服务器）
• 基于环境变量灵活配置，易于集成到Docker Compose等部署环境

使用场景

• 需要为域名获取SSL证书且无法使用HTTP挑战的场景（如无公网IP、多域名管理）
• 自动化证书管理流程，减少手动操作成本
• 开发或测试环境中快速获取测试证书

配置说明

环境变量

• 必填项

  • LETSENCRYPT_EMAIL: Let's Encrypt账户***
  • CERTBOT_DOMAIN: 需要生成证书的域名

• 可选项

  • LETSENCRYPT_CA: ACME服务器地址，默认使用生产环境，测试时可设置为https://acme-staging.api.letsencrypt.org/directory
  • CERTBOT_OUTPUT: 证书输出路径，默认 /certs（建议挂载为卷）
  • CERTBOT_INTERVAL: 证书续期间隔，支持秒(s)、分(m)、时(h)、天(d)，默认1天

Docker Compose示例

yaml
# docker-compose.yml片段
services:
  dns-certbot:
    image: kyleondy/docker-letsencrypt-dns-companion:stable
    environment:
      - PROVIDER=digitalocean
      - LEXICON_DIGITALOCEAN_TOKEN=your_digitalocean_token
      - CERTBOT_DOMAIN=www.example.com
      - LETSENCRYPT_EMAIL=john@doe.com
      - CERTBOT_OUTPUT=/certs
    volumes:
      - ./certs:/certs

注意：示例中PROVIDER需根据使用的DNS提供商设置，对应的API令牌需正确配置（如LEXICON_DIGITALOCEAN_TOKEN对应DigitalOcean提供商）。 ===END===