mbentley/letsencrypt
mbentley
自动构建
基于acmesh-official/acme.sh的Docker镜像，使用纯Unix shell脚本实现ACME客户端协议，用于自动获取和管理Let's Encrypt等证书颁发机构的SSL/TLS证书，基于alpine:latest构建，轻量高效。
下载次数: 0状态：自动构建维护者：mbentley仓库类型：镜像最近更新：1 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
mbentley/acme.sh
镜像概述
mbentley/acme.sh是https://github.com/acmesh-official/acme.sh%E7%9A%84Docker%E5%8C%96%E5%AE%9E%E7%8E%B0%EF%BC%8C%E5%9F%BA%E4%BA%8E%60alpine:latest%60%E6%9E%84%E5%BB%BA%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9B%E8%BD%BB%E9%87%8F%E7%BA%A7%E7%8E%AF%E5%A2%83%EF%BC%8C%E7%94%A8%E4%BA%8E%E9%80%9A%E8%BF%87ACME%E5%8D%8F%E8%AE%AE%E8%87%AA%E5%8A%A8%E8%8E%B7%E5%8F%96%E3%80%81%E7%BB%AD%E6%9C%9F%E5%92%8C%E7%AE%A1%E7%90%86SSL/TLS%E8%AF%81%E4%B9%A6%EF%BC%8C%E6%94%AF%E6%8C%81Let's Encrypt等证书颁发机构。
核心功能与特性
- 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
- ACME协议支持：完整实现ACME客户端功能，支持证书颁发与续期
- DNS验证集成：兼容acme.sh的DNS API插件（如
dns_aws、dns_cloudflare等） - 数据持久化：通过卷挂载实现证书和配置的持久化存储
- 测试环境支持：可通过
--staging参数使用测试环境，避免生产环境限制
使用场景
- 需要自动管理SSL/TLS证书的Web服务
- 需通过DNS验证获取通配符证书（如
*.example.com）的场景 - CI/CD流程中集成证书自动颁发与更新
- 多环境统一证书管理需求
使用方法
拉取镜像
bashdocker pull mbentley/acme.sh
基本用法
默认运行时显示acme.sh帮助信息：
bashdocker run -it --rm \ -v ~/acme.sh:/root/.acme.sh \ # 持久化存储证书和配置 mbentley/acme.sh
DNS验证插件示例（以dns_aws为例）
前置准备
- 建议先使用
--staging参数测试，验证配置正确性 - 下载对应DNS插件脚本（如
dns_aws.sh），放置于持久化目录（如~/acme.sh） - 插件引用时省略
.sh后缀（如dns_aws.sh对应dns_aws）
创建通配符证书
bashdocker run -it --rm \ -v ~/.acme.sh:/root/.acme.sh \ # 挂载持久化卷 -e AWS_ACCESS_KEY_ID \ # 传入AWS访问密钥（环境变量需预先定义） -e AWS_SECRET_ACCESS_KEY \ # 传入AWS密钥（环境变量需预先定义） mbentley/acme.sh:latest \ --issue --domain '*.example.com' --dns dns_aws # 颁发证书命令
续期证书
bashdocker run -it --rm \ -v ~/.acme.sh:/root/.acme.sh \ -e AWS_ACCESS_KEY_ID \ -e AWS_SECRET_ACCESS_KEY \ mbentley/acme.sh:latest \ --renew --domain '*.example.com' --dns dns_aws # 续期证书命令
配置说明
环境变量
| 变量名 | 说明 | 必需性 |
|---|---|---|
AWS_ACCESS_KEY_ID | AWS访问密钥ID（用于dns_aws） | 插件依赖 |
AWS_SECRET_ACCESS_KEY | AWS密钥（用于dns_aws） | 插件依赖 |
卷挂载
| 容器路径 | 宿主机路径示例 | 说明 |
|---|---|---|
/root/.acme.sh | ~/acme.sh | 存储证书、配置及插件 |
注意事项
- 生产环境使用前必须通过
--staging测试验证流程 - 敏感信息（如API密钥）建议通过环境变量传入，避免硬编码
- 证书续期需确保DNS插件配置与创建时一致
- 更多插件使用方法参见https://github.com/acmesh-official/acme.sh/tree/master/dnsapi
详细文档请参考https://github.com/acmesh-official/acme.sh%E3%80%82
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 letsencrypt 镜像标签
docker pull docker.xuanyuan.run/mbentley/letsencrypt:<标签>
DockerHub 原生拉取命令
docker pull mbentley/letsencrypt:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"