存储配置

了解浏览器存储限制，以及如何配置 Cloudflare R2 实现持久云存储。

IndexedDB 存储说明

  • 所有文档和图片存储在浏览器 IndexedDB，本地优先，无需登录
  • 存储配额因浏览器和操作系统而异，通常在 500 MB 至 2 GB 之间
  • 当使用量超过配额的 70%，编辑器侧边栏底部会显示黄色警告条，并提供「立即导出备份」快捷入口

短期缓解方法

  • 定期点击侧边栏「Export」下载 ZIP 备份，然后删除已归档的旧文档释放空间
  • 粘贴图片时优先使用外链 URL，避免将大 Base64 文件存入 IndexedDB
  • 使用「归档」功能将不常用文档移出主列表，减少活跃数据占用

Cloudflare R2 配置指南

R2 免费额度：每月 10 GB 存储 + 1,000 万次 A 类操作 + 1 亿次 B 类操作，个人写作者完全够用。

1

注册 Cloudflare 并创建 R2 Bucket

  • 访问 cloudflare.com 注册免费账号
  • 进入控制台左侧菜单 → R2 Object Storage → 接受条款（需绑定付款方式，免费额度内不扣费）
  • 点击「Create bucket」→ 填写名称（如 mark-build-assets）→ 选择离你最近的区域 → 创建 
https://cloudflare.com
2

开启公开访问

  • 进入 Bucket → Settings → Public Access → 开启「Allow Public Access」
  • R2 会分配一个 pub-xxxx.r2.dev 子域作为公开访问 URL，记录该地址
  • （可选）Settings → Custom Domains → 绑定自定义域名，如 assets.yourdomain.com 
https://pub-xxxx.r2.dev
3

创建 API Token

  • Cloudflare 控制台右上角头像 → My Profile → API Tokens → Create Token
  • 选择「Create Custom Token」，权限设置：Account → R2 Storage → Edit
  • 生成后立即复制 Token（仅显示一次，无法再查看）
  • 同时记录 Account ID（在 R2 概览页面右侧显示）
4

在编辑器中配置

  • 点击编辑器顶栏右侧的齿轮图标（⚙）打开「存储配置」面板
  • 填入 Bucket 名称、Account ID、API Token、公开访问 URL，点击「保存配置」
  • 配置完成后，在编辑器中粘贴图片（Ctrl+V / Cmd+V）将自动上传到 R2，并在光标处插入图片链接
  • 导出 HTML 时图片引用 R2 公开链接，文件体积大幅减小，加载更快

安全提示

  • API Token 拥有 R2 写入权限，请勿将其泄露或提交到代码仓库
  • 建议为 Mark.build 单独创建一个权限最小的 Token（仅 R2 Storage Edit，不授予其他权限）
  • 定期在 Cloudflare 控制台检查 R2 使用量，避免意外超出计划额度