存储接入 — CloudDrive v3.0

存储接入

所有后端，都是同一套动作。#

① 网盘那边备钥匙注册 → 建桶/建应用 → 复制字符串

→

② 本站填表管理后台 → + 添加账户 → 选类型

→

③ 验证创建并验证连接 → 检测 → 回根目录看新盘

统一入口：顶栏管理后台 → + 添加账户 → 选类型（gdrive / zoho / mega / b2 / s3 / webdav）→ 按下面对应选项卡填表 → 创建并验证连接。
账户名称可留空（自动生成如 MEGA01）；凭据经 AES-GCM 加密存库；创建前会自动做一次真实连接测试，失败直接告诉原因。
实际生效上限 = 项目限制 ∩ Cloudflare 平台 ∩ 后端官方，三者取最小。

四个最常见的翻车点：① 区域 / 地址抄错（pCloud 美欧区是两个地址；InfiniCloud 每人节点不同；B2 Endpoint 去桶详情页抄）；② Koofr / InfiniCloud 必须用应用专用密码，登录密码直连必失败；③ S3 的 Endpoint 少了 https://；④ GDrive / Zoho 拿到的是 Access Token 而不是 Refresh Token（前者几小时就过期）。

本地盘

KV / R2：绑定即用，不走添加账户。#

KV · 小文件热盘

20MB / 文件 · 总量默认 900MB（管理后台可调）

每日按次数算：写 1000 个不同 key，读 10 万次；写爆 429，次日 00:00 UTC 恢复。有 R2 绑定时 KV 写超限自动转存 R2。

R2 · 大文件主力（推荐）

5GB / 文件 · 总量默认 9000MB · 零出站费

≤5MB 走 Worker 代理；5–10MB 预签名直传；>10MB 自动分片续传。免费 10GB/月，大文件、分享热门文件首选。

分后端教程

点你的网盘，对着填。#

字段名与站内表单一致，* 为必填。

Google Drive（OAuth 接入，支持增量同步）

① 去 Google 那边准备：网盘 drive.google.com（个人免费 15GB）→ console.cloud.google.com 建 OAuth 客户端，拿到 Client ID / Client Secret，再授权换到 Refresh Token（长期有效的那串，不是 Access Token） → 在 Drive 里定好作为本站根的文件夹，复制其文件夹 ID。

本站字段	填什么
Client ID *	Google Cloud 控制台复制
Client Secret *	Google Cloud 控制台复制
Refresh Token *	授权换到的长期 Token
文件夹 ID *	Drive 根文件夹 ID（本站读写范围的根）

② 验证：创建并验证连接 → 回根目录见新盘 → 传一个小文件试试。

限制：经本站单文件 ≤5GB；日上传 750GB/用户（含复制，撞墙当日禁传、24h 恢复）；API 日下载 1TB（超限 403/429 指数退避）。超大文件走 R2，别硬塞 GDrive。

Zoho WorkDrive（OAuth 接入，支持增量同步）

① 去 Zoho 那边准备：zoho.com/workdrive 注册（免费版 5GB 团队空间 / 单文件 1GB）→ api-console.zoho.com 建应用拿 Client ID / Secret / Refresh Token → 记下 WorkDrive 根文件夹 ID → 确认你的账号区域（美 / 欧 / 印 / 中）。

本站字段	填什么
Client ID *	Zoho API 控制台复制
Client Secret *	Zoho API 控制台复制
Refresh Token *	授权换到的长期 Token
文件夹 ID *	WorkDrive 根文件夹 ID
API / Accounts / Download Domain（可选）	非美区才填，如欧区 `https://www.zohoapis.eu` / `https://accounts.zoho.eu` / `https://download.zoho.eu`

限制：单文件取最小（项目 5GB ∩ 本站直传 100MB ∩ 套餐上限），免费版实际 ≤1GB；>100MB 自动切续传；空间满报 507/509。区域域名选错是头号翻车点，检测失败按提示补域名。

MEGA 原生 API（推荐无自托管用户，会话续接）

① 准备会话：先去 mega.nz 注册并完成邮箱验证 → 在本站管理后台左侧打开 MEGA 小工具，输入邮箱密码生成一次 sid + mk（只用生成一次）。密码直连已下线（免费版 Worker 算不出 Hashcash，必超时），不要再找密码字段。

本站字段（选"原生 API 直连"）	填什么
MEGA 邮箱 *	登录邮箱
会话 ID *	小工具输出的 sid
主密钥 base64 *	小工具输出的 mk（与 sid 成对）
根目录 handle（可选）	留空 = Cloud Drive 根

仅支持 v2 新账号；极老 v1 账号会明确报错，请改 MEGA 中转；开了 2FA 的先关闭或改中转。
实时读取，无全量导入、无定时同步，创建后回根目录即见新盘。

防封：会话续接不触发风控。别反复删建账户、反复点检测、多地 IP 同登；新 IP 首次登录后去邮箱点"新设备确认"；不要点 MEGA 设置里"注销所有会话"（会作废本站 sid）；被封（EBLOCKED）就停一切登录等 2–24h，再用小工具重生成会话。

限制：单文件 ≤64MB（Worker 内存墙）；>64MB 用中转或 R2/B2。owner 下载大文件自动走浏览器直连解密，不受此墙约束。

MEGA 会话小工具：输入邮箱密码获取会话 ID 与主密钥 — **MEGA 会话小工具**：站内输入邮箱密码生成一次 sid + mk，填入上面表单即可（密码直连已下线）。

MEGA WebDAV 中转（自托管桥接，突破 64MB）

适用：v1 老账号、API 被限流、单文件 >64MB、想零加解密透传。① 先自托管 MEGAcmd（webdav 命令）或 mega-webdav 桥接，拿到可访问的 WebDAV 地址。

本站字段（选"WebDAV 中转"）	填什么
WebDAV 中转地址 *	桥接地址，如 `https://nas:4443`
WebDAV 用户名（可选）	桥接有鉴权才填
WebDAV 密码（可选）	桥接有鉴权才填

Worker 以标准 WebDAV 客户端对接，不做 MEGA 加解密；上限回到项目 5GB 硬顶。

Backblaze B2（S3 兼容，按量付费，大文件盘）

① 去 B2 那边准备：backblaze.com 注册 → 建桶（Bucket）→ 建 Application Key → 去桶详情页抄 S3 Endpoint（格式 s3.<region>.backblazeb2.com，如 s3.us-east-005.backblazeb2.com）。

本站字段	填什么
Key ID *	Application Key ID
Application Key *	Application Key（只显示一次，建完即复制）
Bucket *	已建好的桶名
Endpoint / Region（可选，填其一）	Endpoint 可填裸主机名或完整 URL；不知道就填 Region（如 `us-west-004`）

上传分流：≤5MB 走 Worker 代理；>5MB 预签名 PUT + confirm（不经过 Worker）。
单文件 5GB；总量默认 9000MB（可调）；前 10GB 存储免费；出站月均存储 3 倍内免费，超出约 $0.01/GB。

S3 兼容通用（含 Tigris 实测通过）

AWS S3 / MinIO / Wasabi / Storj / Tigris 等都能接：Endpoint + Bucket + Key 即接，无需逐个适配。先到服务商处建桶并创建 Access Key。

本站字段	填什么
Key ID / Access Key *	Access Key ID（Tigris 以 `tid_` 开头）
Secret Key *	Secret（Tigris 以 `tsec_` 开头）
Bucket *	已建好的桶名
Endpoint *	完整地址，如 `https://s3.us-east-1.amazonaws.com`；Tigris 填 `https://t3.storage.dev`；MinIO 可填 `http://IP:9000`
Region（可选）	留空由 Endpoint 自动解析；Tigris 可填 `auto`
桶内前缀（可选）	如 `backups/disk`，多账户共用一桶时隔离

连不上先查三处：Endpoint 是否带了 https://、桶名大小写、Region 是否留空自动解析。Tigris 单一全球 Endpoint，零出站费，适合放公开分享的热门文件。

WebDAV 通用（pCloud / Koofr / InfiniCloud 已实测）

标准 WebDAV（Basic 认证 + PROPFIND/GET/PUT/MKCOL/DELETE）：Nextcloud / ownCloud / 群晖 / 各网盘的 WebDAV 都能接。

本站字段	填什么
WebDAV 地址 *	如 `https://host/dav`
用户名 / 密码（可选）	无鉴权留空；Koofr、部分服务商必须用应用专用密码（登录密码直连不行）
基目录（可选）	如 `/cloud-drive`，多账户共用一地址时隔离

实测服务	公网地址（按账号选）	账号要点
pCloud（免费 10GB 起）	美区 `https://webdav.pcloud.com` 欧区 `https://ewebdav.pcloud.com`	用户名 = 注册邮箱；开了 2FA 按邮件提示放行；选错区连不上
Koofr	`https://app.koofr.net/dav/Koofr`	必须用网页端头像 → Preferences → Password 生成的应用专用密码；子目录写法 `/dav/Koofr/子目录`
InfiniCloud（免费 20GB 起）	`https://<你的节点>.infini-cloud.net/dav/`	节点名去 My Page 查，每人不同，别抄别人的；用用户 ID + 应用专用密码；长期不用可能被回收
Nextcloud / 群晖 / Alist	`https://你的域/remote.php/dav/files/用户名/` 等	先用桌面客户端（Cyberduck）连通，再把同一地址抄进本站

单文件回到项目 5GB 硬顶；总量与日量只受服务商侧约束；服务端空间满多报 507。

上限对照

单文件 / 总量 / 每日量，一张表看完。#

后端	单文件（实际生效）	总量 / 日量	超限表现
KV	20MB	默认 900MB · 写 1000 次/天	400 / 413 / 429（次日恢复）
R2	5GB	默认 9000MB · 无日 GB 上限	413（全局满）
Google Drive	5GB（经本站）	日传 750GB/用户 · 日下載 API 1TB	403 / 429，等 24h
Zoho	免费版 1GB	无日上限，按套餐空间	400 切续传 · 507 空间满
MEGA 原生	64MB	免费 20GB 起	400 → 换中转或 R2/B2
MEGA 中转	5GB	= 桥接账号空间	同 MEGA 官方规则
B2	5GB	默认 9000MB · 无日上限	413（全局满）
S3 / WebDAV	5GB	按桶 / 账号空间	413 配额满 · 4xx 填表错

Cloudflare 免费计划：真正的隐形天花板

项目	Free 额度	影响
Worker 请求体	100MB	整包经过 Worker 的上传天花板；R2 MPU / 预签名直传 / Zoho 续传不受影响——大文件选 R2 的根本原因
Workers 调用	10 万请求/天，CPU 10ms/次	PBKDF2 固定 1 万次迭代正是受此约束，勿调高
KV	读 10 万/天 · 写 1000/天 · 存 1GB	单值上限 25MB（项目 20MB 更早拦截）
R2	10GB/月，零出站费	大文件与热门分享首选
D1	单库 500MB · 单行 2MB	文件内容不进 D1（只存元数据），基本无影响

配额

三层检查，超了不自动恢复。#

① 单文件上限上面对照表

→

② 账户独立配额-1 无限 · 0 继承全局

→

③ 后端全局限额quota_cap_*（MB）

层	在哪调	超限
账户独立配额	账户列表每行配额框（MB，`-1`=无限，`0`=跟随全局）	413：调高该账户配额或删其文件
后端全局限额	管理后台存储设置 `quota_cap_*`（MB，`0`=不限）；默认 kv=900 / r2=9000 / b2=9000，gdrive/zoho/mega/s3/webdav 默认不限	413：调高或清理该后端文件

配额统计的是当前存了多少（累计总量），不是每日用量；上传落库时增、删除时扣；下载不计配额。配额面板 20s 缓存，跨节点最多延迟 20s。

选盘建议

≤20MB 任意盘（含 KV 秒传）；20MB–5GB 走 R2（分片续传）或 B2（预签名）。
>64MB 不进 MEGA 原生盘；Zoho 免费版单文件实际 ≤1GB；GDrive 日传 750GB，大批量备份请错峰。
公开分享的热门文件不要放 MEGA 盘（传输配额先被下光，Tigris / R2 更合适）；匿名收集场景保证 R2 已绑定（否则 20MB 封顶）。

存储占用情况：各后端用量、占比与明细 — **存储占用情况**：各后端 / 账户用量、占比、明细表，配额快满时先看这里。