故障排查

按现象定位问题。排查前先记住一个万能自检手段：

$ curl -sI https://0.cdn.example.com/big-buck-bunny/video.mp4
HTTP/2 200
x-accelerated-by: fastblob.com
server: fastblob-backend

响应里带 X-Accelerated-By: fastblob.com 说明请求确实经过了 FastBlob 节点；没有则问题出在 DNS 或访问的域名不对。

DNS 记录一直未生效

1. 在域名详情页查看逐条检测结果。检测在你的浏览器里通过 DoH（cloudflare-dns.com 与 dns.alidns.com）实时进行，与真实用户看到的一致。
2. 核对记录值：第 n 条必须是 n.<接入域名> → n.proxy.fastblob-endpoint.com，注意不要漏了数字前缀。
3. 确认记录类型是 CNAME 且未开启 DNS 服务商的代理功能（如 Cloudflare 的橙色云）——代理会遮蔽 CNAME 目标。
4. 到 1.1.1.1/purge-cache 刷新对应记录的公共 DNS 缓存，稍候再看。

访问返回 403「Bucket is not allowed」

域名配置开启了桶白名单，而请求 URL 的第一个路径段不在列表中。到控制台把该桶加入白名单，或改为允许全部桶。桶的定义见域名接入与 DNS。

访问返回 400「Failed to extract bucket」

开启桶白名单后，请求 URL 没有路径段（例如直接访问根路径），节点无法判断桶名。对象 URL 应形如 https://cdn.example.com/<桶>/<对象键>。

访问返回 5xx 或源站错误

• 节点返回 500：多为回源配置问题——Endpoint 拼写错误、不可达，或节点暂时取不到域名配置。到控制台核对回源 Endpoint（必须以 http:// 或 https:// 开头）。
• 源站的 401 / 403 / 404 会原样透传：先绕过 FastBlob 直接请求源站确认对象存在；私有桶需要按 Header 改写配置回源鉴权头。

浏览器提示证书错误

按 HTTPS 证书排查：绝大多数情况是 CNAME 未生效或域名未在控制台添加，证书无从签发。

浏览器报跨域（CORS）错误

网页端用 fetch / SDK 拉取时，需要在 Response Headers 中配置 Access-Control-Allow-Origin（配法见 Header 改写）。注意浏览器可能缓存了没有 CORS 头的旧响应，验证时加个一次性查询串（如 ?v=2）。

接入了但没觉得变快

• 确认客户端真的走了 SDK：普通 <a> 直链或原生 fetch 只会命中单个节点，并行加速需要接入 JavaScript SDK。
• 并行切块依赖源站支持 HTTP Range（206）。用 curl -I -r 0-1023 <源站对象 URL> 验证，返回 206 Partial Content 才支持。
• 只有 GET / HEAD 会并行加速，其他方法 SDK 会透传给原生 fetch。
• 小文件本身传输时间就短，并行收益主要体现在大文件上。

还是没解决？

写信给 support@fastblob.com，按联系支持附上域名、时间点与完整报错，通常一个工作日内回复。