免费通配符证书申请指南:Let’s Encrypt DNS-01 实操、续期与排错
免费通配符证书可通过 Let's Encrypt 的 ACME DNS-01 挑战申请,证书有效期 90 天,支持 *.example.com 与 example.com,无需付费,但必须能自动写入 _acme-challenge TXT 记录才能稳定续期。 据 Let's Encrypt 文档,通配符证书只能走 DNS-01;HTTP-01 无法验证 *.example.com,certbot 用 --nginx 申请会直接报 authenticator 不支持。 certbot 2.11.0 常用命令:certbot certonly --dns-cloudflare --dns-cloudflare-credentials ~/.secrets/cloudflare.ini --dns-cloudflare-propagation-seconds 60 -d example.com -d '*.example.com'。 acme.sh 3.0.9 可用 --dns dns_cf 自动写入 TXT;certbot --manual 手动模式不会自动续期,不建议生产使用。 验证命令:openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName。
为什么免费通配符证书只能走 DNS-01?问题背景与根本原因
为什么不能像普通证书那样用 HTTP-01 验证?因为 HTTP-01 的验证路径是固定的 http://<domain>/.well-known/acme-challenge/<token>,CA 必须能对”某个具体主机名”发起一次真实的 HTTP 请求。而 *.example.com 是一个模式,不是一台主机——CA 无法对星号本身发请求,也无从枚举它背后有多少台机器。据 Let’s Encrypt 官方文档《Challenge Types》明确写道:通配符证书只能通过 DNS-01 签发,HTTP-01 与 TLS-ALPN-01 均不支持。这不是客户端工具的能力缺陷,而是 RFC 8555 与 CA/B Forum 基线要求共同决定的域名控制证明(Domain Control Validation)逻辑:DNS-01 通过让你在权威 DNS 写入指定 TXT 值,证明你控制了整个域名的解析权,因而能一次性覆盖任意一级子域。
先搞清楚 *. 到底覆盖什么。按 RFC 6125 与 CA/B Forum BR 的约束,通配符只能出现在最左标签,且只匹配一级:*.example.com 覆盖 a.example.com,不覆盖 a.b.example.com,也不自动包含裸域 example.com。所以生产环境的正确做法是把两个名字放进同一张 SAN 证书,这也是后文命令里始终写 -d example.com -d '*.example.com' 的原因。
免费 CA 与商业证书的现实边界。据 Let’s Encrypt 官网,其证书有效期 90 天、2025 年仍然完全免费,受速率限制约束(每个注册域名每周 50 张,通配符证书同样计入);ZeroSSL 免费账户可同时持有 3 张 90 天证书,同样通过 ACME 提供通配符。两者均被主流浏览器公开信任。
| 对比项 | Let’s Encrypt | ZeroSSL 免费 | 商业 DV 通配符 |
|---|---|---|---|
| 单张有效期 | 90 天 | 90 天 | 365 天 |
| 通配符验证方式 | 仅 DNS-01 | 仅 DNS-01 | DNS-01 / 邮箱 / 文件(视 CA 而定) |
| 免费额度 | 50 张/注册域名/周 | 3 张并发 | 无 |
| 价格 | 0 元 | 0 元 | 约 300–1500 元/年 |
| 发票 / 商业 SLA | 无 | 无 | 有 |
DNS-01 的执行流程。ACME 服务端返回一个随机 token,客户端对它做 SHA-256 后 Base64URL 编码,写入 _acme-challenge.example.com 的 TXT 记录;CA 从权威 DNS 递归查询并比对。权威 DNS 同步加递归缓存通常需 60–300 秒,Cloudflare 免费版 TTL 最小 60 秒(Auto 为 300 秒)。用 acme.sh 的完整序列如下(acme.sh 3.x 起默认 CA 是 ZeroSSL,必须显式指定 --server letsencrypt):
# 1) 安装 acme.sh(默认装到 ~/.acme.sh,并自动注册 cron 续期任务)
curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
# 2) Cloudflare API Token:权限必须含 Zone:Read + Zone:DNS:Edit,仅 Zone:Read 会 403
export CF_Token="你的API_Token"
export CF_Account_ID="你的Account_ID"
# 3) 一次签发裸域 + 一级通配符,ECC 密钥,走 Let's Encrypt
~/.acme.sh/acme.sh --issue --dns dns_cf
-d example.com -d '*.example.com'
--keylength ec-256
--server letsencrypt
# 4) 安装证书并热重载服务(示例为 Nginx)
~/.acme.sh/acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.pem
--reloadcmd "systemctl reload nginx"
若用 Certbot,则需先装 python3-certbot-dns-cloudflare,凭据文件权限设为 600,命令为 certbot certonly --dns-cloudflare --dns-cloudflare-credentials /etc/letsencrypt/cloudflare.ini -d example.com -d '*.example.com';注意 --dns-cloudflare-propagation-seconds 默认仅 10 秒,Cloudflare 场景建议显式设为 60。
失败往往不出在”证书贵不贵”,而在这几处。最常见的真实报错是 Detail: DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com——通常是把记录名写成了 _acme-challenge,漏掉了域名后缀;另一种是 Incorrect TXT record "..." found at _acme-challenge.example.com,多因上一轮的旧 TXT 未清理或缓存未过期;如果该名字上已有 CNAME(常见于把验证委派给第三方),TXT 会因 CNAME 与 TXT 冲突而查不到;Cloudflare Token 少了 Zone.DNS Edit 则会直接返回认证失败。因此免费通配符证书的真实成本是 0 元证书费 + DNS API 权限治理 + 自动续期运维,而商业 DV 通配符的价值在于 1 年有效期、发票与可追责的支持渠道。
免费通配符证书怎么申请?Let's Encrypt 完整实操步骤(编号)
想让一张证书同时覆盖 example.com 和任意子域(*.example.com),Let’s Encrypt 只接受 DNS-01 验证。据 Let’s Encrypt 官方文档《Challenge Types》,通配符订单只能走 DNS-01,HTTP-01 会被直接拒绝。这意味着签发链路必须能自动改写 TXT 记录。下面以 Cloudflare 托管 DNS 为例,给出可直接复制的完整序列。
- 确认托管商并准备最小权限凭据。在 Cloudflare 域名概览页右侧复制 Zone ID(32 位十六进制)。进入 My Profile → API Tokens → Create Token,选 “Edit zone DNS” 模板:Permissions 设为 Zone → DNS → Edit,Zone Resources 限定为 Include → Specific zone → example.com。据 Cloudflare 文档,不要使用 Global API Key——它等同账号全局权限,泄露后可操作全部域名乃至账单;Token 只在创建时显示一次。
- 安装客户端。Debian/Ubuntu:
sudo apt update sudo apt install -y certbot python3-certbot-dns-cloudflare certbot --version # 需 ≥ 2.11.0。Debian 12 仓库为 2.1.0、Ubuntu 22.04 为 1.21.0, # 版本不足时改用 snap: # sudo snap install --classic certbot && sudo ln -s /snap/bin/certbot /usr/bin/certbot或安装 acme.sh(3.0.9):
curl https://get.acme.sh | sh -s email=admin@example.com source ~/.bashrc # 载入 alias,脚本落在 ~/.acme.sh/ - 写凭据文件并收紧权限。
mkdir -p ~/.secrets printf 'dns_cloudflare_api_token = 你的Tokenn' > ~/.secrets/cloudflare.ini chmod 600 ~/.secrets/cloudflare.ini # 权限过宽会直接报错,见下方排错 - 签发(certbot)。通配符不包含裸域,两个 -d 都要写:
sudo certbot certonly --dns-cloudflare --dns-cloudflare-credentials ~/.secrets/cloudflare.ini --dns-cloudflare-propagation-seconds 60 # 默认 10 秒,Cloudflare 全球生效常需 30–60 秒 -d example.com -d '*.example.com' --agree-tos -m admin@example.com --no-eff-email # 成功输出:Certificate is saved at: /etc/letsencrypt/live/example.com/fullchain.pem # Key is saved at: /etc/letsencrypt/live/example.com/privkey.pem - 签发(acme.sh 替代方案)。注意 acme.sh 3.x 默认 CA 已改为 ZeroSSL,要拿 Let’s Encrypt 必须显式指定 server:
export CF_Token="你的Token" # acme.sh 读环境变量,不读上面的 ini acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' --keylength ec-256 --server letsencrypt # 证书目录:~/.acme.sh/example.com_ecc/ - 手动 DNS 模式仅用于一次性测试。
certbot certonly --manual --preferred-challenges dns -d example.com -d '*.example.com'会分两次提示 TXT 值,两条记录名相同(均为 _acme-challenge.example.com),certbot 明确提示“must be set up in addition to the previous challenges; do not remove, replace, or undo the previous challenge tasks yet”——两条 TXT 必须同时存在,删掉第一条会导致验证失败。该模式无自动续期,certbot 会警告“Certificates created using the manual plugin will not be renewed automatically”。
| 维度 | certbot + dns-cloudflare 插件 | acme.sh(dns_cf) |
|---|---|---|
| 依赖 | Python 插件,需 apt/snap 安装 | 纯 Shell,单文件脚本 |
| 默认 CA | Let’s Encrypt | ZeroSSL(3.0.0 起),需 –server letsencrypt |
| 证书路径 | /etc/letsencrypt/live/<域名>/ | ~/.acme.sh/<域名>[_ecc]/ |
| 续期机制 | systemd timer / cron 调 certbot renew | 安装时自带 cron,–cron 内置 |
两个高频报错。其一,凭据文件权限过宽时 certbot 直接退出:Unsafe permissions on credentials configuration file: /root/.secrets/cloudflare.ini,执行 chmod 600 即可。其二,Token 权限或范围不对时报 Error determining zone_id: 6003 Invalid request headers,多为 Token 缺少 Zone.DNS Edit 或 Zone Resources 未限定到该域名。DNS-01 与 ACME 协议本身的细节见 RFC 8555 第 8.4 节。
免费通配符证书配置怎么写?Nginx、certbot 2.x 与 acme.sh 3.x 命令示例
通配符证书只能走 DNS-01 验证,签发成功后配置层面只做两件事:让 Nginx 指向 fullchain.pem/privkey.pem,并保证续期后自动 reload。下面以 example.com 与 *.example.com 共用一张免费通配符证书为例。
Nginx 最小可用配置:fullchain.pem 已含中间证书,顺序不能反;ssl_session_cache shared:SSL:10m 约缓存 4 万个会话,默认是 none。据 Nginx 官方文档,TLSv1.3 需 nginx 1.13.0+ 且 OpenSSL 1.1.1+。
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 叶证书 + 中间证书
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; # 私钥,权限 600
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_cache shared:SSL:10m;
}
# 改完先语法检查,再平滑重载;不要 restart
nginx -t && systemctl reload nginx
# 成功输出:
# nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
# nginx: configuration file /etc/nginx/nginx.conf test is successful
路径写错时 nginx -t 会直接报 nginx: [emerg] cannot load certificate ... BIO_new_file() failed,此时先检查 live/ 软链接是否指向 archive/。
certbot 2.x 续期配置:Cloudflare 插件应写入 renewal 文件;dns_cloudflare_propagation_seconds 插件默认 10 秒,通配符建议 60 秒,避免 DNS 未生效导致 unauthorized。据 certbot 文档,2.0 起默认密钥类型为 ECDSA P-256。
# /etc/letsencrypt/renewal/example.com.conf
[renewalparams]
authenticator = dns-cloudflare
dns_cloudflare_credentials = /root/.secrets/cloudflare.ini
dns_cloudflare_propagation_seconds = 60
key_type = ecdsa
# 凭证文件必须 600
chmod 600 /root/.secrets/cloudflare.ini
certbot renew --dry-run
# 成功输出含:Congratulations, all simulated renewals succeeded
acme.sh 3.x 安装证书:--ecc 表示使用 ECC 证书(默认 ec-256);不加时 acme.sh 默认 RSA 2048。安装证书时 acme.sh 会写入 cron,每日 00:00 后随机分钟执行,可用 crontab -l | grep acme.sh 核对。
acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.crt
--reloadcmd 'systemctl reload nginx'
| 项目 | certbot 2.x | acme.sh 3.x |
|---|---|---|
| 证书路径 | /etc/letsencrypt/live/example.com/ |
~/.acme.sh/example.com_ecc/ |
| 默认密钥 | ECDSA P-256 | RSA 2048;--ecc 为 ec-256 |
| 续期触发 | systemd timer,每日两次 | cron,每日 00:00 后随机延迟 |
DNS 与 CAA 检查:TXT 记录名必须是 _acme-challenge.example.com,不是 _acme-challenge;返回空是常见失败原因。
dig +short TXT _acme-challenge.example.com @1.1.1.1
# 期望返回带双引号的随机值,例如:"q9X...c1A"
dig CAA example.com +short
# 如需显式允许 Let's Encrypt:
# example.com. CAA 0 issue "letsencrypt.org"
# example.com. CAA 0 issuewild "letsencrypt.org"
据 RFC 8659,CAA 会向父域逐级查找;若已有 issuewild,它优先于 issue 约束通配符,所以两条都要允许 letsencrypt.org。
权限与路径:私钥实际落在 /etc/letsencrypt/archive/example.com/privkey1.pem,权限 600、属主 root;live/ 只是软链接。Nginx master 以 root 读取私钥,worker 以 www-data 运行也无需读私钥。不要把 privkey.pem 复制到 Web 根目录,否则这张免费通配符证书的私钥可能被直接下载。
免费通配符证书方案怎么选?Let's Encrypt、ZeroSSL、Cloudflare Origin CA 与商业证书对比
先给结论:只要站点面向公网,默认答案就是 Let’s Encrypt 免费通配符证书 + DNS-01 自动化;如果流量 100% 经过 Cloudflare 橙云代理,Origin CA 能省掉公网 CA 依赖;只有需要一年有效期、商业发票和 SLA 时,才考虑购买 DV 通配符。
| 方案 | 有效期 | 公开信任 | 通配符 | 验证方式 | 自动化 | 适用场景 |
|---|---|---|---|---|---|---|
| Let’s Encrypt | 90 天 | 是 | 支持 | DNS-01 | certbot / acme.sh | 通用生产、预算敏感 |
| ZeroSSL 免费 | 90 天 | 是 | 支持 | DNS-01 | ACME 客户端 / 面板 | 备用 CA、少量证书 |
| Cloudflare Origin CA | 最长 15 年 | 否,仅 Cloudflare 信任 | 支持 | Cloudflare 面板 | API / 面板 | 仅 Cloudflare 回源 |
| 商业 DV 通配符 | 1 年 | 是 | 支持 | DNS / 文件 | 面板 / API | 需要发票、长周期 |
| 自签证书 | 自定义 | 否 | 支持 | 无 | 手动 | 内网测试 |
价格与硬限制:商业 DV 通配符市场价约 300–1500 元/年;ZeroSSL 免费账户最多持有 3 张 90 天证书,超量需付费;Let’s Encrypt 不按张收费,但有速率限制——据 Let’s Encrypt《Rate Limits》文档,每个注册域名(registered domain)每周最多 50 张证书,重复证书(同一组域名集合)每周 5 张,失败验证每小时 5 次。触限时 ACME 客户端会返回 urn:ietf:params:acme:error:rateLimited,此时应等待或复用已有证书而非重建账户。
为什么通配符几乎只能 DNS-01:据 Let’s Encrypt《Challenge Types》,通配符域名强制使用 DNS-01,因为 HTTP-01 无法证明你对“任意未列出的子域”拥有控制权。这也决定了自动化必须落到 DNS API 上。以 acme.sh 为例(v3.x,DNS 插件通过 --dns 指定):
# Cloudflare API Token 需具备 Zone.DNS:Edit 权限,仅授权目标 zone
export CF_Token="你的_API_Token"
# 同时签发根域与通配符;-d 顺序无关,EC-256 证书体积更小
acme.sh --issue --dns dns_cf
-d example.com -d '*.example.com'
--keylength ec-256
--server letsencrypt # 默认即 Let's Encrypt,可改为 zerossl 做备用 CA
# 安装证书并配置 reload,避免手工拷贝
acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.crt
--reloadcmd "systemctl reload nginx"
DNS 托管商没有 API 怎么办:用 CNAME 委派把验证记录转交给 acme-dns,主域名的 DNS API 权限就不必交给证书工具,这也是最小权限做法:
# 在你的权威 DNS 中添加一次委派,之后所有 TXT 由 acme-dns 动态提供
_acme-challenge.example.com. 300 IN CNAME 8f7e6d5c.acme-dns.io.
# certbot 侧(2.x)走 manual 钩子,或直接用 acme.sh 的 dns_acmedns 插件
certbot certonly --manual --preferred-challenges dns
-d example.com -d '*.example.com'
--manual-auth-hook /etc/letsencrypt/acmedns-auth.sh
合规红线:Cloudflare Origin CA 由 Cloudflare 自建 CA 签发,浏览器和操作系统信任库中不存在该根证书,只能用于 Cloudflare 与源站之间的回源链路。若把 Origin CA 证书直接部署到对外 443 端口,用户会看到 NET::ERR_CERT_AUTHORITY_INVALID(Chrome)或 SSL_ERROR_UNKNOWN_CA_ALERT(Firefox)。判断方法很简单:openssl s_client -connect example.com:443 -servername example.com | openssl x509 -noout -issuer,若签发者是 CloudFlare Origin SSL Certificate Authority,说明证书放错了位置。
免费通配符证书申请常见报错怎么排查?真实错误信息与处理
先别急着改 DNS,把诊断命令跑一遍——90% 的“免费通配符证书”申请失败,靠下面三条查询就能定位到具体环节。据 Let’s Encrypt 官方文档,ACME 校验器是从多个不同网络位置并发查询 DNS 的,所以本地能解析不代表校验器能解析。
# 1) 向公共 DNS 查询挑战记录(绕过本地缓存/内网 DNS)
dig +short TXT _acme-challenge.example.com @8.8.8.8
dig +short TXT _acme-challenge.example.com @1.1.1.1
# 2) 直接问权威 NS,排除递归缓存未过期
dig +short TXT _acme-challenge.example.com @$(dig +short NS example.com | head -1)
# 3) CAA 授权检查(CAA 未命中同样会阻断签发)
dig +short CAA example.com
“DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com”:记录根本不存在。三个高频原因:一是在 Cloudflare/阿里云面板里把主机记录填成了完整域名,最终变成 _acme-challenge.example.com.example.com(正确填法是只填 _acme-challenge);二是记录建在了错误的 Zone(例如给 www.example.com 单独建了 Zone);三是刚提交记录、TTL 未生效。若你用的是 acme-dns 或 CNAME 委托,请确认 _acme-challenge 的 CNAME 目标本身可解析。
“Incorrect TXT record … found …”:解析成功但值不对,通常命中了旧值或同时返回多个值。通配符与裸域一起申请时(-d example.com -d '*.example.com'),_acme-challenge.example.com 必须同时存在两条 TXT,签发完成前一条都不能删——删一条就会让后到的校验拿到残缺集合。手动模式请用 dig +short TXT 确认两条都在,再按回车继续。
“Client with the currently selected authenticator does not support any combination of challenges”:你用 --nginx 或 --apache 去申请 *.example.com。RFC 8555 与 Let’s Encrypt 文档均规定通配符只能用 dns-01,HTTP-01 无法证明通配授权。改用 DNS 插件:
# 需要 certbot-dns-cloudflare 插件;Cloudflare API Token 权限:Zone:DNS:Edit
certbot certonly --dns-cloudflare
--dns-cloudflare-credentials ~/.secrets/cloudflare.ini
--dns-cloudflare-propagation-seconds 30
-d 'example.com' -d '*.example.com'
# 无插件时退回手动模式(注意 --manual 不支持自动续期)
certbot certonly --manual --preferred-challenges dns
-d 'example.com' -d '*.example.com'
“too many certificates already issued for exact set of domains”:命中“相同域名集每周 5 张”的重复证书限制。调试期务必切到 staging,它的配额宽松且不消耗生产配额:
# certbot 2.x 中 --dry-run 默认就走 staging,最省事
certbot certonly --dns-cloudflare ... -d 'example.com' -d '*.example.com' --dry-run
# 或显式指定 ACME 目录,正式签发前务必切回生产 URL
--server https://acme-staging-v02.api.letsencrypt.org/directory
“CAA record for example.com prevents issuance”:按 RFC 8659,CA 必须检查 CAA。放行 Let’s Encrypt 需要两条(issuewild 管通配符,缺省时回落到 issue):CAA 0 issue "letsencrypt.org" 与 CAA 0 issuewild "letsencrypt.org",等 TTL 过后重试。
“nginx: [emerg] cannot load certificate … PEM lib”:多为 ssl_certificate 指错路径、文件为空,或误把 privkey.pem 当证书。注意 /etc/letsencrypt/live/ 下是符号链接,不要复制文件:
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -subject -issuer -dates
openssl rsa -in /etc/letsencrypt/live/example.com/privkey.pem -check -noout
ls -l /etc/letsencrypt/live/example.com/ # 确认链向 ../../archive/... 且非空
nginx -t && systemctl reload nginx
| 报错关键词 | 根因 | 一条命令定位 | 依据 |
|---|---|---|---|
| NXDOMAIN looking up TXT | 记录名拼接错 / Zone 错 / 未同步 | dig +short TXT _acme-challenge.example.com @8.8.8.8 |
RFC 8555 §7.4 |
| Incorrect TXT record | 旧值残留、双域名只留一条 | dig +short TXT _acme-challenge.example.com |
Let’s Encrypt 文档 |
| does not support any combination | 对通配符用了 http-01 | certbot --help dns-cloudflare |
RFC 8555 §7.4.1 |
| too many certificates | 同域名集每周 >5 张 | --dry-run 走 staging |
Let’s Encrypt Rate Limits |
| CAA … prevents issuance | 缺少 issue/issuewild | dig CAA example.com |
RFC 8659 §5.3 |
| cannot load certificate … PEM lib | 路径错 / 空文件 / 证书私钥错位 | openssl x509 -in fullchain.pem -noout -subject |
OpenSSL 手册页 |
排错顺序建议固定为:先 dig 三连确认 DNS 与 CAA,再用 --dry-run 在 staging 验证整条链路,最后才切生产签发。这样“免费通配符证书”的调试成本几乎为零,也不会撞上生产速率限制。
怎么验证免费通配符证书已经生效?服务端、链路与外部工具检查
证书到底有没有装到 443 上?先用一条命令把线上证书抓下来看
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- Wildcard 通配符 SSL 证书安装部署续费申请
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- SSL证书安装服务 · 腾讯云 HTTPS 部署 · 证书过期更新
- HTTPS配置 · SSL证书安装服务(各种服务器)
验证免费通配符证书是否生效,第一步不是看文件,而是看服务端实际握手返回的那张证书——文件正确但 Nginx 加载了旧配置是常见事故。需要 OpenSSL 1.1.1 及以上版本(-ext 参数在该版本引入,Ubuntu 20.04、Debian 11、CentOS 9 自带版本均满足):
# 抓取 SNI=example.com 时服务端返回的叶子证书并解析关键字段
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 期望输出(关键行):
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R11
# notBefore=... notAfter=...
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:*.example.com
判据有三条:SAN 里同时出现 DNS:example.com 与 DNS:*.example.com(通配符只覆盖一级子域,a.b.example.com 不在范围内);issuer 为 Let’s Encrypt 的中间 CA(RSA 证书对应 R10/R11,ECDSA 对应 E5/E6);notAfter 是未来 90 天内的日期——Let’s Encrypt 证书有效期固定 90 天,据 Let’s Encrypt 官方文档,续期应在剩余 30 天时完成。
为什么不能只部署 cert.pem?链验证怎么做?
cert.pem 只有叶子证书,缺少中间 CA 时,Android 旧版本、Java 客户端、部分 IoT 设备会报 unable to get local issuer certificate。正确做法是部署 fullchain.pem,并用系统根证书库做一次完整链路校验(OpenSSL 的 verify 把文件中第一张当叶子、其余当中间证书):
# 1) 确认 fullchain 内含 2 张证书(叶子 + 中间),不是 1 张
grep -c 'BEGIN CERTIFICATE' /etc/letsencrypt/live/example.com/fullchain.pem # 期望 2
# 2) 用系统 CA 库验证链,返回 OK 即信任链完整
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
/etc/letsencrypt/live/example.com/fullchain.pem
# 期望:/etc/letsencrypt/live/example.com/fullchain.pem: OK
# 失败示例:error 20 at 0 depth lookup: unable to get local issuer certificate
该检查对应 RFC 5280 的证书路径验证规则,OpenSSL 文档中 verify 子命令的 -CAfile 即指定信任锚集合。
从 HTTP 客户端看,浏览器会不会报错?
# 只看证书相关行,确认 verify ok 且域名匹配
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate verify|subject:|issuer:|expire date'
# 期望:* SSL certificate verify ok.
# * subject: CN=example.com
# * issuer: C=US; O=Let's Encrypt; CN=R11
# * expire date: ...
若出现 SSL certificate problem: unable to get local issuer certificate,几乎都是漏装中间证书;若出现 no alternative certificate subject name matches target host name,说明签发时漏了该子域的 SAN。再用 curl -sI https://abc.example.com 访问一个通配符子域,可同时验证 *.example.com 是否真的生效。
怎么让监控在到期前 14 天自动报警?
# -checkend 秒数:剩余有效期大于该值返回 0,否则返回非 0(检查文件内第一张证书)
openssl x509 -checkend 1209600 -noout -in /etc/letsencrypt/live/example.com/fullchain.pem
|| echo "ALERT: example.com 证书将在 14 天内过期" | mail -s "TLS 证书告警" ops@example.com
# 未临近过期时输出:Certificate will not expire
1209600 = 14×24×3600 秒。放进 cron 每天跑一次,比依赖 certbot 自己的续期日志更可靠,因为续期成功但 reload 失败同样会导致线上证书过期。
Nginx 侧怎么确认配置与监听都正确?
nginx -t # 必须看到 syntax is ok / test is successful
systemctl reload nginx # reload 而非 restart,避免连接中断
ss -tlnp | grep ':443' # 确认 443 处于 LISTEN 状态
浏览器端按 F12 → Security 面板可直接看到证书链(含中间 CA)、有效期与 TLS 版本,是最贴近真实用户视角的检查。据 Mozilla SSL Configuration Generator,现代配置应只启用 TLS 1.2/1.3 并优先 ECDSA 套件。
外部工具与签发记录怎么核验?
| 检查层面 | 命令 / 工具 | 通过判据 |
|---|---|---|
| 服务端证书内容 | openssl s_client … | openssl x509 |
SAN 含裸域与 *.example.com,issuer 为 LE 中间 CA |
| 信任链 | openssl verify -CAfile … |
返回 OK,fullchain 含 2 张证书 |
| HTTP 客户端 | curl -vI |
SSL certificate verify ok. |
| 到期预警 | openssl x509 -checkend 1209600 |
输出 Certificate will not expire |
| 外部综合评级 | SSL Labs Server Test | Certificate is valid,Chain issues 为 None |
| 签发历史 | crt.sh 查询 %.example.com |
可见每次签发的 CT 日志记录(RFC 6962) |
需要提醒的一点:据 Let’s Encrypt 2024 年底的官方公告,其 OCSP 服务将在 2025 年内停止,新签发的证书不再包含 OCSP URL,吊销状态改由 CRL 承载。因此对 LE 证书而言,OCSP stapling 不再是关键验证项,SSL Labs 报告里 OCSP 相关告警可以忽略,真正要盯的是有效期、SAN 覆盖与链完整性这三项。
免费通配符证书如何自动续期并长期稳定运行?
据 Let’s Encrypt 官方文档,所有证书有效期固定为 90 天,官方建议在剩余 30 天左右续期。certbot 的默认阈值正是 30 天:certbot renew 只会处理”距离到期不足 30 天”的证书,其余直接跳过并输出 Certificate not yet due for renewal。这意味着你每天跑一次 renew 是安全的,不会频繁触发 CA 请求(Let’s Encrypt 对同一组标识符有”每周 5 张重复证书”的速率限制,参见其 Rate Limits 文档)。
先确认调度器是否真的在跑。用包管理器安装的 certbot 会自带 systemd timer,而不是 cron:
# 查看 certbot 定时器状态,正常输出应包含 NEXT 与 LAST 两列
systemctl list-timers | grep certbot
# 典型输出:
# NEXT LEFT LAST PASSED UNIT
# Tue 2025-01-14 03:17:42 UTC 5h 12min Mon 2025-01-13 15:04:11 UTC 7h ago certbot.timer
systemctl cat certbot.timer
# [Timer] 段默认包含:
# OnCalendar=*-*-* 00/12:00:00
# RandomizedDelaySec=12h
# Persistent=true
也就是说它名义上每天运行两次,但带最多 12 小时的随机延迟——这是 Let’s Encrypt 与 certbot 文档共同推荐的”抖动”设计,避免整点全球流量尖峰。若你用的是 cron 而非 systemd,Debian/Ubuntu 的 /etc/cron.d/certbot 默认内容为 0 */12 * * * root test -x /usr/bin/certbot -a ! -d /run/systemd/system && perl -e 'sleep int(rand(43200))' && certbot -q renew。
上线前必须演练一次。--dry-run 会走完整的 ACME 流程(据 RFC 8555 的 staging 环境),但不写入正式证书:
# 1) 纯续期演练,验证 DNS-01 challenge 能否通过
certbot renew --dry-run
# 2) 同时验证 deploy hook 是否可执行(Certbot 2.3.0+ 支持该参数)
certbot renew --dry-run --run-deploy-hooks
# 3) 失败时看日志,challenge 与 DNS 响应都记录在此
tail -n 100 /var/log/letsencrypt/letsencrypt.log
真实报错示例:
Detail: DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com - check that a DNS record exists for this domain。多数情况下不是 DNS 没写,而是 API Token 缺少Zone.DNS Edit、或 DNS 传播尚未完成就被校验(Cloudflare 通常 10-30 秒,可在 hook 里加sleep 30)。
部署钩子:只在续期成功时才 reload。不要把 reload 写进 --pre-hook 或 --post-hook 之外的定时任务里,否则每 12 小时会无意义重载一次:
# 写入 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh,并 chmod +x
#!/bin/sh
# 只有证书真正更新后 certbot 才会调用 deploy hook
nginx -t && systemctl reload nginx || exit 1
acme.sh 用户的默认续期阈值不同:Let’s Encrypt 证书在签发后第 60 天续期(Le_RenewalDays=60,见 acme.sh wiki)。它安装的 cron 是 0 0 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null,脚本内部再随机 sleep 最多 3600 秒:
acme.sh --list # 查看 Main_Domain 与 Next Renew 时间
acme.sh --cron --home /root/.acme.sh # 手动触发一次全部续期
acme.sh --renew -d example.com -d '*.example.com' --force # 强制重签,用于验证配置
| 维度 | certbot | acme.sh |
|---|---|---|
| 默认续期阈值 | 剩余 30 天 | 签发后第 60 天(Le_RenewalDays) |
| 调度方式 | systemd timer 或 cron,每日两次 + 随机延迟 | cron 每日 00:00 + 脚本内随机 sleep |
| 钩子机制 | --deploy-hook / renewal-hooks/deploy/ |
--reloadcmd、--pre-hook/--post-hook |
| 依赖 | Python,官方包源维护 | 纯 Shell,无 Python 依赖 |
最小权限与凭据管理。DNS-01 需要写 TXT 记录,但绝不该给全账户权限。在 Cloudflare 创建 API Token 时只勾选 Zone → DNS → Edit,Zone Resources 选 Include → Specific Zone → example.com;随后:
# 凭据文件仅 root 可读,certbot 的 DNS 插件会自动读取
install -m 600 /dev/null /etc/letsencrypt/cloudflare.ini
printf 'dns_cloudflare_api_token = YOUR_TOKENn' > /etc/letsencrypt/cloudflare.ini
chown root:root /etc/letsencrypt/cloudflare.ini
# .gitignore 中务必包含 *.ini 与 .acme.sh/
建议每 90-180 天轮换一次 Token,并在 CI 里用 gitleaks 之类的扫描防止误提交。
风险边界要说清:*.example.com 的私钥一旦泄露,攻击者可对所有一级子域做中间人攻击(通配符证书不覆盖 a.b.example.com,但覆盖 pay.example.com)。对支付、后台、API 这类敏感子域,业界常见做法是单独签发非通配符证书或拆到独立域名,缩小爆炸半径。私钥文件应为 chmod 600、属主 root(/etc/letsencrypt/live/example.com/privkey.pem 默认即如此),备份时用 tar | gpg -c 或 age 加密,切勿明文进对象存储。
证书本身 0 元,Let's Encrypt 与 ZeroSSL 都不收签发费;成本主要是 DNS API 权限配置、自动续期脚本和监控。若需要 1 年有效期、发票或商业支持,商业 DV 通配符证书约 300-1500 元/年。
可以,把 -d example.com -d '*.example.com' 放在同一次申请中即可生成含两个 SAN 的证书。注意 *.example.com 只覆盖一级子域,不覆盖 a.b.example.com。
优先 Let's Encrypt,ACME 生态与 certbot/acme.sh 文档最完整,速率限制公开;ZeroSSL 免费账户可签 3 张 90 天证书,适合作为备用 CA 或需要面板的场景。两者通配符都必须走 DNS-01。
先用 dig +short TXT _acme-challenge.example.com @1.1.1.1 确认解析;检查记录名是否完整、是否建在正确 Zone、TTL 是否已生效。若使用 CNAME 委派,确认 CNAME 目标返回 TXT 而不是 NXDOMAIN。
不可以。*.example.com 只能通过 DNS-01 证明域名控制权,HTTP-01 无法验证通配符;用 certbot –nginx 申请通配符会直接报 authenticator 不支持。
用 certbot 的 DNS 插件或 acme.sh 的 dns_cf 等 API 模式可以自动续期;certbot –manual 手动模式不会自动续期,90 天后会过期。生产环境应配置 systemd timer 或 acme.sh cron,并加到期监控。
DNS-01 不受小黄云影响,因为验证只看 TXT 记录;HTTP-01 会被 Cloudflare 代理影响,源站文件验证可能失败。使用 Cloudflare API Token 时权限选 Zone.DNS Edit,资源限定到具体 Zone。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。