网站套上 Cloudflare 之后,一旦打不开,屏幕上最先出现的往往是一张带着错误码的页面。很多人第一反应是乱改设置:加密模式换一换、缓存清一清、规则关一关,改了半天故障还在,甚至越改越乱。其实 Cloudflare 的错误码体系非常规整,每个码都精确对应一段链路上的某类故障——看懂错误码,就等于知道了该往哪儿查。
这一篇是 Cloudflare 实战系列的收官篇,主线分三段:先给一套不依赖具体错误码的通用定位法(二分法),再把 5xx 和 1xxx 两大系列错误码逐个拆开讲清每个码的官方含义、常见成因和排查入口,最后用一个完整的 522 排障剧本把方法论串起来。以后再遇到网站打不开,照着这篇的顺序走,五分钟内基本能锁定故障在哪一段。
先立规矩:排障前不要乱动配置
动手之前先强调一条纪律:故障期间每改一处配置,都要记下来改了什么、原值是什么。Cloudflare 的很多设置有传播延迟,DNS 和规则变更又涉及全球节点生效时间,你如果一口气改五处,最后好了都不知道是哪一处起的作用,坏了也不知道该回滚哪一处。正确姿势是:先取证(错误码、错误页截图、发生时间),再按下面的二分法定位,一次只改一处,改完等一两分钟再验证。
通用方法论:二分定位法
不管错误码是什么,第一步永远是回答同一个问题:故障出在 Cloudflare 边缘这一段,还是源站那一段? 把这个问题答出来,排查范围立刻缩小一半。方法有三种,互为印证。
方法一:切灰云直连源站复现
在 Cloudflare 控制台的 DNS 管理里,把出问题的那条记录的代理状态从橙云改成灰云(仅 DNS),等一两分钟后重新访问。如果灰云下网站恢复正常,说明源站本身是好的,故障在 Cloudflare 的代理链路或相关设置上(加密模式、规则、缓存等);如果灰云下还是打不开,那 Cloudflare 只是”背锅”的,问题在源站本身或者 DNS 记录指错了地方。
WARNING切灰云会把源站真实 IP 直接暴露在 DNS 解析结果里。如果你的源站 IP 一直靠橙云隐藏,切之前要想清楚;排障结束后记得第一时间切回橙云。
方法二:curl 加 —resolve 绕过解析直打源站
不想动 DNS 记录的话,用 curl 的 --resolve 参数可以不动任何配置就直连源站验证:
# 把 example.com 强制解析到源站 IP,绕过 Cloudflare 直接访问源站curl -I --resolve example.com:443:203.0.113.10 https://example.com/
# 看详细的连接与 TLS 握手过程curl -v --resolve example.com:443:203.0.113.10 https://example.com/ 2>&1 | head -40--resolve 的格式是 主机名:端口:IP。这条命令返回正常页面,说明源站的 Web 服务、证书、应用都是好的,问题在 Cloudflare 侧;如果直连源站就报错,那错误码是什么不重要了,先修源站。注意直打源站时如果源站配了基于 SNI 的虚拟主机或者只认特定 Host 头,结果要结合源站配置看。
再补一条查当前到底走没走 Cloudflare 的命令:
# 看解析结果:返回的是 Cloudflare 的 Anycast IP 还是源站 IPdig +short example.com
# 看响应头里有没有 cf-ray,有就是经过了 Cloudflare 边缘curl -sI https://example.com/ | grep -i "cf-ray\|server"方法三:看错误页是谁家的
打开出故障的页面,看它长什么样:
| 错误页特征 | 说明 |
|---|---|
| 带 Cloudflare 标志、显示 Ray ID、标注 “Error 5xx” 和 Host/ Browser/ Cloudflare 三段状态图 | Cloudflare 生成的错误页,故障在回源链路上,页面里三段状态图会直接标出哪一段是红的 |
| 是源站自己的 404/500 页面样式,或 Nginx/Apache 的默认报错页 | 请求已经到达源站,是源站应用层的问题,与 Cloudflare 无关 |
| 浏览器自己的报错页(如 ERR_TOO_MANY_REDIRECTS、ERR_SSL_VERSION_OR_CIPHER_MISMATCH) | 没有标准错误码,多半是重定向循环或 TLS 配置问题,见后文专节 |
三段状态图是 Cloudflare 错误页里最有价值的信息:Browser、Cloudflare、Host 三段哪段标红,故障就从哪段查起。
把三种方法合起来,就是一条固定的排障流水线:记错误码 → 看错误页归属 → curl —resolve 直连源站验证 → 得出”边缘问题还是源站问题”的结论 → 再去查对应那一段的细项。下面的错误码详解,本质上都是这条流水线走到最后一步时的对照表。
5xx 系列:回源链路故障
5xx 错误页都是 Cloudflare 生成的,含义是”Cloudflare 替你去源站取页面时出了问题”。逐个拆:
| 错误码 | 官方含义 | 最常见成因 | 第一排查动作 |
|---|---|---|---|
| 520 | 源站返回了未知错误或空响应 | 源站应用崩溃、返回了超大响应头、连接被源站重置 | 看源站错误日志 |
| 521 | 源站拒绝了 Cloudflare 的连接 | Web 服务没起来、端口没监听、防火墙直接拒绝 | 在源站本机 curl localhost 验证服务 |
| 522 | 与源站建立连接超时 | 源站防火墙没有放行 Cloudflare 的 IP 段、源站宕机或过载 | 查源站防火墙与安全组 |
| 523 | 源站不可达 | DNS 记录指向了不存在或错误的 IP、源站所在网络路由异常 | 核对 A/AAAA 记录的 IP |
| 524 | 已连上源站但源站响应超时 | 慢接口、长任务、源站处理能力不足 | 看源站接口耗时日志 |
| 525 | 与源站的 SSL 握手失败 | 源站证书过期/不完整、源站不支持相应的 TLS 版本或 SNI | 在源站本机测 TLS |
| 526 | 源站证书无效 | 加密模式为”完全(严格)“而源站证书自签或过期 | 换有效证书或调整加密模式 |
520:源站返回未知错误
520 是个”兜底”错误码:连接建立了,但源站返回了 Cloudflare 无法归类的响应——空响应、连接被意外重置、响应头过大或格式异常都可能触发。它通常意味着源站应用层出了问题(进程崩溃、反向代理配置错误、应用返回了畸形的响应)。排查入口只有一个:去源站看 Web 服务器和应用的错误日志,用前面 --resolve 的方法直连复现,看源站自己报什么。
521:源站拒绝连接
521 表示 Cloudflare 连到源站 IP 的对应端口时,连接被明确拒绝(收到 RST)。翻译成人话就是:那个 IP 上的那个端口,没有服务在听,或者防火墙直接把连接拒了。最常见的场景是 Web 服务挂了没拉起来、服务只监听了别的端口、或者源站防火墙规则把连接 DROP/REJECT 了。排查顺序:先 SSH 上源站,ss -tlnp 看 80/443 是否在监听,再 curl -I http://127.0.0.1/ 在本机验证服务本身,最后查防火墙。
522:连接超时
522 和 521 只差一个字,含义完全不同:522 是连接请求发出去之后石沉大海,在超时时间内既没连上也没被拒绝。现实中 522 最高频的成因是源站防火墙或云厂商安全组没有放行 Cloudflare 的 IP 段——源站把 Cloudflare 回源的连接默默丢弃了。Cloudflare 回源用的是它自己的一组官方 IP 段,源站防火墙如果做了来源 IP 白名单,必须把这组段加进去(文末有获取方式)。其次才是源站宕机、过载到无力响应、或者中间网络故障。本篇最后的完整剧本就是一个 522 的实例。
523:源站不可达
523 表示 Cloudflare 按 DNS 记录找到源站 IP 后,网络层根本到达不了。重点查两件事:一是 DNS 记录里的 IP 写错了(换了服务器忘了改记录、IP 抄错一位);二是源站所在机房或云厂商的网络路由问题。前者自己改记录即可,后者只能等厂商恢复或切换源站。
524:源站响应超时
524 说明 TCP 连接和请求都成功了,但源站处理太久,超过了 Cloudflare 的等待时间(免费版默认 100 秒量级,以官方文档为准)。典型场景是慢 SQL、大报表导出、文件转码这类长任务接口。解法不在 Cloudflare 侧乱调,而在源站侧:把长任务改成异步(先返回任务 ID,后台跑完再查结果),或者把这类接口放到一个不经过 Cloudflare 代理的子域名上直连。
525:SSL 握手失败
当加密模式是”完全”或”完全(严格)“时,Cloudflare 回源要和源站做 TLS 握手,525 就是握手这一步失败了。常见成因:源站证书过期、证书链不完整、源站只支持过低的 TLS 版本、源站没有正确配置 SNI 对应的证书。排查时在源站上直接测:
# 在源站本机验证 TLS 握手与证书openssl s_client -connect 127.0.0.1:443 -servername example.com </dev/null
# 直连源站 IP 并指定 SNI,看返回的证书是谁的、何时过期curl -vk --resolve example.com:443:203.0.113.10 https://example.com/ 2>&1 | grep -A2 "subject\|expire"加密模式各档位对源站证书的要求不同,这是 525/526 的总开关,先去 Cloudflare SSL/TLS 加密模式详解 把模式对照表看一遍再动手。
526:源站证书无效
526 只会出现在加密模式为”完全(严格)“时:握手能完成,但证书通不过严格校验——自签证书、过期、域名对不上,都会被判无效。它和 525 的区分非常实操:525 是”手握不上”,526 是”手握上了但证件不合格”。解法二选一:给源站换一张正规 CA 签发的证书(或用 Cloudflare 的 Origin CA 源站证书),或者把加密模式降到”完全”。降模式只是绕过校验,治本还是换证书。
重定向死循环专节
表现:浏览器报 ERR_TOO_MANY_REDIRECTS,页面根本打不开;用 curl 抓会看到 301/302 在两个地址之间来回跳:
# 看重定向链,死循环时会刷出一长串互相跳转curl -sIL https://example.com/ | grep -i "^HTTP\|^location"成因九成是这个经典组合:Cloudflare 加密模式设为”灵活”,源站又配了强制 HTTP 跳 HTTPS。灵活模式下 Cloudflare 回源走的是 HTTP,源站一看是 HTTP 就返回”请跳 HTTPS”,浏览器跳到 HTTPS 后 Cloudflare 又用 HTTP 回源……无限循环。curl 抓包时能看到 Location 在 http 和 https 之间反复横跳,浏览器则直接放弃并报重定向过多。
解法在 SSL 篇里已经讲透:把加密模式改成”完全(严格)“并给源站配好证书,让回源本身就是 HTTPS,循环立刻消失。临时救急可以先关掉源站的强制跳转,但不要用”把加密模式改回灵活 + 关掉源站 HTTPS”这种方式长期凑合,那等于整段回源明文裸奔。详细对照见 Cloudflare SSL/TLS 加密模式详解。
1xxx 系列:配置与解析类错误
1xxx 是 Cloudflare 的客户端错误系列,多半和 DNS 配置、账户设置有关,不涉及源站死活:
| 错误码 | 含义 | 定位与入口 |
|---|---|---|
| 1000 | DNS 记录指向了被禁止的 IP | 记录指向了 Cloudflare 自己的 IP 或保留地址,改 A/AAAA 记录指向真实源站 |
| 1001 | DNS 解析错误 | 域名解析链异常,检查记录是否存在、CNAME 目标是否可解析 |
| 1016 | 源站 DNS 错误 | 代理记录找不到源站:CNAME 目标不存在或记录配置残缺,去 DNS 页核对 |
| 1033 | Cloudflare Tunnel 未运行 | 域名绑了 Tunnel 但 cloudflared 没在跑,去源站把隧道服务拉起来 |
| 1101 | Worker 运行时异常 | 部署的 Worker 代码抛了未捕获异常,去 Workers 控制台看日志改代码 |
其中 1033 在自建服务场景里很常见:域名走 Tunnel 发布,服务器重启后 cloudflared 没自启,网站就报 1033。它的好处是定位极其明确——错误码直接告诉你隧道没在运行,SSH 上去 systemctl status cloudflared 一看便知,拉起来即恢复。Tunnel 的部署与自启配置见 Cloudflare Tunnel:不暴露源站发布服务。
1101 则是 Worker 的问题:请求命中了某个路由上的 Worker,代码运行时抛错。去 Cloudflare 控制台的 Workers 页面打开实时日志复现一次,异常堆栈会直接显示出来。
其他常见状况:不是 5xx 也要会认
ERR_SSL_VERSION_OR_CIPHER_MISMATCH
浏览器报这个错且没有 Cloudflare 错误码,通常是 TLS 版本对不上:Cloudflare 侧设置的最低 TLS 版本高于访客浏览器/客户端支持的版本,或者边缘证书还没签发完成(刚接入的域名偶尔会短暂出现)。排查:去控制台 SSL/TLS → 边缘证书,确认证书状态是 Active;再看最低 TLS 版本设置,老旧客户端要访问就不能把下限抬到 TLS 1.3 only。
缓存导致的”故障假象”
改完源站页面,用户说”还是旧的/还是坏的”,十有八九是缓存里还留着旧版本甚至当时的错误页。验证方法:给 URL 随便加个参数绕开缓存,或者开无痕窗口访问:
# 带随机参数请求,对比与正常请求的差异curl -sI "https://example.com/?_t=$(date +%s)" | grep -i "cf-cache-status\|HTTP"curl -sI https://example.com/ | grep -i "cf-cache-status\|HTTP"响应头里的 cf-cache-status: HIT 说明这份内容是从边缘缓存里出的。确认是缓存问题后,去控制台清除对应 URL 的缓存即可,别把好好的源站配置翻个底朝天。
被 WAF 拦截的 403
页面显示 403 并带 Ray ID、写着被安全规则拦截,这是 WAF 自定义规则或托管规则命中了请求,不是故障。去控制台的安全性 → 事件里按 Ray ID 或来源 IP 查,能看到命中的是哪条规则,再决定是放行这个 IP、给路径加例外还是修规则表达式。规则的写法与误伤处理见 WAF 与安全规则实战。
源站侧配合清单
很多 5xx 的根子在源站侧的配合没做到位,集中列一份清单,部署时逐项核对:
- 放行 Cloudflare 官方 IP 段:源站防火墙和云安全组的入站规则里,80/443 端口要对 Cloudflare 公布的全部 IPv4/IPv6 段放行。这份段列表会更新,去 Cloudflare 官网的 IP Ranges 页面(cloudflare.com/ips)拿最新版,不要抄博客里的旧列表。反过来也可以利用这一点:源站只允许 Cloudflare 的段回源访问,其他来源一律拒绝,天然挡住绕过边缘直打源站的流量。
- 学会看回源日志:源站访问日志里,来自 Cloudflare 段 IP 的请求就是回源流量;故障时段去日志里搜对应时间点,看请求到底有没有到达源站、源站返回了什么状态码,这是判断”请求死在哪一段”的最硬证据。
- 还原真实访客 IP:经过代理后,源站日志里看到的全是 Cloudflare 的 IP。真实访客 IP 在
CF-Connecting-IP请求头里,Nginx/Apache 配置一行日志格式调整即可记录下来,做封禁和统计时要用它,别对着回源 IP 操作。
完整剧本:一次 522 的定位全过程
背景:早上用户反馈”网站打不开,显示 522”。按流程走:
第一步,确认现象与错误页归属。 自己打开网站,确实是 Cloudflare 品牌错误页,码是 522,页面三段状态图里 Host 标红。初步判断:回源连接超时,重点查源站连通性。
第二步,二分定位。 直连源站验证:
# 直连源站,源站本身的服务是好的curl -I --resolve example.com:443:203.0.113.10 https://example.com/# 返回 HTTP/2 200 —— 源站服务正常再 SSH 上源站自查:
ss -tlnp | grep -E ':80|:443' # 服务在正常监听curl -I http://127.0.0.1/ # 本机访问正常uptime # 负载正常,没被打满源站一切正常,但 Cloudflare 连不上来——故障点锁定在”源站入口对 Cloudflare 的流量做了拦截”。
第三步,查防火墙。 看源站的防火墙规则和云厂商安全组,发现昨晚做过一次安全加固,把 443 的入站来源改成了白名单模式,只放行了自家办公 IP 和监控 IP,Cloudflare 的回源 IP 段不在白名单里,连接被默默丢弃,正是 522 的典型成因。
第四步,修复与验证。 从官网拿到 Cloudflare 最新 IP 段列表,逐段加入安全组和防火墙的 80/443 放行规则。改完等一分钟,刷新网站恢复正常;再用第一节的命令复查解析与响应头,确认橙云代理状态正常。
第五步,留痕复盘。 把”源站防火墙白名单必须包含 Cloudflare IP 段”写进运维备忘,并在监控里给网站加一条可用性探测——这次故障从发生到恢复全靠用户上报,说明缺的不是技术,是监控。
整个过程没有动过 Cloudflare 侧任何设置。522 先查源站防火墙对 Cloudflare 段的放行,这是命中率最高的一条。
预防清单:让故障少发生
排障能力决定下限,预防决定上限。收官之前给一份短清单,也是对整个系列的收束:
- 可用性监控要独立于源站:用外部探测服务盯网站的 HTTP 状态,挂了第一时间告警到手机,不要等用户上报。
- 证书两头都盯到期时间:边缘证书 Cloudflare 管,源站证书要自己盯;“完全(严格)“模式下源站证书过期就是 526 全站故障。
- 改配置留痕:DNS、规则、加密模式每次变更记一笔时间和内容,排障时能快速回答”昨天动过什么”。
- 重大变更先灰度:规则和缓存策略先对单条路径或子域名生效,确认无误再铺全站。
- 源站防火墙与 Cloudflare IP 段同步更新:Cloudflare 的 IP 段有变动时,源站白名单要跟着更新,这条写进定期巡检。
至此 Cloudflare 实战系列十篇全部完成:从接入、DNS、SSL、缓存、规则、WAF、Tunnel、Workers、R2 到排障,构成了一条从”把域名搬进来”到”出事能自己修”的完整链路。真遇到错误码时别慌——先二分,再对码,最后动手改一处验一处,基本都能收敛到根因。
小结
- 排障第一步不是改配置,而是用二分定位法分清故障在 Cloudflare 边缘还是源站:切灰云、curl —resolve 直连、看错误页归属,三种方法互为印证。
- 5xx 是回源链路故障:521 查服务监听,522 查防火墙对 Cloudflare IP 段的放行,524 是源站慢,525/526 是源站 TLS 与证书问题,且与加密模式强相关。
- 重定向死循环的元凶是”灵活模式 + 源站强制 HTTPS”,正解是改”完全(严格)“并配好源站证书。
- 1xxx 多为配置问题:1000/1016 查 DNS 记录,1033 是 Tunnel 没运行,1101 是 Worker 代码异常。
- 403 拦截、缓存旧页、TLS 版本报错这三类”假象故障”要会认,别误伤源站配置。
- 源站侧三件套:放行 Cloudflare 官方 IP 段、会看回源日志、用 CF-Connecting-IP 还原真实访客 IP。
- 预防胜于排障:外部监控、证书到期提醒、变更留痕、防火墙白名单与 Cloudflare IP 段同步更新。