Let’s Encrypt 证书部署到 CDN / 云加速:边缘证书、回源 HTTPS 与自动续期全流程
问题背景与根因:CDN 上的 Let’s Encrypt 为什么总在“续期”这一步翻车
CDN / 云加速场景下的 HTTPS 不是一条链路,而是两条:用户 ↔ CDN 边缘节点(由边缘证书保护)与 CDN 节点 ↔ 源站(由回源协议与回源证书保护)。很多教程只讲“上传证书”这一步,于是出现典型现象:配置当天一切正常,90 天后浏览器报证书过期,而源站上的证书明明是新的。
根因有三个:
- 边缘证书是“快照”,不会自动更新。Let’s Encrypt 证书有效期 90 天,acme.sh / certbot 会在到期前 30 天自动续期,但续期只更新源站磁盘上的文件;CDN 边缘节点保存的是你当初上传的那份 PEM,不会自动跟随。除非使用云厂商的“托管证书 / 免费证书”并开启自动续期,否则必须自己写推送脚本。
- 证书链不完整。只上传叶子证书(cert.pem / .cer),边缘节点就不会下发中间证书。浏览器可以依靠 AIA 补链“侥幸”通过,但 Java、旧版 Android、微信小程序以及 curl(OpenSSL 1.1+ 严格校验)会直接失败。
- 回源链路配错。回源协议选 HTTP,而源站又开了 301 强制跳转,就会形成
ERR_TOO_MANY_REDIRECTS;回源不带 SNI,源站会返回默认站点的证书,触发域名不匹配。
还有一个必须纠正的过时认知:公有 TLS 证书最长有效期目前是 398 天(CA/Browser Forum 规定,2020 年 9 月生效),并已确定分阶段缩短:2026 年 3 月起 200 天、2027 年 3 月起 100 天、2029 年 3 月起 47 天。Let’s Encrypt 一直是 90 天,2025 年起还提供 6 天有效期的短期证书选项。也就是说,“配一次管一年”已经彻底失效,自动续期与自动推送是唯一可持续的方案。
准备证书文件:cert、chain、fullchain 到底该传哪一个
acme.sh 签发完成后,证书文件位于 ~/.acme.sh/example.com_ecc/ 目录下;certbot 位于 /etc/letsencrypt/live/example.com/。两者结构一致:
| 文件 | 内容 | 能否直接上传 CDN |
|---|---|---|
| cert.pem / example.com.cer | 仅服务器(叶子)证书 | 否,缺少中间证书 |
| chain.pem / ca.cer | 中间证书 | 否,单独使用无意义 |
| fullchain.pem / fullchain.cer | 叶子证书 + 中间证书(顺序敏感) | 是,上传这个 |
| privkey.pem / example.com.key | 私钥(RSA 2048 或 ECDSA P-256) | 是,与 fullchain 配对 |
上传规则只有一条:证书栏粘贴 fullchain,私钥栏粘贴 privkey,且两者必须来自同一次签发。根证书(ISRG Root X1/X2)通常不要放进去,多数云厂商会自动补全;个别平台要求包含根证书时,以其文档为准。
上传前先自检三件事:
# 1) 确认 fullchain 是“叶子 + 中间”两段,顺序不能反
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
# 2) 确认私钥没有口令(带口令的平台导入会失败)
head -1 privkey.pem
# 3) 确认证书与私钥配对
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in privkey.pem | openssl md5
# ECDSA 证书用这组
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -pubout -in privkey.pem | openssl md5
若平台只接受 PFX(部分传统云加速或 IIS 源站),转换命令如下:
openssl pkcs12 -export -out example.pfx
-inkey privkey.pem -in fullchain.pem -passout pass:
推荐使用 ECDSA P-256(--keylength ec-256):握手更快、证书体积更小,TLS 1.2/1.3 下主流客户端均支持。若业务仍需兼容极老的 Android 4.x 设备,再退回 RSA 2048。
实操一:acme.sh 签发、安装与续期钩子
以下命令可直接执行(以 CentOS / Ubuntu + Nginx 为例):
# 安装并设置默认 CA
curl https://get.acme.sh | sh -s email=ops@example.com
source ~/.bashrc
acme.sh --set-default-ca --server letsencrypt
# 用 webroot 方式签发,多域名就多个 -d
acme.sh --issue -d example.com -d www.example.com
--webroot /var/www/letsencrypt
--keylength ec-256
webroot 目录需要由 Nginx 暴露出来,否则验证会失败:
location ^~ /.well-known/acme-challenge/ {
root /var/www/letsencrypt;
default_type text/plain;
}
签发成功后不要直接引用 ~/.acme.sh 里的文件,用 --install-cert 复制到固定路径,并把“推送 CDN”挂到 --reloadcmd 上——这是整套方案的核心,acme.sh 每次续期成功后都会执行这条命令:
mkdir -p /etc/nginx/ssl
acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.fullchain.pem
--reloadcmd "systemctl reload nginx && /usr/local/bin/sync-cdn-cert.sh"
几个容易踩的参数细节:
--ecc必须与签发时的--keylength ec-256对应,否则 install-cert 找不到证书。- acme.sh 默认在到期前 30 天续期,可用
--days 30调整;不建议压到 7 天以内,CDN 推送与节点生效需要时间。 - cron 任务由安装脚本自动写入(
crontab -l | grep acme.sh可查),若被安全策略清理,续期会静默失败。 - 不要用
--force反复重签,Let’s Encrypt 对同一组域名有每周 5 次重复证书的限制(Duplicate Certificate Limit)。
同步脚本 /usr/local/bin/sync-cdn-cert.sh 的职责是:读取 /etc/nginx/ssl/ 下的 fullchain 与 key,调用云厂商 API 更新边缘证书;失败时返回非 0 退出码,让 acme.sh 日志留下记录,便于监控告警。
实操二:CDN 边缘证书上传与回源 HTTPS 配置
控制台路径基本一致:CDN 控制台 → 域名管理 → 选择加速域名 → HTTPS 配置。
- 开启 HTTPS。证书来源选“自有证书 / 上传证书”,证书内容粘贴
fullchain.pem全文(含 BEGIN CERTIFICATE 到 END CERTIFICATE 全部段落),私钥粘贴privkey.pem。若平台提供“免费证书 / 托管证书”,优先选它——由平台自动申请与续期,可彻底规避“续期后忘上传”。 - 回源配置 → 回源协议选 HTTPS(端口 443)。这是最关键的一步:选 HTTP 而源站又开了强制跳转,就会无限重定向。
- 回源 HOST 与回源 SNI 都设置为源站业务域名(如
origin.example.com),且该域名必须在证书 SAN 列表里。若只填 IP 或不带 SNI,源站会命中default_server,返回的证书域名不符。 - 强制 HTTPS 跳转只在 CDN 层开启,源站 Nginx 不要再写
return 301 https://$host$request_uri;,否则回源请求被再次 301,形成循环。 - 回源证书校验:源站用 Let’s Encrypt 公有证书时选“校验”;用自签证书时选“不校验”或上传自定义 CA,否则边缘节点会报 526。
用 API 做自动化推送(以阿里云 CDN 与腾讯云 SSL 为例,参数名以各版本 CLI 文档为准):
# 阿里云:直接设置域名证书
aliyun cdn SetDomainServerCertificate --DomainName static.example.com
--ServerCertificateStatus on --CertType upload --SSLProtocol on
--ServerCertificate "$(cat /etc/nginx/ssl/example.com.fullchain.pem)"
--PrivateKey "$(cat /etc/nginx/ssl/example.com.key)"
# 腾讯云:先上传证书拿到 CertId,再绑定到加速域名
tccli ssl UploadCertificate
--CertificatePublicKey "$(cat /etc/nginx/ssl/example.com.fullchain.pem)"
--CertificatePrivateKey "$(cat /etc/nginx/ssl/example.com.key)"
--Alias "cdn-example-$(date +%F)"
注意 API 对证书与私钥字段通常有大小限制(单字段 64KB 以内),PEM 直接传即可;私钥换行丢失是高频失败原因,部分 CLI 需要 --PrivateKey "$(cat key.pem | tr -d '\n')"。推送完成后边缘节点一般 1~5 分钟生效,可用下一节的 --resolve 方式验证具体节点。
配置示例:源站 Nginx 与真实 IP 还原
server {
listen 443 ssl;
http2 on;
server_name origin.example.com;
ssl_certificate /etc/nginx/ssl/example.com.fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/example.com.fullchain.pem;
resolver 223.5.5.5 119.29.29.29 valid=300s;
# 只允许 CDN 回源网段访问
allow 10.0.0.0/8;
deny all;
set_real_ip_from 10.0.0.0/8;
real_ip_header X-Forwarded-For;
real_ip_recursive on;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto https;
}
}
要点说明:ssl_trusted_certificate 指向 fullchain 才能让 OCSP Stapling 生效,减少客户端额外请求;ssl_session_tickets off 避免会话票据在 CDN 多节点场景下被跨节点复用。X-Forwarded-Proto 必须显式设为 https,否则后端应用会误判协议,生成 http 链接造成混合内容告警。
如果源站同时对外直连(不经过 CDN),建议为直连单独建一个 server 块,或直接关闭 443 的公网入站、只保留 CDN 回源网段,减少证书暴露面与扫描噪音。修改后执行 nginx -t && systemctl reload nginx,reload 而非 restart,避免连接中断。
对比表格:三类证书与有效期规则
先把“三张证书”的角色分清楚,排查时才不会张冠李戴:
| 维度 | 边缘证书 | 回源证书(校验用) | 源站证书 |
|---|---|---|---|
| 保护链路 | 用户 ↔ CDN 节点 | CDN 节点 ↔ 源站 | 源站自身(含直连) |
| 存放位置 | CDN 平台 | CDN 平台(CA 或“不校验”) | 源站 /etc/nginx/ssl |
| 常见签发者 | Let’s Encrypt 或云厂商免费 DV | 与源站证书一致 | Let’s Encrypt |
| 续期方式 | 手动上传或平台托管自动 | 跟随源站证书 | acme.sh + reloadcmd |
| 典型故障 | 续期后未重新上传 | 自签证书导致 526 | 链不完整导致 60 错误 |
再对齐有效期规则,避免被旧教程误导:
| 时间节点 | 公有 TLS 证书最长有效期 | 说明 |
|---|---|---|
| 2020-09 起 | 398 天 | CA/B Forum SC-17 生效,取代此前的 825 天 |
| 2026-03 起 | 200 天 | 分阶段缩短的第一阶段 |
| 2027-03 起 | 100 天 | 自动化续期成为硬性要求 |
| 2029-03 起 | 47 天 | 接近 ACME 短期证书的节奏 |
| Let’s Encrypt | 90 天(另有 6 天短期证书) | 到期前 30 天自动续期 |
结论:无论用哪家 CA,“人工记得续”都不再可行。CDN 场景必须做到 acme.sh 续期 → reload 源站 → API 推送边缘证书 → 告警兜底 四步闭环,任何一环缺失,都会在某个 90 天周期的末尾集中爆发。
常见错误排查(真实报错对照)
| 报错 | 根因 | 修复 |
|---|---|---|
curl: (60) SSL certificate problem: unable to get local issuer certificate |
边缘或源站只下发了叶子证书,缺中间证书 | 上传 fullchain.pem,用 crl2pkcs7 确认含 2 段 |
curl: (51) SSL: no alternative certificate subject name matches target host name |
证书 SAN 不含当前域名,或回源 SNI 命中默认站点 | 重签时补 -d 域名;回源 SNI 设为业务域名 |
ERR_TOO_MANY_REDIRECTS |
回源协议 HTTP + 源站 301 强制跳转 | 回源改 HTTPS,或删掉源站的 301 |
nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) |
证书与私钥不是同一次签发 | 用 modulus / pubkey 比对 md5,重新 install-cert |
525 SSL handshake failed(Cloudflare 类) |
回源 443 不通,或源站只支持 TLS 1.0 而边缘要求 1.2+ | 检查安全组与 ssl_protocols,用 openssl s_client 直连源站 IP 验证 |
526 Invalid SSL certificate |
源站证书过期或为自签 | 更新源站证书,或回源校验改为“不校验” |
Verify error:Invalid response from http://example.com/.well-known/acme-challenge/xxx |
webroot 路径、权限不对,或 CDN 拦截了验证请求 | 确认 location 生效,签发期间该路径不缓存、不经 CDN |
配对检查的具体命令(报 key values mismatch 时逐条执行):
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# ECDSA 证书用这组
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -pubout -in example.com.key | openssl md5
另一个高频坑:ACME 验证请求走 CDN 时被缓存或 WAF 拦截,导致续期失败。签发期间应把 /.well-known/acme-challenge/ 加入 CDN 的“不缓存”规则并放行 WAF,或者让验证流量绕过 CDN 直达源站(DNS 层面单独加一条 A 记录)。
效果验证:curl、openssl 与多节点抽检
# 1) 看边缘节点下发的证书主题、签发者与校验结果
curl -sSv https://example.com -o /dev/null 2>&1 | grep -E "subject:|issuer:|SSL certificate verify|TLSv"
# 2) 看有效期与 SAN
(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null)
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 3) 一行拿到状态码与校验结果(verify=0 表示通过)
curl -o /dev/null -s -w "http=%{http_code} verify=%{ssl_verify_result} tls=%{time_appconnect}n" https://example.com
# 4) 抽检指定 CDN 节点,确认不是只有本地 DNS 解析到的那台更新了
curl -s --resolve example.com:443:203.0.113.10 https://example.com -o /dev/null -w "%{http_code}n"
# 5) 单独验证回源链路(带 SNI,模拟 CDN 回源)
openssl s_client -connect origin.example.com:443 -servername origin.example.com -tls1_2
剩余有效期可以做成监控指标,低于 20 天即告警:
end=$( (echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null)
| openssl x509 -noout -enddate | cut -d= -f2)
echo "剩余 $(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 )) 天"
最后做两件事:一是用 SSL Labs(https://www.ssllabs.com/ssltest/analyze.html?d=example.com)测边缘节点,目标 A 及以上,重点看是否提示 “Certificate chain is incomplete” 以及 TLS 1.0/1.1 是否已关闭;二是对源站 IP 单独跑一次同样的测试,避免只测了 CDN、漏掉回源链路。若站点有小程序或 App 端,务必用 curl 而非浏览器复测——浏览器有 AIA 补链机制,会掩盖证书链缺失的问题。
常见问题
可以。CDN 只认标准 PEM 格式,把 fullchain.pem 与私钥上传到边缘证书即可。但 CDN 不会自动跟随 acme.sh 续期,必须通过 API 推送或改用平台托管证书,否则 90 天后必然过期。
cert.pem 只含叶子证书,缺少中间证书,边缘节点无法下发完整信任链。浏览器可依靠 AIA 补链通过,但 curl、Java、旧版 Android、微信小程序会报 unable to get local issuer certificate。用 crl2pkcs7 可确认是否含两段。
说明续期只更新了源站文件,未同步到边缘节点。把推送脚本挂到 acme.sh 的 –reloadcmd 上,或改用云厂商托管证书。推送后边缘节点一般 1~5 分钟生效,可用 curl –resolve 指定节点 IP 复验。
不是强制,但强烈建议。若选 HTTP 而源站配置了 301 强制跳转,会形成无限重定向(ERR_TOO_MANY_REDIRECTS);选 HTTP 还意味着 CDN 到源站这段明文传输。正确做法是回源 HTTPS,跳转只在 CDN 层做一次。
能,但要把回源证书校验改为“不校验”或上传自定义 CA,否则边缘节点会返回 526 Invalid SSL certificate。生产环境更推荐源站也使用 Let’s Encrypt 公有证书并开启校验,安全性更高。
398 天是 CA/Browser Forum 规定的公有 TLS 证书有效期上限(2020 年 9 月起),并将于 2026 年 3 月缩至 200 天、2027 年 3 月缩至 100 天、2029 年 3 月缩至 47 天。Let’s Encrypt 自身固定 90 天,需自动续期。