跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

收集网站故障排除信息

最后更新 查看 MarkdownAgent 设置

关于本指南

为了诊断问题,请尽可能多地捕获相关信息,并向 Cloudflare 支持团队提供充分的详细信息,这一点非常重要。本文介绍如何收集 Cloudflare 支持团队通常要求提供的故障排除信息。


快速参考:选择合适的工具

使用下表可根据您遇到的问题快速确定应采用哪种故障排除方法:

问题类型 推荐工具 适用场景
页面无法正确加载 HAR 文件 视觉问题、页面元素损坏、页面加载缓慢
JavaScript 错误 控制台日志 CORS 错误、脚本运行失败、浏览器端错误
协议错误(QUIC/HTTP2) NetLog 转储 ERR_QUIC_PROTOCOL_ERROR, ERR_HTTP2_PROTOCOL_ERROR
响应时间缓慢 curl(性能) 测量延迟和 TLS 握手时间
HTTP 错误(5xx、4xx) curl(HTTP 错误) 确定错误是源自 Cloudflare 还是源站
缓存问题 curl(缓存) 缓存未命中、内容陈旧、缓存标头
SSL/TLS 证书问题 curl(SSL/TLS) 证书错误、TLS 版本问题
连接超时/中断 Traceroute / MTR 网络路径问题、跃点之间的延迟
特定网络无法访问网站 Traceroute / MTR 怀疑 ISP 阻止 Cloudflare IP 前缀
丢包、连接重置 数据包捕获 第 3/4 层问题、SSL 握手失败
确定提供服务的位置 Cloudflare 数据中心 确定由哪个 Cloudflare PoP 处理请求

基于浏览器的故障排除

这些工具直接从 Web 浏览器捕获信息,可用于诊断页面加载和呈现方式的问题。

生成 HAR 文件

HTTP 存档 (HAR) 会记录所有 Web 浏览器请求,包括请求和响应标头、正文内容以及页面加载时间。请务必使用无痕模式或隐私浏览窗口。

部分浏览器需要安装浏览器扩展才能生成 HAR,另一些浏览器则无法生成 HAR。安装浏览器扩展时,请遵循扩展提供商的说明。

在 Chrome 中

  1. 在无痕模式下打开浏览器页面,右键单击任意位置,然后选择 检查元素。

  2. Chrome 开发者工具会显示在浏览器底部或左侧。点击 网络 选项卡。

Chrome 开发者工具中的 HAR 网络选项卡截图
  1. 选中 保留日志。如果报告的是 Cloudflare 缓存问题,也请选中 停用缓存。

  2. 点击录制按钮。

Chrome 开发者工具中的 HAR 录制按钮
  1. 访问出现问题的网址。问题复现后,点击开发者工具顶部的“导出 HAR”选项。

Chrome 开发者工具中的 导出 HAR 选项。

  1. 将 HAR 文件附加到支持工单。

Firefox

  1. 在隐私窗口中,打开应用程序菜单并选择 工具 > Web 开发者 > 网络,或按 Ctrl+Shift+I(Windows/Linux)或 Cmd+Option+I(OS X)。

  2. 访问出现问题的网址。

  3. 复现问题后,右键单击并选择 另存所有内容为 HAR。

Microsoft Edge

  1. 在 InPrivate 窗口中打开 开发人员工具(快捷键为 F12),然后选择 网络 选项卡。

  2. 访问出现问题的网址。

  3. 复现问题后,点击 导出为 HAR,然后点击 另存为...。

Safari

  1. 在 Safari 中,确保浏览器窗口顶部的隐私窗口中显示 开发 菜单。否则,请前往 Safari > 偏好设置 > 高级,然后选择 在菜单栏中显示“开发”菜单。

  2. 前往 开发 > 显示网页检查器。

  3. 访问出现问题的网址。

  4. 按住 Ctrl 并点击网页检查器中的资源,然后点击 导出 HAR。

移动设备

Android:

  1. 在移动设备上启用 USB 调试模式。

  2. 前往 chrome://inspect/#devices。

  3. 启用调试模式后,您会在下方的“远程目标”中看到设备,如下例所示:

Android 调试模式下“检查设备”的位置。
  1. 输入网址,选择 打开 和 检查,以打开 Chrome 开发者工具。

  2. 在开发者工具窗口中选择 网络 选项卡。

  3. 选中 保留日志。如果报告的是 Cloudflare 缓存问题,也请选中 停用缓存。

  4. 点击 录制。

Chrome 开发者工具中录制按钮的位置。
  1. 访问出现问题的网址。问题复现后,在 网络 选项卡中右键单击任意项目,然后选择 将所有内容另存为 HAR。
如何保存 HAR 内容。
  1. 将 HAR 文件与受影响 Samsung 设备的屏幕录制一并附加到支持工单。有关如何在 Samsung 设备上录屏的说明,请参阅 Samsung 文档 ↗。

iPhone:

请参阅 Okta ↗ 或 Apple 支持文章 ↗,了解如何从 iOS 设备生成 HAR 文件。将 HAR 文件与受影响 iOS 设备的屏幕录制一并附加到支持工单。Apple 设备现已内置屏幕录制功能 ↗。

导出控制台日志

在某些情况下,请求未发出或被浏览器取消(例如由 CORS ↗ 导致)时,除了 HAR 文件外,我们还需要获取 JS 控制台日志输出来确定根本原因。

在 Chrome 中

  1. 在开发者工具栏中打开 控制台 选项卡。
  2. 打开控制台设置并选择 保留日志。
  3. 保持控制台打开,并执行可复现问题的步骤。
  4. 在 控制台 选项卡中的任意项目上右键单击,然后选择 另存为 日志文件。
  5. 将日志文件附加到支持工单。
Chrome 开发者工具中控制台选项卡的位置。

Firefox

  1. 在 Web 开发者工具栏中打开 控制台 选项卡。
  2. 打开控制台设置并选择 保留日志 和 显示时间戳。
  3. 保持控制台打开,并执行可复现问题的步骤。
  4. 右键单击,选择 全选 消息,然后选择 将可见消息导出到文件。
  5. 将日志文件附加到支持工单。

Microsoft Edge

  1. 在开发者工具栏中打开 控制台 选项卡。
  2. 打开控制台设置并选择 保留日志。
  3. 保持控制台打开,并执行可复现问题的步骤。
  4. 在 控制台 选项卡中的任意项目上右键单击,然后选择 另存为 日志文件。
  5. 将日志文件附加到支持工单。

Safari

  1. 在网页检查器栏中打开 控制台 选项卡。
  2. 勾选 保留日志。
  3. 保持控制台打开,并执行可复现问题的步骤。
  4. 选择所有消息,右键单击,然后选择 保存所选内容 以保存为日志文件。
  5. 将日志文件附加到支持工单。

捕获 NetLog 转储

在某些情况下,为了进一步排查协议相关问题(例如 ERR_QUIC_PROTOCOL_ERROR、ERR_HTTP2_PROTOCOL_ERROR 等),支持团队可能会要求您提供 NetLog 转储 ↗。

  1. 打开新标签页,根据所用浏览器输入以下地址:
  • chrome://net-export
  • edge://net-export
  • opera://net-export
  1. 点击 开始记录到磁盘 按钮。
  2. 在另一个标签页中复现网络问题。 (chrome://net-export/、edge://net-export/ 或 opera://net-export 标签页必须保持打开,否则记录会自动停止。)
  3. 点击 停止记录 按钮。
  4. 将日志文件附加到支持工单。

命令行故障排除

这些工具可在终端或命令提示符中运行,无需浏览器开销即可测试连接、性能和服务器响应。

确定为请求提供服务的 Cloudflare 数据中心

我们的数据中心地图 ↗列在状态页面的位置视图 ↗中,并按洲排序。 数据中心名称中的三字母代码是最近的主要国际机场的 IATA 代码 ↗。 要确定为浏览器请求提供服务的 Cloudflare 数据中心,请访问: http://``_www.example.com_``/cdn-cgi/trace.

将 www.example.com 替换为您的域名和主机名。查看输出中的 colo 字段。

使用 curl 排查请求问题

curl ↗ 是用于发送 HTTP/HTTPS 请求的命令行工具,可用于排查以下问题:

  • HTTP/HTTPS 性能
  • HTTP 错误响应
  • HTTP 标头
  • API
  • 比较服务器/代理响应
  • SSL 证书

运行以下命令,向网站发送标准 HTTP GET 请求(将 www.example.com 替换为您的主机名):

curl -svo /dev/null http://www.example.com/

此 curl 命令示例会返回详细说明 HTTP 响应和请求标头的输出,但会丢弃页面正文。curl 输出可确认 HTTP 响应,并显示 Cloudflare 当前是否正在为该站点代理流量。

请查看以下部分,了解排查 HTTP 错误、性能、缓存和 SSL/TLS 证书问题的提示:

HTTP 错误

排查 Cloudflare 响应中的 HTTP 错误时,请直接向源 Web 服务器发送请求,以测试错误是否由源站导致。要排查 HTTP 错误,请直接向源 Web 服务器 IP 地址运行 curl,绕过 Cloudflare 代理:

curl -svo /dev/null http://example.com --connect-to ::203.0.113.34

性能

curl 可通过 -w 或 --write-out curl 选项 ↗测量 HTTP/HTTPS 请求的延迟或性能下降。以下 curl 示例会测量请求事务中的多个性能指标,例如 TLS 握手、DNS 查询、重定向和传输所需的时间:

curl -svo /dev/null https://example.com/ -w "\nContent Type: %{content_type} \
\nHTTP Code: %{http_code} \
\nHTTP Connect:%{http_connect} \
\nNumber Connects: %{num_connects} \
\nNumber Redirects: %{num_redirects} \
\nRedirect URL: %{redirect_url} \
\nSize Download: %{size_download} \
\nSize Upload: %{size_upload} \
\nSSL Verify: %{ssl_verify_result} \
\nTime Handshake: %{time_appconnect} \
\nTime Connect: %{time_connect} \
\nName Lookup Time: %{time_namelookup} \
\nTime Pretransfer: %{time_pretransfer} \
\nTime Redirect: %{time_redirect} \
\nTime Start Transfer: %{time_starttransfer} \
\nTime Total: %{time_total} \
\nEffective URL: %{url_effective}\n" 2>&1

Cloudflare 博客中的计时输出说明 ↗介绍了这些数据。

缓存

curl 有助于查看影响缓存的 HTTP 响应标头。排查 Cloudflare 缓存问题时,尤其要检查以下 HTTP 标头:

  • CF-Cache-Status
  • Cache-Control/Pragma
  • Expires
  • Last-Modified
  • s-maxage

SSL/TLS 证书

使用 curl 检查证书

以下 curl 命令会显示 Cloudflare 在 HTTPS 请求期间提供的 SSL 证书(将 www.example.com 替换为您的主机名):

curl -svo /dev/null https://www.example.com/ 2>&1 | egrep -v "^{.*$|^}.*$|^* http.*$"

要显示源站证书(假设已安装),请将下方的 203.0.113.34 替换为源 Web 服务器的实际 IP 地址,并将 www.example.com 替换为您的域名和主机名:

curl -svo /dev/null https://www.example.com --connect-to ::203.0.113.34 2>&1 | egrep -v "^{.*$|^}.*$|^* http.*$"

测试 TLS 版本

如果要排查浏览器兼容性或确认支持的 TLS 版本,可以在 curl 命令中添加 --tlsv1.X ↗ 和 --tls-max ↗ 选项来测试指定的 TLS 版本:

  • --tlsv1.0 --tls-max 1.0
  • --tlsv1.1 --tls-max 1.1
  • --tlsv1.2 --tls-max 1.2
  • --tlsv1.3 --tls-max 1.3

暂停 Cloudflare

有关详细信息,请参阅暂停 Cloudflare。


网络故障排除

这些工具有助于诊断网络级问题,例如路由问题、丢包,以及您所在位置与 Cloudflare 或源服务器之间的连接故障。

执行 traceroute

Traceroute 是一种网络诊断工具,用于测量数据包经过网络的路由延迟。大多数操作系统都支持 traceroute 命令。如果 Cloudflare 代理的网站出现连接问题并向 Cloudflare 支持团队寻求帮助,请务必提供 traceroute 输出。

请参阅以下说明,了解如何在不同操作系统上运行 traceroute。请在下方示例中将 www.example.com 替换为您的域名和主机名:

在 Windows 上运行 traceroute

  1. 打开 开始 菜单。

  2. 点击 运行。

  3. 要打开命令行界面,请输入 cmd,然后点击 确定。

  4. 在命令行提示符处输入:

IPv4:

tracert www.example.com

IPv6:

tracert -6 www.example.com
  1. 按 Enter。

  2. 您可以复制结果并保存到文件,也可以粘贴到其他程序中。

在 Linux 上运行 traceroute

  1. 打开终端窗口。

  2. 在命令行提示符处输入:

IPv4:

traceroute www.example.com

IPv6:

traceroute -6 www.example.com
  1. 您可以复制结果并保存到文件,也可以粘贴到其他程序中。

在 Mac OS 上运行 traceroute

  1. 打开 网络实用工具 应用程序。
  2. 点击 Traceroute 选项卡。
  3. 在相应的输入框中输入 域名 或 IP 地址,然后按 Trace。
  4. 您可以复制结果并保存到文件,也可以粘贴到其他程序中。

或者,在 Mac OS 终端程序中按照上面的 Linux traceroute 说明操作。

将 CF-RAY 标头添加到日志

CF-RAY 标头用于追踪网站请求经过 Cloudflare 网络的情况。排查问题时,请向 Cloudflare 支持团队提供 Web 请求的 CF-RAY 值。您也可以根据所用的 Web 服务器,使用下面对应的代码片段编辑源 Web 服务器配置,将 CF-RAY 添加到日志中:

如果请求因连接超时而失败,且没有返回 CF-RAY 标头,则该请求很可能没有到达 Cloudflare 网络。这种情况可能表明 ISP 阻止了对某些 Cloudflare IP 地址的流量。有关详细信息,请参阅 ISP 可能阻止 Cloudflare IP 地址。

Apache Web 服务器:将 %{CF-Ray}i 添加到 LogFormat

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\" %{CF-Ray}i" cf_custom

Nginx Web 服务器:将 '$http_cf_ray' 添加到 log_format

log_format cf_custom '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'$http_cf_ray';

将 Ray ID 与数据包捕获关联起来

数据包捕获会记录连接中的数据包。Ray ID 用于标识该连接中的一个请求。请同时提供两者,以便支持团队将捕获文件中的数据帧与发生缓慢或失败的请求对应起来。

  1. 在复现问题前开始数据包捕获,并让捕获持续运行。
  2. 复现缓慢或失败的请求。从 cf-ray 响应标头中记录其 Ray ID。在 Cloudflare 错误页面底部也能找到 Ray ID。如果您已在源站记录 CF-RAY 标头,也可以从日志中获取。
  3. 记录请求发生的 UTC 时间。请从运行捕获的同一主机读取时间,以确保两者使用同一时钟。
  4. 停止捕获并保存文件。
  5. 将捕获文件连同 Ray ID 和 UTC 时间一起附加到支持工单。

执行 MTR

My Traceroute(MTR)是一种工具 ↗,结合 traceroute 和 ping 来测量网络路径的运行状况,也是测试网络连接和速度的常用方法。除了显示网络路径上的跃点,MTR 还会持续更新到目标的延迟和丢包信息。您可以借此实时查看路径状况,以排查网络问题。

MTR 以类似 traceroute 的方式发现网络路径,然后定期发送数据包并持续收集信息,以更新网络运行状况和速度的视图。

与 traceroute 一样,MTR 可以使用 ICMP 或 UDP 发送数据包,但依赖 ICMP 接收返回的数据包(类型 11:超时)。

如何使用 MTR 生成网络路径报告?

在基于 NIX 的计算机上使用 MTR

通常,可按如下方式使用 MTR:

mtr -rw <dest_hostname> e.g.: mtr -rw one.one.one.one

或者,使用目标 IP 地址:

mtr -rw <dest_IP> e.g.: mtr -rw 1.1.1.1

使用 TCP 端口

mtr -P <tcp port> -T <destination ip>

请参阅此文档,了解如何分析 MTR:如何读取 MTR ↗。

运行数据包捕获

发生在第 3/4 层的问题会在请求到达 Cloudflare 日志系统之前出现,因此不会显示在 HTTP 日志中。因此,如果不进行深入的数据包级调查,连接重置、丢包或 SSL 握手失败等问题很难排查。

Cloudflare 生成的一些 HTTP 错误,例如 520、524 和 525,表明第 3/4 层可能存在潜在问题,或需要通过数据包捕获进一步调查。

如何运行数据包捕获

Cloudflare 建议使用 Wireshark ↗ 运行数据包捕获。有关如何使用命令行 tcpdump 的说明,请参阅此文章 ↗。

  1. 关闭所有可能在后台发送数据的程序或浏览器标签页,避免之后需要使用大量显示过滤器。
  2. 创建 Wireshark 捕获过滤器(更多信息请参阅此文章 ↗)。
  3. 选择相应的接口(例如 Wi-Fi:en0)。如果不确定应使用哪个接口,Wireshark 提供的各接口 I/O 图表可以帮助您判断。
  4. 点击左上角的蓝色鲨鱼鳍图标,开始捕获数据包。
  5. 在捕获运行期间复现问题。
  6. 点击左上角的红色方块图标,停止数据包捕获。
  7. 保存为 .pcap 文件,并将其附加到支持工单。

相关资源

这篇文档对您有帮助吗?