mbentley/acme.sh

镜像概述

mbentley/acme.sh是acmesh-official/acme.sh的Docker化实现，基于alpine:latest构建。该镜像提供轻量级环境，用于通过ACME协议自动获取、续期和管理SSL/TLS证书，支持Let's Encrypt等证书颁发机构。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• ACME协议支持：完整实现ACME客户端功能，支持证书颁发与续期
• DNS验证集成：兼容acme.sh的DNS API插件（如dns_aws、dns_cloudflare等）
• 数据持久化：通过卷挂载实现证书和配置的持久化存储
• 测试环境支持：可通过--staging参数使用测试环境，避免生产环境限制

使用场景

• 需要自动管理SSL/TLS证书的Web服务
• 需通过DNS验证获取通配符证书（如*.example.com）的场景
• CI/CD流程中集成证书自动颁发与更新
• 多环境统一证书管理需求

使用方法

拉取镜像

bash
docker pull mbentley/acme.sh

基本用法

默认运行时显示acme.sh帮助信息：

bash
docker run -it --rm \
  -v ~/acme.sh:/root/.acme.sh \  # 持久化存储证书和配置
  mbentley/acme.sh

DNS验证插件示例（以dns_aws为例）

前置准备

1. 建议先使用--staging参数测试，验证配置正确性
2. 下载对应DNS插件脚本（如dns_aws.sh），放置于持久化目录（如~/acme.sh）
3. 插件引用时省略.sh后缀（如dns_aws.sh对应dns_aws）

创建通配符证书

bash
docker 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  # 颁发证书命令

续期证书

bash
docker 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  # 续期证书命令

配置说明

环境变量

卷挂载

注意事项

• 生产环境使用前必须通过--staging测试验证流程
• 敏感信息（如API密钥）建议通过环境变量传入，避免硬编码
• 证书续期需确保DNS插件配置与创建时一致
• 更多插件使用方法参见acme.sh DNS API文档

详细文档请参考acmesh-official/acme.sh***仓库。