思源笔记 S3 同步 | 思源笔记用户指南

type

status

date

slug

summary

什么是 S3 协议？

S3 是一个对象存储的公共协议，目前国内主流的云服务厂商如阿里云、腾讯云、七牛云等等都会提供兼容 S3 协议的对象存储的服务。您可以选择任意一家您熟悉的支持对象存储的服务提供商来配置思源的 S3 同步。

S3 存储的价格

几乎所有服务商的对象存储服务，都是分为两个计费项的：

流量计费；

存储空间计费；

存储空间计费比较好理解，就是为你存储空间占用的硬盘容量付钱。

流量付费对于小白来说可能没有听说过，因为商用宽带是很贵的，所以云服务厂家为您提供服务时，需要收取带宽的流量费用。一般情况下来说，都是上传不计费，下载才计费。

举个例子，您使用思源笔记，将本地的文件同步到 S3 时，使用的是 上传 宽带，这一部分是不计费的；而在另外一台设备上，将云端的内容同步到本地时，使用的是 下载，这一部分就需要计费了。

如果您的设备不多，这部分由同步产生的下载流量费用是不高的。

下面是云服务商的价格计算器，可以根据自己的情况模拟计算价格

价格计算器 | 对象存储 - 七牛云 (qiniu.com)

对象存储价格计算器 - 腾讯云 (tencent.com)

💡

各家的 S3 存储价格相差不大，根据自己的喜好选择即可

配置思源 S3 同步

1. 初始化数据仓库密钥

初次使用思源时，创建了一个工作空间后，要做的第一件事是在 设置-关于 中，初始化你的仓库密钥。思源会使用这个密钥进行端到端加密，密钥只有你当前使用的设备能知道。

导入密钥：如果你已经有一个云端同步空间是在另外一台设备上同步云端数据，则选择导入密钥，导入和原有设备相同的密钥即可

自动生成密钥：如果这是一个新的工作空间，可以选择自动生成一个密钥

密钥初始化完毕后，这里会显示复制密钥字符串，如果你需要在其他设备上同步这个工作空间的内容，可以在这里复制密钥，然后在另外一台设备上（比如手机 app 或者另外一台电脑）思源 app 设置的 设置-关于-数据仓库密钥 中，选择导入密钥。两台设备只有密钥一致，才能正确解密云端同步的数据。

2. 思源 S3 同步界面

思源的 S3 同步界面是在 右上角按钮-设置-云端 里面的，在使用同步功能之前，需要先在账户一栏登录你的思源账户（用于验证是否购买了订阅）。

首先登录思源账户，用于验证是否已购买。（功能特性或年付订阅）

登录后，点击设置中的 云端，云端存储服务提供商 选择 S3 下方的配置内容，在后面的云服务商板块获取信息。

区域1️⃣的信息从云服务商板块获取信息，选择一个你任何合适的服务商即可。（跳转），区域2️⃣保持默认即可

启动云端同步：打开 同步冲突时生成冲突文档：建议打开 云端同步模式：建议选自动同步点击设置 → 点击加载出的存储桶

返回思源笔记首页，点击左上角云朵图标，会变成旋转图标，过一会如果恢复成云朵图标，没有报错，就是同步成功了。

3.1 配置腾讯云 COS

注册腾讯云，并按提示完成实名认证

打开腾讯云的对象存储板块（直达），点击 创建存储桶

按照下面的要求填写存储桶信息，然后点击 下一步

1️⃣ 所属区域：影响不大，建议选择离你近的城市或者北上广深一线城市

2️⃣ 名称：根据你的喜好填写，如果有多个空间方便区分即可（记录！对应思源笔记中的 Bucket）

3️⃣ 访问权限：选择私有读写，这代表只有相关密钥的软件才可以访问

在 高级可选配置 页面中，服务端加密勾选 SSE-COS ，然后点击 下一步。在 确认配置 页面点击 创建

点击 头像 → 访问管理 → 创建用户 ，完成子账户创建

选择 自定义创建

选择 可访问资源并接收消息 ，点击 下一步

填写用户名（随意命令）→ 勾选 编程访问 → 点击 下一步 后，按照系统提示完成验证。

搜索框输入 QCloudResourceFullAccess → 搜索 → 勾选策略用于设置账户权限，点击 下一步

直接 下一步 ，不需要设置。在 审阅信息和权限 页面核对完信息后点击完成即可。

完成创建用户后，点击复制，将复制 Secretld 和 SecretKey 粘贴在记事本备用。

📌

示例：

主账号ID 4546673453466 用户名 yonghuming 登录密码 - SecretId AKIDeUYjnpiDwhFiMezb2EMr6nOgXrBPXRCp SecretKey hAGUgS5awKbmprQmZDey5rALSQCoMpOt

回到 对象存储 页面，点击 存储桶列表 （直达），点击创建好的存储桶名称。

点击 概览 ，将 存储桶名称 、所属区域（复制括号内的）、访问域名 复制到记事本备用。

📌

示例：

siyuannote-1252207933

ap-shanghai

https://siyuannote-1252207933.cos.ap-shanghai.myqcloud.com

回到思源笔记填写配置信息（跳转），然后完成后面的步骤。

Endpoint：填写 访问域名 （去除存储桶的名称）https://cos.ap-shanghai.myqcloud.com

Access Key：填写第 11 步获取的 Secretld 值（记得删除多余的空格）

Secret Key：填写第 11 步获取的 SecretKey 值（记得删除多余的空格）

Bucket：存储桶名称

Region：所属区域（括号内的）

3.2 配置七牛云 KODO

打开七牛云官网，注册账户并完成实名认证。

打开对象存储 Kodo ，点击 立即使用

点击 新建空间 在弹出的窗口填写信息

1️⃣ 存储空间名称：根据你的喜好填写，如果有多个空间方便区分即可（记录！对应思源笔记中的 Bucket）

2️⃣ 存储区域：影响不大，建议选择离你近的城市或者北上广深一线城市

3️⃣ 访问控制：选择私有，这代表只有相关密钥的软件才可以访问

点击确定后，会弹出如下的提示。这里是很多新手朋友不太理解的一点，什么是测试域名？为什么有效期只有 30 天？实际上，这个域名是用于公开 bucket 的访问的，刚刚我们创建 bucket 的时候已经选择了私有，这个域名对于思源同步来说没有任何用处，也就不用管他的 30 天过期说明！直接点击 好的,我知道了 忽略这个提示即可！

现在我们已经创建了一个新的 bucket，点击它的名字，即可进入 bucket 的管理页面

在 bucket 的空间概览中，可以看到当前 bucket 的存储空间占用量，以及外网流出流量统计。我们需要记录的是右下角的这个存储空间域名。这个存储空间域名的格式如下所示

回到思源的配置中，现在可以填写一部分内容了

Bucket：对应刚刚你创建的存储空间的名字，在我的示例中，是 siyuan-bucket-1;

Endpoint：填写域名中除了 bucket 名字以外的部分，即 https://s3.cn-east-1.qiniucs.com；

Region：填写域名中显示的区域名字，即 cn-east-1；

还剩下两个内容分别是 Access Key 和 Secret Key，正如它们的名字翻译过来的结果，这两个是访问你这个 bucket 的用户密钥，也是你的七牛云账户的密钥。这是你的私密信息，请一定不要将用户密钥发送给任何人或发送到论坛上！

这两个密钥的获取位置是在七牛云界面的右上角，鼠标移动到你的用户头像位置，会弹出一个选择框，点击里面的密钥管理。

这里我已经创建过两组密钥了，我不记得新用户进到这个界面时是否会有一个创建密钥的提示了。总之你可以创建一组密钥，然后分别复制这里的 AK 和 SK，填写到思源笔记的 Access Key 和 Secret Key 中，同步配置就完成了！

如果你认为你的七牛云密钥已经泄漏，可以选择停用密钥，停用后删除这个密钥，再重新创建一个新密钥即可。

填写完毕后，点击下方的启用云端同步

在同步方式中，可以选择前文提到过的三种不同方式。对于电脑客户端而言，选择自动同步或者手动同步都是可以的；而对于手机 APP 而言，强烈推荐选择完全手动同步。

这里又会出现另外一个会让小白感到困扰的设置，在云端同步目录的设置中，你会发现你的七牛云账户里面的所有 bucket 都会显示出来。但是！刚刚在 S3 的同步配置中有一个 Bucket 填写项，我们使用的 Bucket 已经在填写项目中被固定了，所以这里的 bucket 选项是毫无意义的！它是留给 WEBDAV 协议选择文件路径使用的！使用了 S3 协议后，请忽略这个 云端同步目录 配置项。

正如前文提到过的，请针对每一个工作空间配置一个对应的 Bucket，请不要多个工作空间公用同一个 bucket！