快速开始

本指南带你从零完成接入：添加域名、配置 DNS、验证生效、接入客户端。操作本身约 10 分钟，DNS 生效时间视服务商而定（通常几分钟内）。

1. 添加域名

字段	示例
接入域名	`cdn.example.com`
回源 Endpoint	`https://pub-example.r2.dev`

接入域名不带 http:// 前缀和路径；回源 Endpoint 为对象存储源站地址，需以 http:// 或 https:// 开头。提交后打开该域名的详情页。

2. 配置 CNAME 记录

FastBlob 为每个域名固定使用 10 个 endpoint 子域（0–9），客户端从它们并行拉取数据。在你的 DNS 服务商处为每个子域添加一条 CNAME：

0.cdn.example.com   CNAME   0.proxy.fastblob-endpoint.com
1.cdn.example.com   CNAME   1.proxy.fastblob-endpoint.com
2.cdn.example.com   CNAME   2.proxy.fastblob-endpoint.com
3.cdn.example.com   CNAME   3.proxy.fastblob-endpoint.com
4.cdn.example.com   CNAME   4.proxy.fastblob-endpoint.com
5.cdn.example.com   CNAME   5.proxy.fastblob-endpoint.com
6.cdn.example.com   CNAME   6.proxy.fastblob-endpoint.com
7.cdn.example.com   CNAME   7.proxy.fastblob-endpoint.com
8.cdn.example.com   CNAME   8.proxy.fastblob-endpoint.com
9.cdn.example.com   CNAME   9.proxy.fastblob-endpoint.com

3. 验证生效

域名详情页会在你的浏览器里通过 DoH（cloudflare-dns.com 与 dns.alidns.com）实时检测每条记录的解析结果，全部记录显示为已生效即接入完成。已添加但迟迟未生效时，可在 1.1.1.1/purge-cache 主动刷新对应记录的 DNS 缓存。

也可以用命令行抽查任意一个子域：

$ curl -sI https://0.cdn.example.com/path/to/object | head -3
HTTP/2 200
content-type: application/octet-stream

HTTPS 证书在子域首次被访问时自动实时签发（详见 HTTPS 证书），无需任何手动配置。

4. 客户端接入

任一子域此时都已可以作为普通 HTTP 下载地址使用（单节点）。要获得多节点并行加速，在你的前端或客户端里接入 SDK，把它当作 fetch 的即插即用替换：

// npm install @fastblob/fastblob-fetch
import fetch from '@fastblob/fastblob-fetch'

// 传入接入域名的 URL，SDK 自动派生 0–9 子域并行拉取
const response = await fetch('https://cdn.example.com/models/llama-7b.gguf')
const blob = await response.blob()

下一步

Header 改写私有桶鉴权、缓存策略与 CORS 配置。

计费与限额 $10/TB、免费额度与充值方式。