如何用 Cloudflare R2 同步影书 infolio 知识库
用 Cloudflare R2 作为影书 infolio 自定义同步源的准备清单：bucket、S3 API endpoint、Access Key、region auto、权限和恢复验证。
快速结论
Cloudflare R2 适合已经使用 Cloudflare，或者想用 S3 兼容对象存储管理个人知识库同步的人。准备时重点确认 bucket、Account ID、S3 API endpoint、Access Key、Secret Access Key 和 region auto。
步骤
新建专用 R2 bucket
在 Cloudflare R2 中为影书创建独立 bucket，不要和网站静态资源、备份归档或其他应用混用。独立 bucket 更容易控制权限、账单和故障排查。
- 使用能识别用途但不包含隐私信息的 bucket 名称。
- 不要把多个应用的数据写进同一个前缀。
- 记录 Cloudflare Account ID 和 bucket 名称。
准备 S3 API 连接信息
R2 提供 S3 兼容 API。连接时通常需要 endpoint、bucket、Access Key ID、Secret Access Key 和 region。Cloudflare 官方文档中 R2 的 S3 region 使用 auto；如果工具不允许 auto，空值或 us-east-1 也会映射到 auto。
- 确认 endpoint 来自 Cloudflare R2 控制台。
- region 优先填写 auto。
- 不要把 R2 凭证写进普通文档或公开截图。
创建最小必要权限的 R2 token
为影书单独生成 R2 API token 或 S3 兼容访问密钥，避免复用 Cloudflare 账号级高权限凭证。权限范围应只覆盖影书使用的 bucket。
- 单独保存 Access Key ID 和 Secret Access Key。
- 给凭证备注用途和创建日期。
- 后续如果停止使用，优先禁用这组专用凭证。
在影书中配置自定义同步源
把 R2 的 endpoint、bucket、region 和访问凭证填入影书的自定义同步源配置。保存前再次核对 bucket 名称和 endpoint，避免把数据写到错误账号或错误 bucket。
- 确认网络可以访问 R2 endpoint。
- 先用小规模测试知识库验证同步。
- 出现 403 时优先检查 token 权限和 bucket 范围。
用第二台设备验证恢复
配置成功不等于恢复可靠。用另一台设备连接同一 R2 同步源，确认文档、桌面、白板和加密库能够按预期恢复，再把它作为长期同步方案。
- 确认普通文档和白板能恢复。
- 确认加密库入口和设备认证正常。
- 定期检查 R2 使用量和异常请求。
相关页面
常见问题
Cloudflare R2 的 region 应该怎么填？
R2 的 S3 API region 通常使用 auto。Cloudflare 文档说明空值或 us-east-1 也会映射到 auto，但配置影书时建议优先按产品提示填写。
R2 同步等于自托管影书吗？
不是。R2 只是自定义同步存储层。影书仍然是本地优先应用，不是你自己部署的 Web 服务。