目录
使用 acme.sh配合Cloudflare DNS验证 是申请免费SSL证书最灵活、最强大的方式之一——尤其适合防火墙后的服务器、无法开放端口的环境,或需要申请覆盖所有子域名的 通配符SSL。本指南从安装到配置自动续期,全程详细讲解。
1. acme.sh简介
acme.sh 是一个纯Unix Shell脚本实现的ACME协议客户端,无需Python、Ruby或任何外部依赖,可在Linux、macOS及各类Unix系统上运行。支持超过150个DNS提供商,包括Cloudflare、Route53、GoDaddy等。
| 功能特性 | acme.sh | Certbot |
|---|---|---|
| 开发语言 | Shell脚本 | Python |
| 外部依赖 | 无 | Python + pip包 |
| DNS提供商支持 | 150+ | 约30个(通过插件) |
| 通配符SSL | ✅ 支持 | ✅ 支持 |
| 自动续期 | ✅ Cron定时任务 | ✅ Systemd定时器 |
| 非root安装 | ✅ 支持 | ❌ 需要root权限 |
2. DNS验证与HTTP验证对比
ACME协议提供两种主要的域名验证方式:
- HTTP-01验证:在服务器的
/.well-known/acme-challenge/目录创建文件,需开放80端口且服务器可公开访问。 - DNS-01验证:在DNS中添加TXT记录,无需开放任何端口,是申请通配符SSL的唯一方式。
Cloudflare DNS验证的适用场景:
- 服务器位于防火墙后或私有网络中
- 需要通配符SSL(
*.example.com) - 80端口被防火墙封锁或已被其他服务占用
- 需要零停机时间的自动化续期
3. 前提条件
- Linux服务器(Ubuntu、CentOS、Debian等)
- 使用Cloudflare作为域名服务器的域名
- Cloudflare免费账号
- 服务器的root或sudo权限
- 已安装
curl和openssl(通常预装)
4. 安装acme.sh
一条命令完成安装:
# 从GitHub安装
curl https://get.acme.sh | sh -s [email protected]
# 使用wget
wget -O - https://get.acme.sh | sh -s [email protected]
安装程序会:
- 创建
~/.acme.sh/目录 - 在shell配置文件中添加
acme.sh别名 - 安装自动续期的Cron定时任务
# 重新加载shell别名
source ~/.bashrc
# 验证安装
acme.sh --version
设置默认CA为Let's Encrypt
acme.sh --set-default-ca --server letsencrypt
5. 配置Cloudflare API令牌
acme.sh支持两种Cloudflare认证方式:
方式一:API令牌(推荐)
- 进入Cloudflare控制台 → 我的个人资料 → API令牌
- 点击创建令牌
- 选择编辑区域DNS模板
- 区域资源:选择特定区域或所有区域
- 点击继续到摘要 → 创建令牌
- 保存令牌(仅显示一次)
export CF_Token="your_cloudflare_api_token"
export CF_Account_ID="your_cloudflare_account_id"
方式二:全局API密钥(不推荐)
export CF_Key="your_global_api_key"
export CF_Email="[email protected]"
6. 申请SSL证书
为单个域名申请SSL:
# 申请SSL(先export CF_Token)
acme.sh --issue --dns dns_cf \
--domain example.com \
--domain www.example.com
acme.sh将:
- 通过Cloudflare API在
_acme-challenge.example.com创建TXT记录 - 等待DNS传播(约10-30秒)
- 向Let's Encrypt / ZeroSSL提交验证
- 将证书存储在
~/.acme.sh/example.com/
# 生成的证书文件
~/.acme.sh/example.com/
├── example.com.cer # 证书文件
├── example.com.key # 私钥文件
├── ca.cer # CA证书链
└── fullchain.cer # 完整证书链(最常用)
7. 申请通配符SSL
通配符SSL覆盖*.example.com的所有子域名:
# 申请通配符SSL(必须使用DNS验证)
acme.sh --issue --dns dns_cf \
--domain example.com \
--domain "*.example.com"
example.com和*.example.com,因为通配符不自动覆盖根域名本身。
多域名SSL(SAN证书)
# 一张证书覆盖多个域名
acme.sh --issue --dns dns_cf \
--domain example.com \
--domain www.example.com \
--domain api.example.com \
--domain app.example.com
8. 在服务器上安装证书
申请证书后,将其部署到Web服务器:
Nginx配置
acme.sh --install-cert -d example.com \
--cert-file /etc/nginx/ssl/example.com.cer \
--key-file /etc/nginx/ssl/example.com.key \
--fullchain-file /etc/nginx/ssl/fullchain.cer \
--reloadcmd "systemctl reload nginx"
Apache配置
acme.sh --install-cert -d example.com \
--cert-file /etc/apache2/ssl/example.com.cer \
--key-file /etc/apache2/ssl/example.com.key \
--fullchain-file /etc/apache2/ssl/fullchain.cer \
--reloadcmd "systemctl reload apache2"
Nginx虚拟主机配置
server {
listen 443 ssl;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.cer;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
}
--install-cert命令。这样acme.sh才能记录部署路径和重载命令,确保自动续期时正确更新证书。
9. 自动续期SSL
acme.sh在安装时自动设置定时任务,可通过以下命令验证:
# 检查acme.sh定时任务
crontab -l | grep acme
预期输出:
0 0 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null
定时任务每天午夜运行,自动续期剩余有效期少于30天的证书,并执行--install-cert时指定的--reloadcmd重载Web服务器。
强制续期与调试
# 强制续期(用于测试)
acme.sh --renew -d example.com --force
# 查看所有证书状态
acme.sh --list
# 调试模式
acme.sh --issue --dns dns_cf -d example.com --debug 2
# 测试模式(不消耗速率限制配额)
acme.sh --issue --dns dns_cf -d example.com --staging
10. 常见问题
acme.sh与Certbot有什么区别?
acme.sh是纯Shell脚本,无需Python依赖,支持150多个DNS提供商,可在无root权限下安装。Certbot需要Python和额外的DNS插件。对于基于DNS的工作流,acme.sh通常更易于配置。
Cloudflare DNS验证需要多长时间?
通常10-30秒。Cloudflare的TXT记录传播非常快速。若DNS提供商较慢,可添加--dnssleep 60参数增加等待时间。
Cloudflare API令牌过期或被撤销后会影响自动续期吗?
会。需要创建新令牌并更新环境变量,或将其永久保存至~/.acme.sh/account.conf文件中:SAVED_CF_Token="...",确保跨会话持久有效。
acme.sh可以在共享虚拟主机上使用吗?
可以,前提是有SSH访问权限且能创建定时任务。大多数共享主机环境都预装了curl和openssl。在支持SSH的DirectAdmin主机上可直接使用。
Let's Encrypt SSL证书受所有浏览器信任吗?
是的。Let's Encrypt和ZeroSSL证书受所有现代浏览器和操作系统信任,包括Chrome、Firefox、Safari、Edge、Android 7.1+和iOS 10+。
与在AsiaGB DirectAdmin控制面板申请SSL有何不同?
AsiaGB的DirectAdmin主机内置一键申请Let's Encrypt SSL功能,无需额外配置。acme.sh + Cloudflare更适合VPS环境、通配符SSL需求,或通过Cloudflare单独管理DNS的场景。每月两次自动备份的主机方案,安全可靠。
总结
acme.sh + Cloudflare DNS验证的优势:
- ✅ 完全免费 — 使用Let's Encrypt或ZeroSSL
- ✅ 支持通配符SSL — DNS验证覆盖
*.example.com - ✅ 无需开放端口 — 纯DNS验证
- ✅ 全自动续期 — 定时任务每60天自动续期
- ✅ 安装简单 — 纯Shell脚本,零依赖
如果您使用 AsiaGB 的虚拟主机或VPS服务,基础SSL可直接在DirectAdmin控制面板申请。通配符SSL或高级应用场景,acme.sh + Cloudflare是最佳解决方案。