serversideup/certbot-dns-cloudflare
serversideup
围绕certbot/dns-cloudflare的简单包装，添加了证书自动续期功能，用于通过Cloudflare DNS插件从Let's Encrypt生成和自动续期SSL证书，提供灵活的配置选项。
3 次收藏下载次数: 0状态：社区镜像维护者：serversideup仓库类型：镜像最近更新：6 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可：
请先阅读并遵守：https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Certbot Cloudflare DNS Docker容器
该容器用于通过Cloudflare DNS插件从Let's Encrypt生成和自动续期SSL证书。它基于https://hub.docker.com/r/certbot/dns-cloudflare构建，增加了一些修改使其更加灵活和可配置。
| Docker镜像 | 大小 |
|---|---|
| https://hub.docker.com/r/serversideup/certbot-dns-cloudflare |
基础镜像
该镜像基于certbot/dns-cloudflare:latest，为运行带有Cloudflare DNS认证的Certbot提供稳定且最新的环境。
特性
- 使用Let's Encrypt自动生成和续期SSL证书
- 无需配置文件，该镜像会为您生成cloudflare.ini文件
- Cloudflare DNS认证用于域名验证
- 通过环境变量进行自定义配置
- 定期证书续期检查
- Windows支持（将
REPLACE_SYMLINKS设置为true） - 原生Docker健康检查确保服务正常运行
非常适合编排部署
我们设计此镜像以在Kubernetes、Docker Swarm甚至Github Actions等编排部署中表现出色。语法非常简单：
yamlcertbot: image: docker.xuanyuan.run/serversideup/certbot-dns-cloudflare volumes: - certbot_data:/etc/letsencrypt environment: CLOUDFLARE_API_TOKEN: "${CLOUDFLARE_API_TOKEN}" CERTBOT_EMAIL: "${CERTBOT_EMAIL}" CERTBOT_DOMAINS: "${CERTBOT_DOMAINS}" CERTBOT_KEY_TYPE: "rsa" volumes: certbot_data:
环境变量
以下环境变量可用于自定义Certbot容器：
| 变量 | 描述 | 默认值 |
|---|---|---|
CERTBOT_DOMAINS | 要获取证书的域名的逗号分隔列表 | - |
CERTBOT_EMAIL | 用于Let's Encrypt通知的电子邮件地址 | - |
CERTBOT_KEY_TYPE | 要生成的私钥类型 | ecdsa |
CERTBOT_SERVER | ACME服务器URL | https://acme-v02.api.letsencrypt.org/directory |
CLOUDFLARE_API_TOKEN | 用于DNS认证的Cloudflare API令牌（见下文如何创建） | - |
CLOUDFLARE_CREDENTIALS_FILE | Cloudflare凭证文件的路径 | /cloudflare.ini |
CLOUDFLARE_PROPAGATION_SECONDS | 设置DNS TXT记录后等待验证前的时间（秒）。如果DNS传播缓慢，此设置很有用 | 10 |
DEBUG | 启用调试模式（向控制台打印更多信息） | false |
PUID | 运行certbot的用户ID | 0 |
PGID | 运行certbot的组ID | 0 |
RENEWAL_INTERVAL | 证书续期检查之间的间隔。设置为0可禁用续期，只运行一次 | 43200秒（12小时） |
REPLACE_SYMLINKS | 将符号链接替换为它们引用的文件的直接副本（Windows需要） | false |
创建Cloudflare API令牌
[!WARNING]
请将此令牌视为密码。它将授予访问您的Cloudflare账户的权限，并可用于修改DNS记录。
- 转到https://dash.cloudflare.com/profile/api-tokens页面。
- 点击"创建令牌"。
- 点击"使用模板"中的"编辑区域DNS"模板。
- 更改令牌名称（可选）
- 在"区域资源"下设置特定区域（可选）
- 点击"继续到摘要"。
- 点击"创建令牌"。
使用方法
-
拉取Docker镜像：
shdocker pull docker.xuanyuan.run/serversideup/certbot-dns-cloudflare:latest -
使用所需的环境变量运行容器：
[!CAUTION] 确保将
-v /path/to/your/certs:/etc/letsencrypt替换为您主机上的有效路径。
shdocker run \ -e CERTBOT_DOMAINS="yourdomain.com" \ -e CERTBOT_EMAIL="your-email@example.com" \ -e CLOUDFLARE_API_TOKEN="your-cloudflare-api-token" \ -v /path/to/your/certs:/etc/letsencrypt \ docker.xuanyuan.run/serversideup/certbot-dns-cloudflare:latest
[!TIP] 对于通配符证书，Docker实例健康检查使用以下顺序：
domain.name, *.domain.name
- 容器将自动生成和续期证书。
资源
- ******* - 来自社区和团队的友好支持。
- https://github.com/serversideup/docker-certbot-dns-cloudflare - 源代码、错误报告和项目管理。
- 获取专业帮助 - 直接从核心贡献者获取视频+屏幕共享帮助。
贡献
作为一个开源项目，我们致力于开发过程的透明度和协作。我们非常感谢社区成员能够提供的任何贡献。无论您是修复错误、提出功能建议、改进文档还是提高知名度，您的参与都将增强项目的实力。
- 错误报告：如果您在使用这些镜像时遇到问题，请https://github.com/serversideup/docker-certbot-dns-cloudflare/issues/new/choose。
- 安全报告：通过我们的负责任披露政策报告严重安全问题。
需要帮助入门？加入我们的***社区，我们会为您提供帮助！
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 certbot-dns-cloudflare 镜像标签
docker pull docker.xuanyuan.run/serversideup/certbot-dns-cloudflare:<标签>
DockerHub 原生拉取命令
docker pull serversideup/certbot-dns-cloudflare:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"
