SSL

使用acme.sh通过Cloudflare DNS挑战免费获取SSL证书

📅 2026年11月16日 ⏱ 阅读约12分钟 ✍️ AsiaGB
使用acme.sh通过Cloudflare DNS挑战免费获取SSL证书

使用 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.shCertbot
开发语言Shell脚本Python
外部依赖无Python + pip包
DNS提供商支持150+约30个(通过插件)
通配符SSL✅ 支持✅ 支持
自动续期✅ Cron定时任务✅ Systemd定时器
非root安装✅ 支持❌ 需要root权限
💡 提示: acme.sh支持多个证书颁发机构:Let's Encrypt、ZeroSSL(默认)、Buypass Go SSL和Google Trust Services。所有DV证书均免费,受所有主流浏览器信任。

2. DNS验证与HTTP验证对比

ACME协议提供两种主要的域名验证方式:

Cloudflare DNS验证的适用场景:

3. 前提条件

⚠️ 重要: 域名必须将Nameserver指向Cloudflare(ns1.cloudflare.com / ns2.cloudflare.com),Cloudflare DNS API才能正常工作。若使用Cloudflare部分代理(CNAME)模式,可能需要额外配置。

4. 安装acme.sh

一条命令完成安装:

# 从GitHub安装
curl https://get.acme.sh | sh -s [email protected]

# 使用wget
wget -O - https://get.acme.sh | sh -s [email protected]

安装程序会:

# 重新加载shell别名
source ~/.bashrc

# 验证安装
acme.sh --version

设置默认CA为Let's Encrypt

acme.sh --set-default-ca --server letsencrypt

5. 配置Cloudflare API令牌

acme.sh支持两种Cloudflare认证方式:

方式一:API令牌(推荐)

  1. 进入Cloudflare控制台 → 我的个人资料 → API令牌
  2. 点击创建令牌
  3. 选择编辑区域DNS模板
  4. 区域资源:选择特定区域或所有区域
  5. 点击继续到摘要 → 创建令牌
  6. 保存令牌(仅显示一次)
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]"
⚠️ 安全提示: 强烈建议使用API令牌而非全局API密钥。令牌仅限DNS:Edit权限,即使泄露,危害也远小于拥有完整账号权限的全局密钥。

6. 申请SSL证书

为单个域名申请SSL:

# 申请SSL(先export CF_Token)
acme.sh --issue --dns dns_cf \
  --domain example.com \
  --domain www.example.com

acme.sh将:

  1. 通过Cloudflare API在_acme-challenge.example.com创建TXT记录
  2. 等待DNS传播(约10-30秒)
  3. 向Let's Encrypt / ZeroSSL提交验证
  4. 将证书存储在~/.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是最佳解决方案。