搜索 开始使用
   
本博客由 Pipe 强力驱动

想省大钱？思源笔记第三方同步 S3 手把手教程（使用青云 QingCloud 对象存储 OSS）（2024.1.12）

一、前言

我自己折腾了很久才搞明白，写下这篇教程既是避免自己忘记操作，也是为了帮助后来者节省时间。

所以，请你在有以下需求的前提下阅读本教程，否则更应该把折腾工具的时间花在多写一些笔记上。

  • 多设备同步的需求
  • 省钱的需求

如果你绝大多数时候只在一台设备上使用思源笔记，更简单的做法是不必执着于同步笔记，更应该定期手动导出Data文件备份。其他时候记笔记可以使用 微信文件传输助手 、 手机备忘录 等应急 ，过后再整理到思源笔记。

如果比起省一些钱，你更在意少花点时间折腾，请直接 年付订阅 ，使用官方云同步服务。

※ 注意，以下是使用该教程方法的必要条件

  • 愿意为第三方存储功能与对象存储付费
  • 有绑定了你身份证信息的支付宝
  • 可以使用电脑

二、省钱，但无法免费

  1. 思源笔记第三方存储功能（功能特性）（点此进入定价页面）

    • 可接入第三方云端存储（S3/WebDAV）的 功能特性已经收费（从2024年1月，v2.12.0版本开始），一次付费后终身可用（订阅会员包含了功能特性，在会员有效期内不需要为此单独付费）
    • 目前打折价 64 元：https://b3log.org/siyuan/pricing.html

  2. 青云 QingCloud 对象存储（很便宜的，不用担心）（点此进入资费介绍页面）

    • 免费额度

      注册成功并完成认证的 QingStor 对象存储用户，青云QingCloud 为您提供一定额度的 QingStor 对象存储免费使用套餐。每个 Bucket 享有如下免费政策:

      • 标准存储空间：20 GB
      • 总外网下载流量：10 GB
      • 总外网读请求 (GET/HEAD)：100 万次
      • 总外网写请求 (PUT/POST/DELETE)：10 万次

    • 按量计费

      • 存储费用：存储总量 10GB 内免费，超过后阶梯计费，在10GB-1TB内 0.147 元/GB/月
      • 流量费用：每月下载流量 1GB 内免费，超过后阶梯计费，在1GB-3TB内 0.45 元/GB/月
      • 请求费用：0.01 元/万次

    • 对象存储的计费周期为月，每月初会根据用量自动扣除上个月费用。若当月费用扣除后余额不足，则用户的所有存储空间将会处于 暂停 状态，此时用户无法使用对象存储的任何功能。等到用户充值足够的金额后，用户的所有存储空间将会自动恢复。

三、以下是详细教程，但碰到意外情况需要自己想办法

1. 确保你可以使用思源笔记的第三方存储功能

如果你还没有付费，可以先免费试用订阅，也可以直接升级 功能特性 或 年付订阅 ：https://b3log.org/siyuan/pricing.html

当然，如果你已升级 年付订阅 ，在官方云存储剩余容量足够的前提下，不妨直接使用思源官方云同步服务。

页面如下：

  1. 打开SiYuan 设置 页面，点击 云端
  2. 云端存储服务提供商 选择 S3

image

2. 注册青云

使用电脑浏览器在这个页面注册：https://account.qingcloud.com/signup

用电脑浏览器是因为：经我实测，实名认证时通过手机扫描二维码无法上传图片，使用手机浏览器也无法上传图片。为了避免你折腾半天也上传不了图片，建议你优先尝试用电脑浏览器完成以下全部流程。

image

注册成功后可以 选择币种 和 实名认证

image

3. 在电脑网页上完成实名认证

  1. 注册成功后点击上图框选出来的 立即认证 ，或者打开这个页面（账户中心 - 认证信息）：https://console.qingcloud.com/account/profile/advanced
  2. 分别准备自己的身份证人像面与国徽面图片文件，可以手机拍照（尽量正着拍照，太歪可能无法识别）并裁切合适范围后发送图片到电脑，注意保存图片文件至容易找的目录（比如临时放在电脑桌面上）
  3. 点击 支付宝快速认证 分别上传身份证人像面与国徽面图片文件（注意满足上传格式要求）
  4. 下面的姓名和身份证号信息会在上传身份证照片后自动识别填写，识别有错误需要手动修改
  5. 按 提交 按钮
  6. 使用绑定了你身份证信息的支付宝扫码，在手机上进行验证，认证完毕后点击 我已完成认证
  7. 可以看到认证状态变为 已认证

image

image

image

4. 创建存储桶（Bucket）并设置

  1. 打开对象存储页面：https://console.qingcloud.com/gd2/qingstor/

  2. 在页面上方就近选择区域（比如我选择广东2区）

    image

  3. 创建存储桶（Bucket）

    image

  4. 设置存储桶（Bucket）名称，点击 确定

    • Bucket 名称在 Qingstor™ 对象存储中是全局唯一的，只要这个名称的存储桶（Bucket）没有被任何人创建过，你可以使用你喜欢的任意名称；如果你不想思考名称，可以参照我的格式创建：siyuan-电话号码

      image

  5. 鼠标移动到新建的存储桶（Bucket）上，右键单击，点击 复制 Bucket URL ，先临时粘贴到某个地方，待会要用

    image

  6. 鼠标移动到新建的存储桶（Bucket）上，右键单击，点击 设置

    image

  7. **（如果你知道这是什么并且需要的话）**启用版本管理

    image.png

  8. **（如果你知道这是什么并且需要的话）**生命周期管理添加规则（按照下图顺序进行设置）

    image.png

    image.png

    这个要一次性设置好，否则你再次进入设置界面时，操作对象会默认给你改为 对当前版本操作，到时候文件被删了就麻烦了

‍

5. 创建API密钥

  1. 在页面右上角打开 API 密钥 ，或者访问此页面

    image

  2. 创建 API 密钥

    image

  3. 填写名称和描述后提交image

  4. 及时下载（只有一次下载机会），找一个位置保存文件，并妥善备份

    image

  5. 使用记事本打开文件（文件名为 access_key.csv），在单引号内的字符串（不包括单引号）分别对应着 Acess Key和 Secret Key

    image

6. 配置 SiYuan 云端设置

  1. 打开SiYuan 设置 页面，点击 云端

    image

  2. 云端存储服务提供商 选择 S3

    image

  3. Endpoint 输入访问地址（格式大致为：http://s3.<zone-id>.qingstor.com/）

    输入访问地址的流程如下：

    • 在第4步的第5小步你得到了 Bucket URL ，现在把它复制一下

    • 然后粘贴在 Endpoint 中，并将存储桶的名称部分（ <bucket-name> ）改为 S3 。比如我设置的存储桶名称是：siyuan-12345678901 ，那么就将 https://siyuan-12345678901.gd2.qingstor.com 改为 https://s3.gd2.qingstor.com/ 。（注意链接中字母的大小写不要错了）

      image

    注：本教程使用 Path Style（风格）的访问地址，所以格式大致为：http://s3.<zone-id>.qingstor.com。其中，<zone-id> 是指你在第4步创建存储桶时选择的区域所对应的代码，你可以参照下图表格填写，当然最简单的是按照前述的方法复制粘贴。

    官方文档内容：

    image

  4. Acess Key 输入你在第5步第5小步获取的 qy_access_key_id

  5. Secret Key 输入你在第5步第5小步获取的 qy_secret_access_key

  6. Bucket 输入你的存储桶名称，如我的 siyuan-12345678901

  7. Region 输入区域代码，这里似乎任意输入都可行，但我还是按照自己的区域输入了 gd2

  8. Addressing 选项改为 Path-style

  9. TLS Verify 默认

  10. 开启 启用云端同步

  11. 开启 同步冲突时生成冲突文档

  12. 云端同步模式 按照需求设置：

    • 自动同步（数据不再变动后 30 秒进行一次同步）
    • 手动同步（仅启动和关闭软件时自动同步一次，其他时候需要手动触发同步）
    • 完全手动同步（启动和关闭时均不同步，完全手动控制同步时机和同步方向）

  13. 点击 云端同步目录 右侧 设置 ，可见账户下所有 S3 存储桶，点击目标存储桶即可

7.尝试同步

※ 注意，在使用同步功能前请认真了解《思源笔记同步指南》中的内容，这关乎你的笔记数据安全

※ 注意，在使用同步功能前请认真了解《思源笔记同步指南》中的内容，这关乎你的笔记数据安全

※ 注意，在使用同步功能前请认真了解《思源笔记同步指南》中的内容，这关乎你的笔记数据安全

  1. 导出 Data 备份好

    image

  2. 手动点击一次同步图标进行同步，如果报错，请自行定位问题。

    你可以对照教程看看哪一步做错了，也可以复制报错信息去“GPT一下”，还可以在链滴上提问…

  3. 判断是否上传成功

    • 双击进入存储桶，打开 repo 文件夹，能见到 repo 文件夹下的文件

      image

    • 理论上空间大小与手动导出的 Data 文件大小差不多

      image

    • image

  4. 在需要同步的另一台设备上按照第6步，填写同样的配置（云端同步模式可以不同）

    • 建议在使用频次较低的设备上使用 完全手动同步模式 ，每一次使用时通过 下载云端数据快照 同步从另一台设备上传的云端数据，避免数据冲突。需要注意的是：这样做并不代表你可以在多台设备上同时修改笔记，更好的方法是养成习惯：在切换设备前手动点击同步图标，等待数据完全同步至云端后关闭软件，之后再切换设备下载云端数据。
    • 建议在第一次尝试使用第三方同步功能时，在所有的设备上都使用 完全手动同步模式 ，能有效避免误操作覆盖数据

  5. 在一台设备的思源笔记 上传本地数据快照 后，在另一台设备中的思源笔记 下载云端数据快照 （不要选错，否则数据就被覆盖了）

8. 绑定微信、邮箱账号（不是必要的，但建议）

在 账户中心 - 基本信息 绑定你的其他账号：https://console.qingcloud.com/accounts/profile/basic/

image

9. 按需充值

进入存储桶，在上方选择 消费记录 页面可以查看 本月预估费用

image

对象存储的计费周期为月，每月初会根据用量自动扣除上个月费用。若当月费用扣除后余额不足，则用户的所有存储空间将会处于 暂停 状态，此时用户无法使用对象存储的任何功能。等到用户充值足够的金额后，用户的所有存储空间将会自动恢复。

以下是最新（2023-08-10）的免费额度标准：

注册成功并完成认证的 QingStor 对象存储用户，青云QingCloud 为您提供一定额度的 QingStor 对象存储免费使用套餐。每个 Bucket 享有如下免费政策:

  • 标准存储空间：20 GB
  • 总外网下载流量：10 GB
  • 总外网读请求 (GET/HEAD)：100 万次
  • 总外网写请求 (PUT/POST/DELETE)：10 万次

另外值得注意的是，在《第三方同步选择 - S3 服务商对比推荐》一文中提供的超链接内容可能已经过时

image

最新的 资费介绍页面 在：https://docsv4embed.qingcloud.com/user_guide/storage/object_storage/billing/price/

建议在同步功能正常使用后按需充值（最低充值金额为1元）：点此进入青云充值页面

‍

END

p.s.

  • 除了青云，你也可以选择其他的服务商。关于服务商的选择可以参考这篇文章：《第三方同步选择 - S3 服务商对比推荐》 ，不过具体的数据很可能已经过时，需要留意；各个厂商的配置方法大同小异。
  • 使用 S3 同步只会同步工作空间下的 repo 文件夹（里面是经过加密的文件，实际上已经包含了整个工作空间），如需单独同步工作空间目录下的某些文件或文件夹，请在关闭思源笔记后手动复制到其他设备。

如果本篇教程对你有帮助，能否请你点击本帖右下角，给我一个大大的感谢以及一个免费的赞同，还可以分享给需要的朋友。你的鼓励与支持就是我创作的最大动力。

image

‍「友情链接」：【代码片段分享】思源笔记用到现在积累的所有代码片段

本文由 a2930610542 于 2023-11-23 发布，当前已被围观  0 次，评论 1 次
并被添加 「」「」「」 标签
下一篇
推荐阅读
1 评论
greatYear • 2024-06-29
回复 删除

目前对象存储仅对企业用户开放，如有需求麻烦完成企业认证