01 / FILES ON THE EDGE

交给我文件，
还你一个地址。

以根目录组织的文件存储。上传之后，文件分发在 Cloudflare 全球的静态资源 CDN 上；按路径管理，用一个 key 分享，大文件也一样。

打开个人空间 API 文档

02 / PATH OR KEY

按路径管理，按 key 分享。

每个文件有一个路径，在你的根目录里替换、列出、删除；上传时还会得到一个 key，任何人拿着它就能下载，不用登录。

fs.disk.zone/v1/<root>/photos/2026/a.jpg

fs.disk.zone/v1/<root>/photos/

fs.disk.zone/f/<key>

路径需要登录或账户 Key；/f/<key> 是公开的下载地址。

各自的根目录

用 disk.zone 账号新建，名字全站唯一，只有你能写入和列出。

全球分发

文件放进 Cloudflare 的静态资源 CDN，从离读者最近的地方读出。

大文件也行

一次请求最多约 100 MB，更大的文件分几次传，也可以用 SDK 自动分段。

一个 key 就能分享

上传返回的 key 是永久的下载凭据；多个 key 用 . 连起来，一次读完。

Range 读取

按字节范围读取，适合视频拖动和断点续传。

统一账号

和 disk.zone 的所有项目共用一个账号、一次登录、一套 API Key。

03 / HTTP API

上传是一个 PUT。

用 disk.zone 的账户 API Key 或登录状态调用；接口返回统一的 {"ok":true,"data":…}。刚上传的文件分发到 CDN 前会返回 425，稍等就能读。

# 上传（DZ_KEY 是 disk.zone 账户 API Key） curl -T a.jpg "https://fs.disk.zone/v1/<root>/photos/a.jpg" \ -H "Authorization: Bearer $DZ_KEY" → {"ok":true,"data":{"path":"photos/a.jpg","key":"…","url":"https://fs.disk.zone/f/…"}} # 按路径下载 curl -o a.jpg "https://fs.disk.zone/v1/<root>/photos/a.jpg" -H "Authorization: Bearer $DZ_KEY" # 按 key 下载，不用登录 curl -o a.jpg "https://fs.disk.zone/f/<key>"

交给我文件，还你一个地址。