menu_book

配置指南

本文档用于指导完成 Rivea 的两项常用配置：AWS S3 云同步 与 Notion 导出

cloud_sync AWS S3 云同步配置

功能说明

配置 AWS S3 后，Rivea 可以把你的数据同步到你自己的云存储空间中，用于：

  • 备份数据，防止本地数据丢失
  • 在多台设备之间同步数据
  • 在需要时恢复历史数据

在上传到 S3 之前，Rivea 会先对数据进行加密，所以 S3 中保存的是加密后的内容，不是明文。

配置前需要准备

  • 一个可登录的 AWS 账号
  • 一个你自己记得住、并且已经妥善保存的同步密码
  • 已安装并可打开的 Rivea 扩展

同步密码的作用

这个同步密码非常重要，它不是 AWS 密码，而是 Rivea 自己使用的加密密码。它有以下 3 个作用：

  • 加密你的数据 — 上传到 S3 之前，所有数据会先使用这个密码做 AES-256-GCM 加密
  • 加密你的 AWS Secret Key — 你的 AWS Secret Key 不会直接明文保存在本地，而是先加密后再存到浏览器本地存储中
  • 在同步和恢复时验证使用 — 每次点击 Sync Now 或 Restore 时，通常都需要输入这个密码
warning 重要提示

如果忘记这个密码，可能无法恢复已有同步数据。建议使用强密码，并单独保存。不要把它随意发给别人。

inventory_2 创建 S3 存储桶（Bucket）

Bucket 可以理解为你在 AWS 上创建的一个云端存储空间。

操作步骤

  1. 登录 AWS Console
  2. 进入 S3
  3. 点击 Create bucket
  4. 输入一个全局唯一的桶名称，例如：rivea-backup-yourname
  5. 选择桶所在区域（Region），例如：us-east-1 或 ap-northeast-1
  6. 其余选项如果没有特殊要求，可以先保持默认
  7. 点击创建
info 创建完成后，请记录

1. Bucket：你的桶名称 2. Region：桶所在区域

person_add 创建 IAM 用户与权限

Rivea 访问 S3 时，不是直接使用 AWS 主账号，而是通过 IAM 用户的访问密钥完成。

创建 IAM 用户

  1. 登录 AWS Console
  2. 进入 IAM
  3. 点击 Users
  4. 点击 Create user
  5. 输入用户名，例如：rivea-sync-user
  6. 按页面提示完成创建

添加 S3 权限

为了让 Rivea 能正常同步和恢复数据，这个 IAM 用户至少需要对目标桶拥有以下权限：

  • s3:GetObject
  • s3:PutObject

如果需要更完整地读取桶内内容，通常还会额外授予列出对象等相关权限。

如果你不熟悉 AWS 权限配置，建议由技术同事协助设置。最重要的是确认这个 IAM 用户确实有访问目标桶的读写权限。

vpn_key 创建 Access Key 和 Secret Key

请注意，Access Key 和 Secret Key 不是在 S3 页面里创建的，而是在 IAM 用户里创建。

操作步骤

  1. 进入 IAM
  2. 打开你刚创建的用户
  3. 点击 Security credentials
  4. 找到 Access keys
  5. 点击 Create access key
  6. 按页面提示完成创建
  7. 创建完成后，复制并保存 Access Key 和 Secret Access Key
warning 特别注意

Secret Key 只会显示一次，必须在创建当下立即保存。如果当时没有保存，之后无法再次查看，只能重新创建新的密钥。

table_chart 字段对照与填写

Rivea 中各字段对照

Rivea 字段 AWS 对应 在哪里找 / 如何填写
Endpoint S3 端点 https://s3.amazonaws.com
Bucket 你创建的 S3 桶名 AWS Console → S3 → 你的桶名称
Region 桶所在区域 us-east-1, ap-northeast-1
Access Key IAM 访问密钥 IAM → Users → Security credentials
Secret Key IAM 秘密密钥 创建 Access Key 时显示一次
Path Prefix 存储路径前缀 rivea-data/

在 Rivea 中填写 AWS S3 配置

  1. 打开 Rivea 扩展设置页面
  2. 找到同步相关设置
  3. 填写 Endpoint、Bucket、Region、Access Key、Secret Key、Path Prefix
  4. 输入你的同步密码
  5. 点击保存
  6. 点击 Sync Now 测试同步是否成功

lightbulb 重要提示与排错

关键说明

info Endpoint 不需要去 AWS 页面里找

大多数情况下，直接填写 https://s3.amazonaws.com。如果系统要求使用区域端点，也可以填写类似 https://s3.us-east-1.amazonaws.com

info Access Key / Secret Key 不在 S3 页面创建

正确位置是：AWS Console → IAM → Users → 你的用户 → Security credentials → Create access key

warning Secret Key 丢失后无法找回

如果没有保存，只能重新创建新的 Access Key，并在 Rivea 中更新配置。

常见问题排查

问题 1：点击同步失败

常见原因：

  • Bucket 名称填错
  • Region 填错
  • Access Key 或 Secret Key 填错
  • IAM 用户没有目标桶的访问权限
  • Endpoint 填写错误

建议按下面顺序检查：先检查 Bucket 和 Region，再检查 Access Key 和 Secret Key 是否完整复制，最后检查 IAM 权限是否已正确授予。

问题 2：Secret Key 丢失了

  1. 回到 AWS IAM
  2. 找到对应用户
  3. 重新创建新的 Access Key
  4. 用新的 Access Key / Secret Key 更新 Rivea 配置

问题 3：不知道 Path Prefix 填什么

如果没有特殊要求，建议直接填写 rivea-data/，这样后续在桶中查找同步数据会更方便。

integration_instructions Notion 导出配置

配置 Notion 后，Rivea 可以把笔记或导出内容写入你指定的 Notion 数据库，方便你后续整理、检索和归档。

完成这项配置，你需要准备两项信息：

  • Notion Token
  • Database ID

token 创建 Integration 并获取 Token

  1. 打开 Notion Integration 页面：https://www.notion.so/my-integrations
  2. 点击 New integration
  3. 填写名称，例如：Rivea
  4. 选择对应的 Workspace
  5. 点击 Submit
  6. 创建完成后，在 Secrets 区域复制 Internal Integration Token
info Token 格式

这个 Token 通常以 ntn_ 或 secret_ 开头，这就是后面在 Rivea 中要填写的 Notion Token。

dataset 创建数据库与授权

创建 Database 并获取 Database ID

  1. 打开 Notion
  2. 新建一个页面
  3. 输入 /，选择 Table 或 Database - Full page
  4. 创建一个新的数据库
  5. 打开该数据库的整页视图
  6. 查看浏览器地址栏，复制 notion.so/ 后面、?v= 前面的那段字符串，这就是 Database ID

将 Database 授权给 Integration

即使你已经有了 Token 和 Database ID，如果数据库没有授权给对应的 Integration，Rivea 仍然无法写入 Notion。

  1. 打开刚创建的数据库页面
  2. 点击右上角 ...
  3. 找到 Connections
  4. 点击 Connect to
  5. 搜索并选择你刚创建的 Integration 名称（例如：Rivea）
  6. 完成连接
warning 这一步非常重要

很多导出失败都是因为漏做了这一步授权操作。

settings 填写 Rivea 设置与排错

在 Rivea 中填写 Notion 配置

  1. 打开 Rivea 扩展设置
  2. 找到笔记导出设置
  3. 选择导出方式为 Notion
  4. 填入 Notion Token 和 Database ID
  5. 点击保存
  6. 测试一次导出，确认是否成功写入 Notion

常见问题排查

问题 1：已填 Token 和 Database ID，但导出失败

最常见原因是数据库没有授权给 Integration。请重新检查：数据库页面 → ... → Connections → Connect to

问题 2：不知道 Database ID 应该复制哪一段

只复制数据库页面 URL 中 notion.so/ 后面、?v= 前面的内容。不要把后面的参数一起复制进去。

问题 3：Token 填了但没有效果

请检查以下几点：

  • Token 是否来自 my-integrations 页面
  • 是否复制了完整 Token
  • Integration 是否属于正确的 Workspace
  • 数据库是否也在同一个 Workspace 中