jordemort/acme

docker-acme

镜像概述和主要用途

docker-acme是一个用于运行https://github.com/acmesh-official/acme.sh%E7%9A%84%E5%AE%B9%E5%99%A8%E3%80%82%E4%B8%8E%E5%AE%98%E6%96%B9%E5%AE%B9%E5%99%A8%E7%9B%B8%E6%AF%94%EF%BC%8C%E5%85%B6%E6%A0%B8%E5%BF%83%E4%BC%98%E5%8A%BF%E5%9C%A8%E4%BA%8E%EF%BC%9A%E4%B8%8D%E4%BB%A5root%E8%BA%AB%E4%BB%BD%E8%BF%90%E8%A1%8C%EF%BC%8C%E4%B8%94%E9%9B%86%E6%88%90%E4%BA%86openssh%E5%92%8CDocker CLI工具，支持在证书更新后的reloadCmd中执行容器重启或远程连接其他机器等操作。

核心功能和特性

• 非root运行：容器以非root用户身份运行，提升运行安全性
• 工具集成：内置openssh和Docker CLI，支持在证书更新后执行复杂的后续操作（如重启关联容器、远程管理其他设备）

使用场景和适用范围

该镜像主要适用于采用DNS挑战方式获取SSL证书的场景。由于采用非root运行模式，若需使用HTTP挑战（需绑定80或443端口）则需要额外配置，而作者因主要使用DNS挑战未实现相关适配，因此HTTP挑战场景可能需要用户自行处理端口映射等配置。

详细使用方法和配置说明

镜像来源

本镜像基于GitHub仓库https://github.com/jordemort/docker-acme%E6%9E%84%E5%BB%BA%E3%80%82

基本部署示例

Docker Run 命令

bash
# 简单运行
docker run -d --name acme-container jordemort/docker-acme

# 持久化存储证书
docker run -d --name acme-container \
  -v /path/to/local/certificates:/acme.sh \
  jordemort/docker-acme

启用Docker CLI功能

如需在reloadCmd中使用Docker CLI操作宿主机容器，需挂载Docker套接字：

bash
docker run -d --name acme-container \
  -v /path/to/local/certificates:/acme.sh \
  -v /var/run/docker.sock:/var/run/docker.sock \
  jordemort/docker-acme

配置参数说明

具体配置需参考acme.sh官方文档及镜像GitHub仓库，主要包括：

• 证书申请参数：域名、DNS提供商API密钥、证书存储路径等
• reloadCmd配置：证书更新后执行的命令，可利用内置Docker CLI实现如docker restart nginx等操作
• SSH配置：如需远程操作其他机器，可通过环境变量或挂载配置文件设置SSH密钥

注意事项

• 避免直接绑定80/443端口，推荐使用DNS挑战方式
• 使用Docker CLI功能时，需确保容器对/var/run/docker.sock具有适当权限
• 证书存储目录建议通过卷挂载实现持久化，避免容器重建导致证书丢失