li2x/acme.sh

li2x/acme.sh 镜像说明

镜像概述

li2x/acme.sh是Neilpang/acme.sh的分支版本，是一款纯Shell语言实现的ACME协议客户端，用于自动获取、续期Let's Encrypt等证书颁发机构（CA）的免费SSL证书。它支持ACME v1/v2协议（包括通配符证书），兼容Bash、dash、sh等多种Shell，无需依赖Python或官方Let's Encrypt客户端，操作简单且Docker友好。

核心功能

1. 多协议支持：完整实现ACME v1/v2协议，支持通配符证书。
2. 多验证模式：Webroot、Standalone（80/443端口）、Apache、Nginx、DNS（自动/手动）等模式。
3. 证书类型：支持RSA和ECC（ECDSA）证书。
4. DNS API集成：支持阿里云、CloudFlare、DNSPod等数十种DNS服务商的自动验证。
5. 自动续期：证书每60天自动续期，无需人工干预。
6. 轻量无依赖：纯Shell编写，无需Python或其他复杂依赖。
7. 跨平台兼容：支持Ubuntu、Debian、CentOS、FreeBSD、Windows（Cygwin）等多种操作系统。

使用场景

• 网站或服务需要配置SSL证书的开发者/运维人员。
• 需要自动续期证书以避免手动更新的场景。
• 使用多种DNS服务商且希望自动完成域名验证的用户。
• 偏好轻量级、无依赖工具的技术人员。

配置说明

1. Docker部署示例

基础使用（Webroot模式）

bash
docker run --rm -v ~/.acme.sh:/acme.sh -v /var/www/html:/var/www/html li2x/acme.sh \
  --issue -d example.com -w /var/www/html

• -v ~/.acme.sh:/acme.sh：挂载本地目录保存证书和配置。
• -v /var/www/html:/var/www/html：挂载Webroot目录用于验证。

DNS API模式（阿里云示例）

bash
docker run --rm -v ~/.acme.sh:/acme.sh -e Ali_Key="your_ali_key" -e Ali_Secret="your_ali_secret" li2x/acme.sh \
  --issue -d example.com -d *.example.com --dns dns_ali

2. 证书安装（以Nginx为例）

生成证书后，将证书安装到Nginx配置目录：

bash
docker run --rm -v ~/.acme.sh:/acme.sh -v /etc/nginx/ssl:/etc/nginx/ssl li2x/acme.sh \
  --install-cert -d example.com \
  --key-file /etc/nginx/ssl/example.com.key \
  --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem \
  --reloadcmd "service nginx reload"

3. 自动续期

镜像默认包含每日 cron 任务，自动检查并续期证书。如需手动触发续期：

bash
docker run --rm -v ~/.acme.sh:/acme.sh li2x/acme.sh --renew -d example.com

4. 升级镜像

bash
docker pull li2x/acme.sh

更多信息

• 官方文档：https://github.com/li2xi/acme.sh/wiki
• 支持的DNS服务商：阿里云、CloudFlare、DNSPod等数十种（详见官方文档）。
• 许可证：GPLv3。