Let’s Encrypt 证书部署到 CDN/云加速:边缘证书、回源 HTTPS 与自动续期实战
问题背景与根因:CDN 上的 TLS 其实是两段链路
很多站点在源站用 acme.sh 签好了 Let’s Encrypt 证书,浏览器访问却出现证书错误、重定向循环,或者小程序、Java 客户端握手失败。根因通常不是证书本身,而是 CDN 场景下 TLS 被拆成了两段:第一段是“用户浏览器 → CDN 边缘节点”,使用边缘证书;第二段是“CDN 节点 → 源站”,使用回源证书或源站证书。只配好其中一段,另一段仍会报错。
Let’s Encrypt 是免费 DV 证书,有效期固定 90 天,通过 ACME 协议自动签发与续期。公有可信 TLS 证书的传统最长有效期为 398 天,CA/B Forum SC-081 已决定逐步缩短到 200/100/47 天,因此“一次上传管一年”的做法不再可靠。CDN 场景最常见的五类根因是:只上传了叶子证书而非 fullchain,导致中间证书缺失;回源协议选 HTTP,而源站又全站 301 到 HTTPS,形成循环;上传的证书与私钥不匹配;续期后只更新了源站文件,没有同步到 CDN;ACME HTTP-01 验证路径被 CDN 缓存或跳转拦截。
还有一个容易被忽略的限制:Let’s Encrypt 对同一注册域名有速率限制,例如每 7 天约 50 张证书、每 7 天 5 张重复证书、每 3 小时 300 个新订单;验证失败过多会触发 too many failed authorizations recently。因此生产环境应先用 --staging 演练,再正式签发。
前置准备:域名、CAA、ACME 客户端与文件清单
先确认 DNS 与 CAA 不会阻断签发。CAA 记录如果只允许其他 CA,Let’s Encrypt 会直接拒绝。执行:
dig +short A example.com
dig +short CAA example.com
curl -I http://example.com/.well-known/acme-challenge/test
openssl version
如果 CAA 为空或没有 letsencrypt.org,可添加 example.com. 300 IN CAA 0 issue "letsencrypt.org"。CDN 后面做 HTTP-01 经常被缓存、301 或 WAF 拦截,推荐直接用 DNS-01,尤其是通配符证书。安装 acme.sh:
curl https://get.acme.sh | sh -s email=ops@example.com
source ~/.bashrc
acme.sh --version
需要准备的文件只有三类:域名证书 fullchain(叶子证书 + 中间证书)、私钥 key、以及部分云厂商要求的 PFX。fullchain 不是单独一张叶子证书,可用 grep -c 'BEGIN CERTIFICATE' fullchain.cer 检查,正常应大于等于 2。CDN 控制台通常要求 PEM 文本粘贴或上传,PFX 则要求密码。源站建议统一放在 /etc/nginx/ssl/,权限设为 chmod 600,避免私钥泄露。
实操:用 acme.sh 签发可上 CDN 的证书
以阿里云 DNS 为例,先配置 API 凭据,再签发 RSA 或 ECC 证书。若 CDN 只支持 RSA,使用 --keylength 2048;支持 ECC 时用 ec-256 体积更小、握手更快。通配符必须走 DNS-01:
export Ali_Key=your_access_key
export Ali_Secret=your_access_secret
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --keylength ec-256 --server letsencrypt
首次调试可加 --staging,确认 DNS TXT 记录写入成功后去掉。签发完成后检查证书主题、颁发者与有效期:
acme.sh --list
openssl x509 -in ~/.acme.sh/example.com_ecc/fullchain.cer -noout -subject -issuer -dates
openssl x509 -in ~/.acme.sh/example.com_ecc/fullchain.cer -noout -text | grep -A1 'Subject Alternative Name'
把证书安装到固定路径,避免后续脚本引用临时目录:
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 'nginx -t && systemctl reload nginx'
如果云 CDN 只接受 PFX,用 OpenSSL 转换,fullchain 已包含中间证书,不需要再单独指定 chain:
openssl pkcs12 -export -out example.com.pfx
-inkey /etc/nginx/ssl/example.com.key
-in /etc/nginx/ssl/example.com.fullchain.pem
-passout pass:ChangeMe123
实操:CDN 边缘证书与回源 HTTPS 配置
进入 CDN 控制台后,先配边缘证书:阿里云 CDN 在“域名管理 → HTTPS 配置 → 证书管理 → 上传证书”,腾讯云 CDN 在“域名管理 → 高级配置 → HTTPS 配置 → 证书”,粘贴 fullchain 与私钥,或上传 PFX 并填写密码。部分云厂商支持一键申请免费边缘证书,但有效期和自动续期策略由平台控制,长期项目仍建议自有 Let’s Encrypt 证书以便统一管理。
关键第二步是回源配置:回源协议必须选 HTTPS,回源端口 443,回源 Host 与证书 SAN 一致,并开启 SNI。若回源选 HTTP,而源站 Nginx 又配置了全站 return 301 https://...,客户端会反复跳转,浏览器报 ERR_TOO_MANY_REDIRECTS。强制 HTTPS 跳转应只在 CDN 层开启一次,源站不要重复做全站跳转;源站 80 端口只保留 ACME 验证目录即可。
Cloudflare 用户注意:免费版边缘证书由 Cloudflare 托管,不能上传 Let’s Encrypt 作为边缘证书。正确做法是把 Let’s Encrypt 部署在源站,SSL/TLS 模式选 Full (strict),并在 Edge Certificates 中开启 Always Use HTTPS。如果选 Flexible,Cloudflare 到源站走 HTTP,既会跳转循环,也会让源站误判协议。
配置示例:Nginx 源站 + CDN 回源不循环
源站 80 端口不要做全站 301,只保留 ACME 验证路径,其他请求返回 403,强制跳转交给 CDN。443 端口加载 fullchain 与 key,并开启 TLS 1.2/1.3:
server {
listen 80;
server_name example.com;
location ^~ /.well-known/acme-challenge/ { root /var/www/acme; }
location / { return 403; }
}
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1+;旧版用 listen 443 ssl http2;
server_name 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:ECDHE-RSA-CHACHA20-POLY1305';
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/example.com.fullchain.pem;
resolver 223.5.5.5 1.1.1.1 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000' always;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
}
}
改完执行 nginx -t && systemctl reload nginx。如果源站应用依赖 X-Forwarded-Proto 判断 HTTPS,务必固定传 https,避免应用层再次 301。CDN 回源证书如果单独配置,需与源站证书一致或使用云厂商托管回源证书,且回源域名必须能被证书 SAN 覆盖。
对比表格:边缘证书、回源证书、源站证书怎么选
| 项目 | 边缘证书 | 回源证书 | 源站证书 |
|---|---|---|---|
| 作用链路 | 用户浏览器 ↔ CDN 节点 | CDN 节点 ↔ 源站 | 源站直接对外或供回源校验 |
| 验证方 | 浏览器、小程序、Java 客户端 | CDN 回源模块 | CDN 或直连客户端 |
| 常见格式 | PEM fullchain + KEY,或 PFX | 源站证书,CDN 侧选择回源证书 | PEM fullchain + KEY |
| 续期方式 | 控制台手动上传或云厂商自动 | 随源站证书更新 | acme.sh 自动续期 |
| 典型故障 | 链不完整、私钥不匹配 | 525/526、握手失败 | 域名不匹配、证书过期 |
验证方式也要对比:HTTP-01 需要 80 端口可访问,适合源站直连、无 CDN 拦截的站点;DNS-01 通过 TXT 记录验证,支持通配符,最适合 CDN 后面的域名;TLS-ALPN-01 使用 443 端口,部分 CDN 场景不适用。生产上建议 CDN 域名统一用 DNS-01,减少对 80 端口的依赖。
证书类型上,Let’s Encrypt 是 90 天 DV 证书,适合个人站、API、自动化场景;公有可信证书最长有效期传统上为 398 天,但新规正在缩短,因此不要把“398 天”当成免维护理由。边缘证书与源站证书可以是同一张,也可以是不同 CA 签发,只要各自链路域名匹配、链完整即可。
常见错误排查(含真实报错)
1. curl 报证书链错误:curl: (60) SSL certificate problem: unable to get local issuer certificate。说明服务端只返回了叶子证书,缺少中间证书。检查 grep -c 'BEGIN CERTIFICATE' fullchain.pem,应大于等于 2;CDN 上传时也要选 fullchain,而不是 cert.pem。
2. 浏览器报重定向次数过多:ERR_TOO_MANY_REDIRECTS。把 CDN 回源协议改为 HTTPS,并删除源站 80 端口的全站 301,只保留 ACME 路径;Cloudflare 模式改为 Full (strict)。
3. Nginx 启动报私钥不匹配:nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。用公钥指纹核对:
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -pubout -in example.com.key | openssl md5
两个 md5 必须一致;RSA 证书也可用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 对比。
4. CDN 返回 525/526:525 SSL Handshake Failed 多为源站 443 不通、SNI 未开或协议不匹配;526 Invalid SSL Certificate 多为源站证书过期、自签名或域名不匹配。用 openssl s_client -connect 源站IP:443 -servername example.com 从 CDN 侧网络验证。
5. ACME 验证失败:Invalid response from http://example.com/.well-known/acme-challenge/...: 301,说明 CDN 把验证路径跳转或缓存了。改用 DNS-01,或为 /.well-known/acme-challenge/ 配置不缓存、不跳转。出现 too many failed authorizations recently 时等待 1 小时再试。
续期自动化与效果验证
acme.sh 安装后会自动写入 cron,可用 crontab -l | grep acme 确认。续期后必须让 CDN 拿到新证书:本地 Nginx 用 reloadcmd 重载,CDN 则要在 reloadcmd 中调用云 API 或同步脚本。示例:
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 '/usr/local/bin/sync-cdn-cert.sh && nginx -t && systemctl reload nginx'
acme.sh --cron --home ~/.acme.sh
sync-cdn-cert.sh 负责调用云厂商证书上传接口,把新 fullchain 和 key 更新到边缘证书与回源证书。没有 API 脚本时,至少要在证书到期前 30 天手动重传,并确认控制台证书 ID 已切换。
验证分三层:第一层看边缘证书,curl -Iv https://example.com 2>&1 | grep -E 'subject:|issuer:|SSL certificate verify',应显示 SSL certificate verify ok;第二层看链,openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates;第三层看跳转与评级,curl -sI http://example.com | head -n 3 应返回 301 到 HTTPS,再用 SSL Labs API 检查:
curl 'https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off&all=done'
最后用手机 4G、微信小程序开发者工具和 Java HttpClient 各访问一次,确认没有 Trust anchor for certification path not found。只有边缘证书、回源证书、源站证书三段都验证通过,才算真正部署完成。
常见问题
多数云 CDN(阿里云、腾讯云)支持上传自定义证书,可把 fullchain 与私钥上传为边缘证书;Cloudflare 免费版边缘证书由平台托管,不能上传 Let’s Encrypt,应把 Let’s Encrypt 部署在源站并选 Full (strict)。
选 HTTPS。若源站已全站 301 到 HTTPS,而 CDN 用 HTTP 回源,客户端会反复跳转,出现 ERR_TOO_MANY_REDIRECTS;回源 HTTPS 并要求源站证书域名匹配、链完整,Cloudflare 选 Full (strict)。
通常是没有上传完整证书链。CDN 边缘证书和源站证书都要用 fullchain(叶子证书加中间证书),不要只传叶子证书;可用 openssl s_client -showcerts 检查链,Java 报 Trust anchor for certification path not found 即此问题。
acme.sh 续期只更新本地文件,不会自动改 CDN。需在 –reloadcmd 中调用云 API 上传新证书,或手动在控制台重新上传;同时确认 CDN 回源证书与边缘证书都已更新,最后用 curl -Iv 和 SSL Labs 验证。
是。Let’s Encrypt 的通配符证书只支持 DNS-01 验证,HTTP-01 不能签发 *.example.com;在 acme.sh 中配置 dns_ali、dns_cf 等 API 凭据后执行 –issue –dns dns_ali -d example.com -d ‘*.example.com’。
398 天是公有可信 TLS 证书的传统最长有效期上限,且 CA/B Forum 正逐步缩短;Let’s Encrypt 是 DV 证书,固定 90 天,建议用 acme.sh 自动续期并在 CDN 侧同步,不要手动囤证书。