跳到主要内容
证书选购指南

免费通配符证书申请指南:Let’s Encrypt DNS-01 实操、续期与排错

免费通配符证书 — 免费通配符证书申请指南: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 为例,给出可直接复制的完整序列。

  1. 确认托管商并准备最小权限凭据。在 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 只在创建时显示一次。
  2. 安装客户端。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/
    
  3. 写凭据文件并收紧权限。
    mkdir -p ~/.secrets
    printf 'dns_cloudflare_api_token = 你的Tokenn' > ~/.secrets/cloudflare.ini
    chmod 600 ~/.secrets/cloudflare.ini   # 权限过宽会直接报错,见下方排错
    
  4. 签发(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
    
  5. 签发(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/
    
  6. 手动 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 上?先用一条命令把线上证书抓下来看

验证免费通配符证书是否生效,第一步不是看文件,而是看服务端实际握手返回的那张证书——文件正确但 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。