adferrand/letsencrypt-dns

!https://raw.githubusercontent.com/adferrand/docker-letsencrypt-dns/master/images/logo_from_realies_200px.png adferrand/letsencrypt-dns

![version]([] ![docker]([] ![ci]([***]

弃用警告（Deprecation Warning）

Docker镜像 adferrand/letsencrypt-dns 自 3.0.0 版本起已被正式弃用。

请使用替代镜像 https://hub.docker.com/r/adferrand/dnsrobocert%E3%80%82

镜像概述和主要用途

概述

adferrand/letsencrypt-dns 是一款用于编排 Let's Encrypt TLS 证书的 Docker 镜像，核心通过 DNS 挑战（DNS challenge）完成证书验证流程。该镜像旨在简化需要通过 DNS 记录验证域名所有权场景下的证书申请与管理流程。

主要用途

• 自动完成 Let's Encrypt TLS 证书的申请、续期与管理
• 通过 DNS 挑战方式验证域名所有权，适用于无法通过 HTTP 挑战验证的场景

核心功能和特性

（注：由于该镜像已弃用，以下功能基于历史版本信息整理，建议参考替代镜像 adferrand/dnsrobocert 获取最新功能说明）

• DNS 挑战验证：支持通过 DNS 记录自动配置与清理，完成 Let's Encrypt 证书的 DNS 挑战验证
• 证书编排：自动化管理证书生命周期，包括申请、续期（接近过期时自动更新）和存储
• 多域名支持：可同时为多个域名或通配符域名（如 *.example.com）申请证书
• 跨平台兼容性：适配主流 DNS 服务商 API（需对应配置），支持在多种环境中部署

使用场景和适用范围

适用场景

• 无法通过 HTTP 验证的环境：如服务器位于防火墙后、无公网 HTTP 服务，或域名解析指向多台服务器需共享证书的场景
• 通配符证书需求：需要为通配符域名（如 *.example.com）申请证书（Let's Encrypt 通配符证书仅支持 DNS 挑战验证）
• 自动化证书管理：需减少手动操作，实现证书全生命周期自动化管理的场景

适用范围

• 需要部署 TLS 证书的服务器（如 Web 服务器、邮件服务器、API 服务等）
• 依赖 Let's Encrypt 免费证书且符合 DNS 挑战验证条件的个人或企业用户

使用方法和配置说明

重要提示

由于 adferrand/letsencrypt-dns 已被弃用，官方不再提供更新和维护，**强烈建议迁移至替代镜像 https://hub.docker.com/r/adferrand/dnsrobocert**%EF%BC%8C%E4%BB%A5%E8%8E%B7%E5%8F%96%E6%9C%80%E6%96%B0%E5%8A%9F%E8%83%BD%E6%94%AF%E6%8C%81%E3%80%81%E5%AE%89%E5%85%A8%E6%9B%B4%E6%96%B0%E5%92%8C%E6%96%87%E6%A1%A3%E3%80%82

历史使用方式（仅供参考，不推荐继续使用）

若需临时使用旧版本（不保证兼容性和安全性），基本部署流程如下：

1. 准备配置文件

创建 dnsrobocert.yml 配置文件（与替代镜像配置类似，具体语法请参考旧版文档），指定 DNS 服务商 API 密钥、域名列表、证书存储路径等。

2. 启动容器（示例）

bash
docker run -d \
  --name letsencrypt-dns \
  -v /path/to/config:/etc/dnsrobocert \
  -v /path/to/certificates:/etc/letsencrypt \
  adferrand/letsencrypt-dns:2.x.x  # 仅支持 3.0.0 以下版本

注意事项

• 旧版本镜像可能存在安全漏洞或兼容性问题，不建议在生产环境使用
• 配置参数、环境变量及 DNS 服务商适配详情，请查阅该镜像 3.0.0 之前版本的历史文档

迁移建议

1. 停止并移除旧容器：docker stop letsencrypt-dns && docker rm letsencrypt-dns
2. 参考 https://hub.docker.com/r/adferrand/dnsrobocert 官方文档，调整配置文件（大部分配置兼容，但需注意版本差异）
3. 使用新镜像启动容器，迁移证书存储目录（通常为 /etc/letsencrypt）至新容器卷挂载路径