Vesper

自带存储桶 Pro ​

默认情况下，加密后的记录和照片由 Vesper 保存。Pro 用户可以改为存进自己的存储桶，比如 Cloudflare R2 或其他 S3 兼容服务。

为什么要用 ​

  • 超过 5 GB 的空间。 存在你自己桶里的内容不占套餐的存储额度，费用直接付给你的服务商。
  • 文件在你手里。 管理存储桶的人依然读不到内容，因为它们用你的空间密钥加密过；但文件放在你的账号下，而不是我们的。

搜索、标签和时间线仍然由 Vesper 处理，搬走的只是文件。

在 Cloudflare R2 上准备存储桶 ​

R2 有 10 GB 免费额度，下载不收流量费，很适合放手帐。

  1. 在 Cloudflare 控制台打开 R2 Object Storage，新建一个存储桶，比如 my-vesper。位置保持自动即可。
  2. 回到 R2 概览页，点 Manage API tokens → Create API token。
  3. 权限选 Object Read & Write，并限定为刚才建的那个存储桶。
  4. 创建后复制 Access Key ID、Secret Access Key 和 S3 endpoint（形如 https://<account id>.r2.cloudflarestorage.com）。Secret 只显示这一次。

不需要配置 CORS，也不需要开放公开访问。只有 Vesper 的服务器会访问这个存储桶。

其他 S3 兼容服务 ​

支持 HTTPS 和 path-style S3 请求的服务应该都能用，比如 Backblaze B2、Wasabi，或者你自己运行的 MinIO。需要准备的还是这四样：HTTPS endpoint、存储桶名称、region（比如 us-east-1；R2 填 auto），以及一个能在这个桶里读、写、删除对象的 access key。

搬运内容 ​

  1. 打开 设置 → 套餐与数据，点 改用自己的存储桶。
  2. 填入 endpoint、存储桶名称、region、access key ID 和 secret access key。
  3. 点 测试并搬运。

Vesper 会先写入一个小测试文件，读回来再删掉。如果失败，什么都不会改动，你会看到存储桶返回的错误。测试通过后，Vesper 开始复制内容，每复制完一个对象就从原来的位置删掉，并显示进度。

搬完之前请不要关闭页面，搬运期间暂时不能写入。如果关了页面或断了网，回来点 继续搬运，会从中断的地方接着搬。

access key 和你的记录一样，用空间密钥加密保存。

存储桶里有什么 ​

所有文件都在 vesper/{空间 ID}/ 下：

  • entries/{年}/{月}/{id}.md：每条记录
  • photos/{xx}/{hash}.bin 和 .thumb.bin：每张照片和它的缩略图
  • _vesper/icon.bin：空间图标

所有文件都是加密的，包括以 .md 结尾的。不要手动修改、重命名或删除它们：Vesper 保存着这些文件的索引，改动过的文件无法解密。需要能直接读的副本，请用导出。

公开记录的缩略图、公开主页的图标和分享卡片的图片仍然放在 Vesper，因为公开主页要在没有你密钥的情况下显示它们。

搬回或换一个存储桶 ​

点 搬回 Vesper 可以把内容搬回来，前提是放得下当前套餐的存储额度。想换到另一个存储桶，需要先搬回 Vesper，再搬到新的桶。每月只能搬一次，所以要换的话请提前安排。

如果存储桶无法访问了，比如 key 被吊销或桶被删除，Vesper 就读不到存在里面的记录，并会显示存储桶返回的错误。恢复访问权限，或者把导出文件导入一个新空间。