跳到主要内容
安装配置教程

Cloudflare SSL 配置全流程:加密模式选型、源站证书与 526 报错排查

cloudflare ssl 配置 — Cloudflare SSL 配置全流程:加密模式选型、源站证书与 526 报错排查
核心结论

Cloudflare SSL 配置的正确做法是:SSL/TLS 加密模式设为 Full (strict),源站部署有效证书(Let's Encrypt 90 天或 Cloudflare Origin CA 最长 5475 天),并开启 Always Use HTTPS 与 Authenticated Origin Pulls,使边缘到源站全程 TLS 加密且不触发 526。 Cloudflare 免费版 Universal SSL 由 Let's Encrypt / Google Trust Services 交叉签名,有效期约 90 天自动续期,NS 生效后通常 15 分钟至 24 小时完成签发。 新接入域名默认的 Flexible 模式让 Cloudflare 到源站走 80 端口明文回源,是 526、ERR_TOO_MANY_REDIRECTS 与“假 HTTPS”的主要来源,生产环境应避免使用。 一条命令验证边缘证书:openssl s_client -connect example.com:443 -servername example.com -tls1_2 /dev/null | openssl x509 -noout -issuer -dates。 可用 API 批量修改 Cloudflare SSL 配置:PATCH /client/v4/zones/{zone_id}/settings/ssl,value 取值 off / flexible / full / strict,返回 result.value 即当前生效值。

为什么 Cloudflare SSL 配置总是卡在 525、526 和重定向循环?

为什么证书显示”Active”,网站还是 526?因为 Cloudflare 的 TLS 从来不是一条链路,而是两条彼此独立的链路:访客 ↔ Cloudflare 边缘,以及 Cloudflare 边缘 ↔ 你的源站。前者由 Universal SSL(免费版)或 Advanced Certificate Manager 签发的边缘证书保障,免费版证书由 Let’s Encrypt 与 Google Trust Services 交叉签名、有效期约 90 天并自动续期;后者完全由 SSL/TLS → Overview 里的加密模式决定。任意一段没配好,浏览器侧都只会看到一个笼统的 5xx 或重定向异常——这正是 cloudflare ssl 配置最容易踩坑的地方。

浏览器现象 失败环节 典型根因 快速验证
ERR_TOO_MANY_REDIRECTS 边缘↔源站(明文回源) Flexible 下源站读到 scheme=http,程序再次 301 到 https curl -sI 看源站 Location 是否跳 https
525 SSL handshake failed 边缘↔源站 TLS 握手 源站只监听 80、443 被防火墙限源、仅支持 TLS 1.0/1.1 openssl s_client -tls1_2 直连源站
526 Invalid SSL certificate 边缘↔源站证书校验 自签名、已过期、缺中间证书、SNI 主机名不匹配 看 Verify return code
522 Connection timed out 边缘↔源站 TCP 源站防火墙丢包或未放行 Cloudflare IP 段 nc -vz 源站IP 443

为什么新域名一接入就陷入重定向循环?因为新 zone 的加密模式默认是 Flexible。据 Cloudflare 官方文档,Flexible 下边缘到源站走 HTTP 80 端口明文回源,源站读到的 $_SERVER['HTTPS'] 永远是空、X-Forwarded-Proto 永远是 http。WordPress、ThinkPHP 等程序据此判断”当前不是 HTTPS”,于是再发一次 301 到 https,形成死循环;若源站自身强制 HTTPS,则直接返回 526。所以只要源站装了证书,就应切到 Full (strict),而不是靠插件”信任代理头”打补丁。

Universal SSL 为什么一直停在 Pending Validation?签发有硬性前提:域名 NS 必须已改为 Cloudflare 分配的两个 NS 且 zone 状态为 Active;DCV 走 HTTP-01 或 TXT 验证,正常生效时间 15 分钟到 24 小时。若域名配了 CAA 记录,必须放行三家 CA,否则签发直接失败——这是 Let’s Encrypt 文档明确规定的行为。

# 检查 CAA 是否放行了 Cloudflare 的签发 CA(三者至少其一)
dig +short CAA example.com
# 正确示例:
# example.com. 300 IN CAA 0 issue "letsencrypt.org"
# example.com. 300 IN CAA 0 issue "pki.goog"
# example.com. 300 IN CAA 0 issue "digicert.com"

526 到底在校验什么?Full (strict) 下 Cloudflare 按 RFC 5280 校验证书链完整性、有效期与 SNI 主机名匹配,任一不满足即返回 526,并在响应头 cf-ray 留下可追踪 ID。注意 -servername 必须写你回源的真实主机名,否则测出来的结论是假的。

# 以 Full (strict) 的规则模拟校验源站证书链
openssl s_client -connect 203.0.113.10:443 -servername www.example.com -showcerts </dev/null 2>&1 
  | grep -E 'Verify return code|subject=|issuer='
# 期望:Verify return code: 0 (ok)
# 20 (unable to get local issuer certificate) → 缺中间证书,Full (strict) 必报 526
# 10 (certificate has expired)               → 证书过期,需续签或换用 Cloudflare Origin CA

525 和 526 差在哪?525 表示 TCP 已连通、但 TLS 握手阶段失败;526 表示握手成功、但证书不被信任。前者常见于源站只开 80、443 被安全组限制为仅放行特定 IP,或源站只支持 TLS 1.0/1.1。Cloudflare 自 2023 年起对全部套餐默认最低 TLS 1.2(SSL/TLS → Edge Certificates → Minimum TLS Version,可选 1.0–1.3),老源站必须同步升级 OpenSSL 与 cipher suite,否则握手直接被拒。

# 判断 525 是否为协议版本问题
openssl s_client -connect 203.0.113.10:443 -servername www.example.com -tls1_2 </dev/null
# 输出 handshake failure / no protocols available → 源站不支持 TLS 1.2,需升级(TLS 1.3 见 RFC 8446)
# 输出 connection refused / timeout         → 443 未监听或被 ACL 拦截,属 521/522 范畴而非证书问题

排查顺序建议固定为三步:先看响应头 cf-ray 与状态码确定失败段,再用 openssl s_client 从源站视角复现握手,最后才动加密模式——把模式当成万能开关反复切换,只会把 525 换成重定向循环。

Cloudflare SSL 配置的完整实操步骤(6 步走完)

顺序摆正比参数调优更重要:边缘证书还没就绪就去改源站,是 526 排查里最常见的“自伤”动作——两个故障点叠在一起,日志互相干扰。下面 6 步按依赖顺序排列,每步都给出可验证的检查点,走完再做链路验证。

第 1 步:确认边缘证书就绪。Dashboard → 选择域名 → SSL/TLS → Edge Certificates,Universal SSL 状态必须是 Active,且证书同时覆盖 example.com 与 *.example.com。若仍是 Pending,先查 NS 是否已全量接管、CAA 记录是否放行签发 CA(Cloudflare 通用证书由多家 CA 轮换签发,CAA 写死单一 CA 会导致签发失败)。据 Cloudflare 文档,Pending 阶段继续往下改配置,会让后续报错失去归因价值。

# 适用:任意装有 dig 的 Linux/macOS;确认接管与 CAA 放行
dig +short NS example.com          # 应返回 *.ns.cloudflare.com
dig +short CAA example.com         # 为空或包含 digicert.com / letsencrypt.org 等

第 2 步:源站先装好证书。两种主流方案对比如下,选型取决于你是否需要浏览器直连源站。

源站证书方案 有效期 浏览器直连源站 续期方式
Cloudflare Origin CA 7–5475 天可选(面板内选择) 不受公共信任,出现告警页 到期前手动重签并替换
Let’s Encrypt + certbot 90 天(官方建议 60 天起续) 受信任 certbot renew + deploy-hook 自动重载
# 适用:certbot 2.x + Nginx(Ubuntu 22.04/Debian 12)
sudo certbot --nginx -d example.com -d www.example.com 
  --deploy-hook "systemctl reload nginx"   # 续期成功后自动重载,避免加载旧证书
sudo certbot renew --dry-run               # 演练续期,确认 hook 无报错
server {
    listen 443 ssl;
    server_name example.com www.example.com;

    # 关键:必须用 fullchain.pem。只配 cert.pem 会缺中间证书,
    # Cloudflare 回源校验证书链失败,直接返回 526 Invalid SSL certificate
    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
}

第 3 步:设置加密模式。SSL/TLS → Overview 选 Full (strict)。四种模式的实际差异见下表——注意 Full 只加密、不校验证书有效性,等于把中间人风险留在回源链路上。

模式 边缘→源站 校验源站证书 适用与风险
Off HTTP — 不推荐,回源明文
Flexible HTTP/80 否 仅老旧虚拟主机无法装证书时临时使用;必须关闭源站自身的 HTTPS 强制跳转,否则无限重定向
Full HTTPS 否 源站只能用自签证书时的过渡态
Full (strict) HTTPS 是(有效期、域名、证书链) 生产默认,配合 Origin CA 或 LE 证书

第 4 步:开启 Always Use HTTPS 并清掉源站重复跳转。Edge Certificates → Always Use HTTPS 设为 On,跳转由边缘返回 301 并带 cf-ray 头。同时删除 Nginx 里针对 Cloudflare 回源的 return 301 https://$host$request_uri;,否则同一请求被跳两次,日志里出现成对 301 且难以判断来源。

# 验证跳转由边缘完成:Location 应指向 https,且响应含 cf-ray
curl -sI http://example.com | grep -iE '^HTTP/|^location:|^cf-ray:'

第 5 步:开启 Authenticated Origin Pulls 防止绕过。SSL/TLS → Origin Server → Authenticated Origin Pulls 设为 On,源站只接受携带 Cloudflare 客户端证书的回源请求,攻击者扫到源站 IP 也连不上。该 CA 证书在 2024 年轮换过,务必从官方地址现取,不要粘贴旧教程内容。

# 适用:Nginx 1.20+;下载 Cloudflare 回源客户端 CA 证书
sudo mkdir -p /etc/nginx/certs
sudo curl -o /etc/nginx/certs/cloudflare.crt 
  https://developers.cloudflare.com/ssl/static/authenticated_origin_pull_ca.pem
# 在 server{} 或 http{} 中加入:
#   ssl_client_certificate /etc/nginx/certs/cloudflare.crt;
#   ssl_verify_client on;
sudo nginx -t && sudo systemctl reload nginx

# 验证:绕过 Cloudflare 直连源站 IP 应被拒
curl -k -sI https://ORIGIN_IP/   # 预期 400 + "No required SSL certificate was sent"

第 6 步:收敛 TLS 参数与 HSTS。Edge Certificates → Minimum TLS Version 设为 1.2,TLS 1.3 保持 On。面板默认最低版本随账户创建时间不同(可能是 1.0 或 1.2),必须手动确认而不是假定。HSTS 先设 max-age=15552000; includeSubDomains(即 180 天,依据 RFC 6797);preload 建议观察 2–4 周,确认所有子域都有可用 HTTPS 服务后再提交——preload 列表的移除周期以月计,且浏览器内置列表更新滞后。完成后再按下一节的命令分别验证“浏览器↔边缘”和“边缘↔源站”两段链路,避免只看一段就判定 cloudflare ssl 配置成功。

Cloudflare SSL 配置的命令与配置片段示例

边缘证书签给了谁、还剩多少天?不要登源站看,直接在客户端侧拉边缘证书——这是排查 Cloudflare SSL 配置时成本最低的一步。据 Cloudflare 文档,Universal SSL 由 Let’s Encrypt 与 Google Trust Services 交替签发,所以 issuer 出现这两家之一才是正常的:

# -servername 必须写,否则拿到的是 Cloudflare 默认 SNI 证书;-tls1_2 固定协议避免 TLS1.3 下 session 输出干扰
openssl s_client -connect example.com:443 -servername example.com -tls1_2 /dev/null 
  | openssl x509 -noout -issuer -subject -dates
# 期望输出:
# issuer=C = US, O = Let's Encrypt, CN = E5
# subject=CN = example.com
# notBefore=Jan 12 00:00:00 2025 GMT
# notAfter=Apr 12 23:59:59 2025 GMT

notAfter 距当前约 60–90 天属于健康区间;若只剩几天,说明边缘证书自动续期被卡(常见于 CAA 记录只放行了单一 CA,或域名处于 Pending Validation)。

源站证书链不全导致 526,怎么定位?526 的定义是”Cloudflare 无法验证源站证书”,绝大多数不是证书过期而是缺中间证书。用 -showcerts 把整条链打出来:

openssl s_client -connect 203.0.113.10:443 -servername example.com -showcerts </dev/null
# 报错样例:
# verify error:num=21:unable to verify the first certificate
# Verify return code: 21 (unable to verify the first certificate)

修复方式是把 intermediate 追加进 fullchain.pem(顺序:站点证书 → 中间证书,根证书不要放),然后热加载:

cat example.com.crt intermediate.crt > /etc/nginx/ssl/fullchain.pem
nginx -t && systemctl reload nginx   # reload 不断连接,比 restart 安全
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted intermediate.crt example.com.crt

如何用 API 批量修改 Cloudflare SSL 配置?ssl 属于 zone 级 setting,PATCH 一次只改一个 zone,脚本里遍历 zone id 即可:

curl -X PATCH "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/settings/ssl" 
  -H "Authorization: Bearer $CF_API_TOKEN" 
  -H "Content-Type: application/json" 
  --data '{"value":"strict"}'
# 返回体 result.value 即当前生效值;value 取值:off | flexible | full | strict
API value 边缘→源站协议 校验源站证书 典型故障
off HTTP 明文 否 混合内容告警
flexible(新建 zone 默认) HTTP 80 否 源站 301 到 HTTPS 造成重定向循环
full HTTPS 443 否(接受自签名/过期) 不报错但存在中间人风险
strict HTTPS 443 是,须公共 CA 或 Origin CA 526 / 525

API Token 建议只授予 Zone Settings:Edit 与 SSL and Certificates:Edit,别用 Global API Key——后者等于账号全权限。

自签源站证书一定要买吗?不用,Cloudflare Origin CA 免费且最长 15 年。据 Cloudflare 文档,私钥由你自己生成、Cloudflare 只回签证书,所以 CSR 必须提前备好:

# 1) 本地生成私钥与 CSR(ECC 更快,需 request_type 用 origin-ecc)
openssl req -new -newkey rsa:2048 -nodes -keyout origin.key -out origin.csr -subj "/CN=example.com"
# 2) 提交签发
curl -X POST "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/certificates" 
  -H "Authorization: Bearer $CF_API_TOKEN" -H "Content-Type: application/json" 
  --data "{"hostnames":["example.com","*.example.com"],"requested_validity":5475,"request_type":"origin-rsa","csr":"$(cat origin.csr | jq -Rs .)"}"

requested_validity 单位是天,可选 7/30/90/365/730/1095/5475(5475 即 15 年);request_type 取 origin-rsa 或 origin-ecc。

怎么避免手改配置被后人改回去?用 Terraform 固化。provider 建议 cloudflare/cloudflare 4.x:

resource "cloudflare_zone_settings_override" "example" {
  zone_id = var.zone_id
  settings {
    ssl              = "strict"   # off|flexible|full|strict
    always_use_https = "on"
    min_tls_version  = "1.2"      # 可选 1.0~1.3
    tls_1_3          = "on"
  }
}
# 已存在的 zone 必须先 import,否则 plan 会把线上值覆盖成默认 flexible
terraform import cloudflare_zone_settings_override.example <ZONE_ID>

注意 4.x 后期该资源已被标记 deprecated,5.x 拆成独立的 cloudflare_zone_setting 资源,迁移时逐条映射。

回源端口不是 443 会怎样?Cloudflare 只代理特定 HTTPS 端口:443、2053、2083、2087、2096、8443。源站写在其他端口上,边缘握手直接失败并返回 525 SSL Handshake Failed。正确做法是在 Origin Rules 或 SSL/TLS → Origin Server 里指定端口,同时源站监听保持一致:

server {
    listen 8443 ssl;                       # 与 Cloudflare 回源端口一致
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/origin.key;
    server_name example.com;
}

验证:openssl s_client -connect 203.0.113.10:8443 -servername example.com </dev/null | openssl x509 -noout -issuer -dates,issuer 应显示 CloudFlare Origin SSL Certificate Authority。至此这套 cloudflare ssl 配置的可验证闭环才算走完:边缘证书 → 模式选型 → 源站链 → 回源端口,任一环断裂都会以 525/526 的形式暴露出来。

Cloudflare SSL 配置的加密模式与证书方案对比表

先给结论:生产环境一律选 Full (strict),源站证书优先用 Cloudflare Origin CA;但只要源站还会被 Cloudflare 以外的客户端直连(移动 App、第三方回调、内部服务),就必须换成 Let’s Encrypt 或商业证书,否则那些客户端会看到”证书不受信任”。下表是四种模式的差异,据 Cloudflare 官方文档《Encryption modes》,Flexible 与 Full 都不校验证书有效性,这是 526 与重定向循环高发的根源。

加密模式 边缘→源站 校验证书链/有效期/主机名 适用场景 典型故障
Off HTTP 80 否 仅迁移前测试 全站明文,支付与合规不通过
Flexible HTTP 80 否 装不了证书的老虚拟主机 526;源站 301 跳 HTTPS 时形成重定向循环
Full HTTPS 443 否 自签证书过渡期 存在中间人风险,证书过期无告警
Full (strict) HTTPS 443 是 生产推荐 缺中间证书/过期/域名不匹配 → 526

Flexible 的重定向循环怎么来的?Cloudflare 用 HTTP 80 回源,源站的 WordPress 或 Nginx 配置了 301 https://,浏览器又回到 Cloudflare,Cloudflare 再走 80 回源,无限套娃。这也是为什么”能改源站就别用 Flexible”。

边缘证书决定访客浏览器里那把锁,与回源无关:

方案 费用 覆盖主机名 续期 限制
Universal SSL 免费(全套餐) 根域 + 一级子域(example.com、*.example.com) 约 90 天自动 不覆盖 *.sub.example.com 二级子域
Advanced Certificate Manager 约 10 美元/月/zone,年付有折扣 自定义,支持更多主机名与自定义有效期 自动,可上传自有证书 按 zone 计费
上传自有边缘证书 随 Business 及以上套餐 任意 自行维护 需 Business+

源站证书决定 Cloudflare 认不认你的服务器。做 cloudflare ssl 配置时最常踩的坑,是把 Origin CA 装到还会被直连的源站上——它只被 Cloudflare 边缘信任。

方案 费用 有效期 信任范围 运维成本
Cloudflare Origin CA 免费 最长 5475 天 仅 Cloudflare 边缘 几乎为零
Let’s Encrypt 免费 90 天 全浏览器/全客户端 需 certbot 等自动续期
商业 DV 约 100–500 元/年 1 年 全信任 低
商业 OV/EV 约 800–5000 元/年 1–2 年 全信任 中;代理场景下 EV 绿条不可见

切到 Full (strict) 之前,先在源站本地模拟 Cloudflare 的校验行为,把 526 提前打出来:

# 模拟 Cloudflare 回源:指定 SNI 并强制校验证书链
openssl s_client -connect 203.0.113.10:443 -servername origin.example.com 
  -verify_return_error -CAfile /etc/ssl/certs/ca-certificates.crt &1 
  | grep -E "Verify return code|verify error"

# 期望:Verify return code: 0 (ok)
# 20 (unable to get local issuer certificate) → 缺中间证书,Full (strict) 下必然 526
# 10 (certificate has expired) → 证书过期,同样 526

回源加密强度还有三项独立开关,别混淆:Minimum TLS Version 设为 1.2 后,TLS 1.0/1.1 客户端会在握手阶段被拒(浏览器报 ERR_SSL_VERSION_OR_CIPHER_MISMATCH);开启 TLS 1.3 后握手可降至 1-RTT,据 Cloudflare 官方博客的测试数据,对高延迟地区首屏有明显收益;Authenticated Origin Pulls 与 Full (strict) 是两件独立的事——前者防绕过(源站只认携带 Cloudflare 客户端证书的连接),后者保证加密与身份校验,建议同时开启:

# Nginx 源站:只接受携带 Cloudflare 客户端证书的回源请求
ssl_client_certificate /etc/nginx/certs/cloudflare-origin-pull-ca.pem;  # 下载自 developers.cloudflare.com/ssl/static/authenticated_origin_pull_ca.pem
ssl_verify_client on;  # 直连且未带证书的请求返回 400 "No required SSL certificate was sent"

不能改源站、只能上 Flexible 的情况,务必在工单或变更记录里写清整改期限,并同时关掉源站的 HTTPS 强制跳转,否则重定向循环会在上线后立刻出现。

Cloudflare SSL 配置常见报错与排查路径

526 Invalid SSL certificate 怎么排查?526 的完整含义是:Cloudflare 边缘已按 Full (strict) 模式向源站发起握手,但源站证书没有通过校验。据 Cloudflare 官方文档,Full (strict) 会校验证书链完整性、有效期与主机名,而 Full 只要求源站”有一张证书”,自签名也放行——所以第一步先确认 SSL/TLS → Overview 里的模式是不是 Full (strict),再看证书本身。用 SNI 直连源站复现 Cloudflare 的回源握手:

# 模拟 Cloudflare 回源:必须带 -servername,否则拿到的是默认站点证书
openssl s_client -connect 203.0.113.10:443 -servername www.example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer -dates
# 关注三项:notAfter 是否已过期;issuer 与 subject 相同=自签名(Full strict 必 526);
# subject 里的 CN/SAN 是否包含 www.example.com

# 校验证书链是否缺中间证书
openssl s_client -connect 203.0.113.10:443 -servername www.example.com &1 
  | grep -E "Verify return code|depth"
# Verify return code: 21 (unable to verify the first certificate) → 源站只发了叶子证书

若使用 Cloudflare Origin CA,证书与私钥必须成对:ssl_certificate 指向 Cloudflare 后台下载的 cloudflare-origin-ca.pem(或自建 fullchain),ssl_certificate_key 指向生成 CSR 时那把私钥;两者不匹配时 Nginx 启动即报 SSL_CTX_use_PrivateKey ... key values mismatch。

525 SSL handshake failed 和 526 有什么区别?525 是 TCP 通了但 TLS 握手没完成,通常与证书内容无关。先在源站外部用 --resolve 绕过 DNS 复现,排除 Cloudflare 因素:

curl -vI https://www.example.com --resolve www.example.com:443:203.0.113.10
# 卡在 "TLS handshake" → 安全组/防火墙未放行 Cloudflare IP 段
curl -s https://www.cloudflare.com/ips-v4   # 把这些网段加进安全组 443 入站白名单
ss -lntp | grep 443                          # 确认进程监听 0.0.0.0:443 而非仅 127.0.0.1
openssl version                              # TLS 1.2 自 OpenSSL 1.0.1 起支持,1.0.2 以下常缺现代 GCM 套件

ERR_TOO_MANY_REDIRECTS:为什么改了 SSL 模式还在循环?典型成因是 Flexible + 源站强制 HTTPS:Cloudflare 用 HTTP 回源,源站 301 到 HTTPS,边缘又按 Flexible 回落 HTTP。用 curl -sSI 逐跳看 Location 就能确认循环:

curl -sSI http://www.example.com | grep -iE "^(HTTP|location)"
# HTTP/1.1 301 → https://...  HTTP/2 301 → http://... 即为死循环

修法二选一:把模式切到 Full (strict)(推荐,配合 Origin CA 证书),或删掉源站的 301 跳转规则、改用 Cloudflare 的 “Always Use HTTPS” 在边缘做跳转。

521 / 522 是证书问题吗?不是,但最常被误判成 SSL 配置故障。521 表示源站主动拒绝连接(Nginx 没起、端口没监听),522 表示 TCP 握手超时(安全组丢包、源站过载或回源 IP 被黑洞)。

错误码 含义 首要怀疑对象 定位命令
520 源站返回空响应/非标准响应头 PHP-FPM 崩溃、Nginx 配置错误 nginx -t + error.log 按 cf-ray 时间点检索
521 源站拒绝连接 服务未启动、端口未监听 ss -lntp | grep 443
522 TCP 连接超时 安全组丢包、源站过载 curl -vI --resolve 从外部探测
525 TLS 握手失败 协议/套件不匹配、IP 白名单 openssl s_client 看握手阶段
526 证书校验失败 过期、缺中间证书、SNI 不符 openssl x509 -dates

ERR_SSL_VERSION_OR_CIPHER_MISMATCH 需要处理吗?先区分两类:一是访客客户端太旧(Windows 7 默认 TLS 1.0),而站点在 SSL/TLS → Edge Certificates 里把 Minimum TLS Version 设到了 1.2(默认 TLS 1.0,新域名已逐步默认 1.2)——这属于预期行为,建议先在日志中统计该 UA 占比再决定是否降到 1.1;二是边缘证书尚未签发完成,此时 Universal SSL 状态为 Pending,等待变为 Active 即可,通常 15 分钟内完成。520 则先跑 systemctl status nginx 与 nginx -t,再用 Cloudflare 响应头里的 cf-ray 前段定位 /var/log/nginx/error.log 同一时间点的记录。

怎么验证 Cloudflare SSL 配置已经生效?

一条命令只能证明”某个点”通了,不能证明整条链路都对。建议按边缘 → 证书/TLS 版本 → HSTS → 源站 → 控制面回读的顺序逐层验证,每层都有独立的失败语义,出问题时能立刻定位是 Cloudflare 配置还是源站配置。

第一层:边缘链路与 HTTPS 跳转。先确认请求确实落在 Cloudflare 边缘,而不是直连源站或本地缓存:

# 1) 边缘是否生效:期望 HTTP/2 200、server: cloudflare、存在 cf-ray
curl -sSI https://example.com | head -n 8
# 典型输出:
# HTTP/2 200
# date: Tue, 11 Jun 2024 08:12:33 GMT
# content-type: text/html
# server: cloudflare
# cf-ray: 8917a3c2bd4a2f1e-HKG

# 2) Always Use HTTPS 是否生效:期望 301 + location: https://example.com/
curl -sSI http://example.com | head -n 5
# HTTP/1.1 301 Moved Permanently
# location: https://example.com/

如果第 1 条返回 server: nginx 或没有 cf-ray,说明 DNS 记录是”仅 DNS”(灰云)而非代理(橙云),后续所有 SSL 设置都不起作用。据 Cloudflare 文档,cf-ray 是判定请求是否经过其边缘网络的权威标志。

第二层:证书签发者、有效期与最低 TLS 版本。边缘证书由 Cloudflare 的 CA 合作方(Let’s Encrypt、Google Trust Services、Sectigo)签发:

# 查看边缘证书的签发者与有效期(-tls1_2 强制走 TLS 1.2 握手)
openssl s_client -connect example.com:443 -servername example.com -tls1_2 
  /dev/null | openssl x509 -noout -issuer -dates
# issuer=C=US, O=Google Trust Services LLC, CN=WE1
# notBefore=May 12 00:00:00 2024 GMT
# notAfter=Aug 10 23:59:59 2024 GMT

# 验证 Minimum TLS Version = 1.2 已生效(--tls-max 需 curl >= 7.54)
curl --tlsv1.0 --tls-max 1.0 https://example.com
# curl: (35) error:0A000102:SSL routines::unsupported protocol

如果 TLS 1.0 仍能握手成功,说明 Minimum TLS Version 还是默认的 1.0(Cloudflare 旧账户默认值),需要在 SSL/TLS → Edge Certificates 中改为 1.2。返回 unsupported protocol 而非 handshake failure 是正常的,两者都代表被拒绝。

第三层:HSTS 响应头。HSTS 定义于 RFC 6797,只在 HTTPS 响应中出现,HTTP 响应里查不到是正常的:

curl -sSI https://example.com | grep -i strict-transport-security
# strict-transport-security: max-age=15552000; includeSubDomains

输出为空时先确认 HTTPS 状态码是 200 而非 301/302——Cloudflare 的 HSTS 头由边缘注入,跳转响应同样会带,但若你的源站或 Worker 覆写了响应头,边缘注入可能被覆盖;其次确认 Edge Certificates 页面点击了保存并已过 TTL 缓存。

第四层:源站链路(区分 Full 与 Full strict)。

# 在源站本机验证自身 TLS 是否正常(绕过 DNS,直连 127.0.0.1)
curl -sSI https://example.com --resolve example.com:443:127.0.0.1

# 从外网直连源站 IP:期望被拒绝(证明 Authenticated Origin Pulls 生效)
curl -sSI https://203.0.113.10 -k
# curl: (35) ... sslv3 alert handshake failure / certificate required

若外部仍能直连 443,通常是 nginx 的 ssl_verify_client on; 改了但没 nginx -s reload;Apache 对应 SSLVerifyClient require,需重启 httpd。这一步不做,Full (strict) 只保护了 Cloudflare→源站方向,源站仍可被绕过直连。

第五层:控制面回读与 IaC 一致性。控制台看到的和 API 返回的偶有差异(尤其是多账户/多 Token 场景):

# 需要 Zone Settings 读权限的 API Token
curl -s -H "Authorization: Bearer $CF_API_TOKEN" 
  "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/settings/ssl" | jq '.result.value'
# "strict"

curl -s -H "Authorization: Bearer $CF_API_TOKEN" 
  "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/settings/min_tls_version" | jq '.result.value'
# "1.2"

# Terraform 管理的场景:有漂移会列出被改动的属性
terraform plan -target=cloudflare_zone_settings_override.this
# No changes. Your infrastructure matches the configuration.

同一路径下还可回读 /settings/always_use_https(取值 on/off)与 /settings/tls_1_3,一次脚本批量核对全部 Cloudflare SSL 配置项。

第六层:第三方复核。用 Qualys SSL Labs(ssllabs.com/ssltest)扫描域名,Full (strict) + TLS 1.2/1.3 + HSTS 通常可拿 A 或 A+。据 SSL Labs 评分规则,出现 W 多为证书链不完整或 includeSubDomains 下的子域未全启用 HTTPS,出现 C 则通常是仍支持 TLS 1.0/1.1 或未启用前向保密套件。

验证项 关键命令/入口 期望结果 不符合时的含义
边缘代理 curl -sSI https://域名 | head -n 8 HTTP/2 200 + cf-ray DNS 为”仅 DNS”,SSL 设置全部无效
强制 HTTPS curl -sSI http://域名 301 + location: https:// Always Use HTTPS 未开
证书 openssl s_client ... | openssl x509 -noout -issuer -dates Let’s Encrypt / GTS / Sectigo,未过期 通用证书未签发或处于 pending 状态
最低 TLS curl --tlsv1.0 --tls-max 1.0 握手失败 Minimum TLS Version 仍为 1.0
HSTS curl -sSI https://域名 | grep -i strict max-age=15552000; includeSubDomains 未保存或响应头被源站覆盖
源站锁定 外部 curl -k https://源站IP 握手失败 Authenticated Origin Pulls 未 reload
控制面 /settings/ssl、/settings/min_tls_version strict、1.2 控制台与 API 不一致,检查 Token 所属账户

多子域名与泛域名场景下的 Cloudflare SSL 配置

为什么 api.dev.example.com 明明”已经代理”了,浏览器还是报证书错误?因为 Cloudflare 的 Universal SSL 覆盖面比多数人以为的窄。据 Cloudflare 官方文档,Universal SSL 只为根域和一级子域各签发一张证书,即 example.com 与 *.example.com;*.example.com 不匹配 api.dev.example.com(通配符只替换最左一段)。此时浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID,或提示 “certificate is not valid for api.dev.example.com”,而 Cloudflare 边缘本身并无故障。

方案 覆盖范围 计费 关键限制 适用场景
Universal SSL(默认启用) 根域 + 一级通配符 免费 不含二级及更深子域 单域、扁平子域结构
Total TLS 每个已代理子域一张独立证书 按主机名计费(约 $0.10/主机名/月,以官网为准) 仅对已代理(橙云)记录生效 子域数量中等、结构动态变化
Advanced Certificate Manager (ACM) 单张证书最多 100 个主机名 约 $10/月/zone 需规划主机名清单 多子域、需统一管理与自定义 CA

Total TLS 怎么开、会不会和 Universal SSL 冲突?不会。启用路径为 SSL/TLS → Edge Certificates → Total TLS,开启后 Universal SSL 继续保留,二者并存,Cloudflare 会按 SNI 选择最匹配的证书。Total TLS 为每个已代理的子域自动签发独立证书并自动续期,省掉逐个申请 Let’s Encrypt 的运维,但主机名多时按量计费会超过 ACM。

ACM 值不值?如果子域数量稳定在几十个且需要统一控制有效期与签发 CA,ACM 的可维护性优于逐个申请 Let’s Encrypt:它支持自定义证书有效期(2 周到 1 年)、上传自定义证书、指定 CA,并把多主机名合并进一张证书。据 Let’s Encrypt 的速率限制文档,同一注册域每周 50 张证书的上限在子域快速扩张时很容易触顶,这正是 ACM 想解决的问题。

CAA 记录不匹配会怎样?表现为证书长期停在 Pending Validation,而 Dashboard 提示信息非常有限。使用 Universal SSL 时至少要放行 letsencrypt.org、pki.goog、digicert.com;使用 ACM 指定自定义 CA 时同步放行对应 CA。自查命令:

# 查询现网 CAA,确认 issue / issuewild 是否放行了实际签发 CA
dig CAA example.com +short
# 期望输出示例(注意 issuewild 影响泛域名证书签发)
# 0 issue "letsencrypt.org"
# 0 issue "pki.goog"
# 0 issuewild "digicert.com"

# 从任意节点验证边缘证书覆盖了哪些主机名
openssl s_client -connect api.dev.example.com:443 -servername api.dev.example.com /dev/null 
  | openssl x509 -noout -subject -ext subjectAltName

源站用一张泛域名证书承接所有回源,为什么 Full (strict) 报 526?因为 Full (strict) 会同时校验证书链与主机名,而回源时的 SNI 由 Cloudflare 按请求主机名发送。若 Nginx 只有一个 default_server 挂着 *.example.com,对 api.dev.example.com 的校验必然失败,典型报错为 526 Invalid SSL certificate(curl -v 返回 HTTP/2 526)。做法是每个 server 块显式声明 server_name 与对应证书,让 SNI 与证书一致:

# /etc/nginx/conf.d/multi-sub.conf
# 一级子域:泛域名证书可覆盖
server {
    listen 443 ssl;
    server_name *.example.com;
    ssl_certificate     /etc/ssl/wildcard.example.com.pem;   # 含中间证书链
    ssl_certificate_key /etc/ssl/wildcard.example.com.key;
    ssl_protocols TLSv1.2 TLSv1.3;                            # 与 Cloudflare 边缘最低版本对齐
}

# 二级子域:泛域名证书不匹配,需单独证书或更宽的 SAN 证书
server {
    listen 443 ssl;
    server_name api.dev.example.com;
    ssl_certificate     /etc/ssl/api.dev.example.com.pem;
    ssl_certificate_key /etc/ssl/api.dev.example.com.key;
}

不同子域回源到不同源站,能一个 Flexible 一个 Full (strict) 吗?不能。加密模式是 zone 级设置,不按主机名生效。若部分子域源站只支持 HTTP,正确做法是用 Configuration Rules(Rules → Configuration Rules)按主机名覆盖 SSL 模式,或把该子域拆成独立 zone;注意 Origin Rules 只能改回源端口、Host 头与 SNI,不能改加密模式。这也是做 cloudflare ssl 配置时最常见的架构陷阱:模式冲突无法在单个 zone 内”混搭”解决。

生产环境一律选 Full (strict)。Flexible 下 Cloudflare 到源站走 80 端口明文,源站无法感知真实 HTTPS,容易触发 526 与重定向循环,且回源段可被中间人嗅探。只有当源站是完全无法安装证书的托管虚拟主机、且短期无法迁移时,才临时使用 Flexible,并同步关闭源站自身的 HTTPS 强制跳转。

先在源站执行 openssl s_client -connect 127.0.0.1:443 -servername 你的域名 -showcerts,确认证书未过期、链完整、主机名匹配。最常见原因是 Nginx 的 ssl_certificate 指向了 cert.pem 而非 fullchain.pem,补上中间证书后 systemctl reload nginx 即可。若使用自签证书,需换成 Cloudflare Origin CA 或 Let's Encrypt 证书。

Universal SSL 免费,覆盖根域和一级子域,证书由 Let's Encrypt / Google Trust Services 签发,约 90 天自动续期,不可自定义。Advanced Certificate Manager 约 10 美元/月/zone,支持最多 100 个主机名、自定义有效期、上传自有证书和指定 CA,适合多子域或需要统一证书策略的团队。

需要。Cloudflare 的边缘证书只保护访客到 Cloudflare 这一段,Cloudflare 到源站这一段由源站证书保障。选择 Full (strict) 时源站必须有 Cloudflare 信任的证书,可用免费的 Cloudflare Origin CA(最长 5475 天)或 Let's Encrypt(90 天)。只有 Flexible 模式才不需要源站证书,但该模式不加密回源段。

需要 CDN、WAF、DDoS 防护和全球就近接入时选 Cloudflare,代价是加密模式、回源证书、Authenticated Origin Pulls 都要额外配置一遍。纯展示站、访客集中在单一区域、又不想引入第三方依赖时,Nginx + certbot 更简单,一条 certbot –nginx -d example.com 即可完成。两者也可叠加:Cloudflare 做边缘,源站仍用 Let's Encrypt,配合 Full (strict) 使用。

这是 Flexible 模式与源站 HTTPS 强制跳转叠加的典型症状:Cloudflare 把 http 跳到 https,源站又因为读到 scheme 是 http 而再跳一次。解决办法是把加密模式改为 Full (strict),或在源站删除针对 Cloudflare 回源的 return 301 规则。用 curl -sSIL http://example.com 可看到完整跳转链,定位是哪一跳在循环。

不是配置错误,是设计如此。Origin CA 由 Cloudflare 自建 CA 签发,只有 Cloudflare 边缘信任它,浏览器直连源站 IP 时会提示证书不受信任。这正是配合 Authenticated Origin Pulls 使用的场景:正常访客走 Cloudflare,源站不应被直连。若需要浏览器也能直连源站,请改用 Let's Encrypt 或商业证书。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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