思源笔记云同步 - 腾讯云 COS 存储

思源笔记支持的同步方式（官方称为“云端存储服务提供商”）有三种，分别是

• SiYuan，思源笔记官方
• S3，兼容 AWS S3 标准的对象存储
• WebDav，基于 HTTP 协议的方法

本文主要讨论在 S3 同步方式中使用腾讯云对象存储服务（COS），内容包含云服务购买，后台存储桶创建，客户端配置等三部分内容。

思源笔记使用 S3 同步前提

• 购买“功能特性”或“年付订阅”，详情查看官网：定价 - 思源笔记
• 在客户端登录已购买服务的账号

请确认自己的账号是否满足设置条件。

云服务购买

根据腾讯云官方文档，要使用 COS，可能会被收取存储容量费用，请求费用、数据拉取费用、流量费用和管理功能费用。详情可以查看腾讯云 COS 计费概述。

在本文的使用环境中，即使用 COS 同步思源笔记，不使用各项高级功能。则会被收取存储容量费用、请求费用和流量费用。

特别说明

如无特别说明，本文中的“费用”均为中国大陆地区的费用标准。

如无特别说明，本文出现的“存储容量”指的是“标准存储容量”

存储容量购买

存储容量指的是能够在 COS 中存储的文件大小。详情查看 COS 存储容量费用。

如果初次使用 COS 功能的个人用户，腾讯云提供了 6 个月共 50G 的免费存储容量。具体内容可以查看腾讯云 COS 免费额度。推荐先尝试再付费。

如果无法使用免费额度，并且不希望使用计量付费方式的用户，可以购买标准存储容量包。

标准存储容量包经常参加促销活动，推荐先在各促销活动中寻找合适容量套餐。

标准存储容量包购买后可以立即生效，因此可以随时增加容量。

请求次数购买

请求次数指的是腾讯云 COS 接收到的请求指令次数。详情查看 COS 请求费用。

请求次数每个月会重置，例如购买了 1 年 10 万次请求读写，意思是每个月可以抵扣 10 万次读写请求，持续 1 年。

资源包容量不仅要考虑笔记内容多少，还要考虑同步频率和插件多少，每次同步都会消耗请求次数，并且根据本人测试，插件更新后的同步会明显增加请求次数。

请求次数资源包基本不参加促销活动，并且可以购买后立即生效，因此可以先买最小的，使用几个小时之后看看请求次数的数据，再考虑是否增加购买。

流量购买

COS 的流量有多种，本文指的是外网下行流量，即从腾讯云服务器到用户的流量消耗。用户上传到 COS 的流量是不计费的。详情查看 COS 流量费用。

流量每个月会重置，例如购买了 1 年 10GB 流量，意思是每个月可以从 COS 服务器下载 10GB 的流量，持续 1 年。

流量包容量会明显受到同步客户端的数量的影响，其他因素造成的流量使用比较小。。

如果是单客户端使用，由于上传到 COS 是不计费的，因此不管同步多少次，流量消耗都较少；如果是多客户端使用，在多个客户端之间同步文件，每次同步都会下载新的文件，此时消耗的流量会明显增多。

流量资源包基本不参加促销活动，可以购买后立即生效，因此可以先买小再根据实际情况增加。

本人购买实践

综上所述，本人购买的资源包为：

• 标准存储容量，10GB，1 年
• 外网下行流量，10GB，1 年
• 读写请求，100 万次，1 年

作者购买行为不作为消费建议，请按实际使用需求消费。

轻量对象存储

最近腾讯云推出了一个名为“轻量对象存储”的项目，内容为 100GB 存储容量 +10GB 流量。

目前只能在促销活动页面购买，详情可以查看开年上云活动-首单特惠（无推广）。

根据产品概述，轻量对象存储与对象存储类似，但无需考虑容量、流量、读写请求之间的搭配。

如果只是用于思源笔记同步，轻量对象存储是一个更加优秀的选择。

注意事项

本人并未对轻量对象存储项目进行测试，上述内容根据产品概述得来。

‍

云端存储创建

购买好了各项资源，则可以创建云端存储服务了。

主要分为存储桶创建、授权子账号创建、设置权限、待填写信息整理等四个部分的内容。

创建存储桶

1. 进入控制台，搜索“对象存储”，点击搜索结果中的“控制台入口”，再点击控制台入口中的“对象存储”

2. 点击左侧“存储桶列表”

3. 点击“创建存储桶”

4. 完成信息填写

   1. 地域：建议选择离自己最近的地域
   2. 名称：建议用 21 个随机小写字母和数字组成的字符串
   3. 版本控制：建议开启
   4. 多 AZ 特性：不建议开启，标准存储容量开启后会额外收费
   5. 极智压缩：会额外收费
   6. 日志存储：开启与否随意
   7. 存储桶标签：随意
   8. 服务端加密：不建议开启

5. 确认配置后点击“创建”

至此，存储桶创建完成。

关于服务端加密

根据对象存储 服务端加密概述，非匿名用户在使用体验上并无差别，但：

1. 思源笔记本身自带端到端加密，额外加密并无必要
2. 应用服务端加密需要在操作 API 时特殊设置，不确定思源笔记是否支持

综上，为了避免产生不必要的问题，不推荐开启。

创建子账号

创建了存储桶之后，需要创建用来填写在思源笔记中的 API 密钥，达到允许上传和下载文件的目的。

创建 API 密钥有两种方式：

• 主账号密钥：非常不推荐，该类密钥的权限高，对账号整体造成安全隐患
• 子账号密钥：推荐，可以限制访问权限，避免安全风险

创建子账号密钥的方法如下：

1. 点击左侧“常用工具”

2. 点击“密钥管理”

3. 会被引导访问“访问密钥”，点击页面中央的“访问密钥”

4. 点击左侧“用户”，再点击“用户列表”

5. 点击新建用户

   1. 点击快速创建
   2. 用户名：随意
   3. 访问方式：选择“选择编程访问”
   4. 用户权限：取消所有勾选，即取消所有权限
   5. 取消勾选“需要重置密码”
   6. 点击“创建用户”
   7. 复制保存“SecretId”和“SecretKey”

至此，子账号创建完成，此时子账号是不能用于笔记同步的，因为它没有存储桶的访问权限，因此接下来需要授予该子账号权限。

设置权限

返回对象存储控制台面板进行授权设置

1. 点击“存储桶列表”
2. 点击刚刚创建的存储桶
3. 点击“权限管理”，再点击“存储桶访问权限”
4. 点击“添加用户”
5. 下拉框选择“子账号”，账号 ID 点击“空白框”后选择刚刚创建的子账号
6. 权限勾选“数据读取”和“数据写入”
7. 点击确定

至此，COS 方面的设置都完成了。

待填写信息整理

在整理填写信息前，需要先说明 COS 访问域名的结构。

以在“南京地域”创建一个名为“test”的存储桶为例，COS 的访问域名类似这样：

https://test-1111111111.cos.ap-nanjing.myqcloud.com

• 白色部分 - “https://”：传输协议
• 蓝色部分 - “test”：是存储桶的名称，即用户创建存储桶时的自定义名称
• 红色部分 - “1111111111”：腾讯云 ID
• 绿色部分 - “ap-nanjing”：地域代码，当前说明存储桶地区是南京
• 白色部分 - “myqcloud.com”：固定域名

在弄清楚了 COS 的访问域名结构之后，就可以拆分获取需要的信息了：

• EndPoint：https://cos.ap-nanjing.myqcloud.com
• Access Key：创建子账号时保存“SecretId”
• Secret Key：创建子账号时保存的“SecretKey”
• Bucket：test-1111111111
• Region：ap-nanjing
• Timeout(s)：30
• Addressing：Virtual-hosted-style
• TLS Verify：Verify

客户端配置

前提条件

思源笔记使用 S3 同步需要

• 购买“功能特性”或“年付订阅”，详情查看官网：定价 - 思源笔记
• 在客户端登录已购买服务的账号

同步信息填写

在已经有权限进行相关设置的前提下，接下来进行思源笔记客户端同步设置：

1. 打开“设置”，点击“云端”，选择“云端存储服务提供商”为“S3”
2. 参考上文待填写信息整理[^1]部分的内容填写
3. 开启选项：“启用云端同步”

端到端加密密钥

进行云同步之前，需要先设置端到端加密密钥。

• 打开“设置”

• 点击“关于”

• 找到“数据仓库密钥”，根据情况选择下列一种方式

  • 导入密钥：将其他设备上的密钥字符串复制到此粘贴导入
  • 自动生成密钥：使用随机数生成密钥，该方式只需在一台设备上执行一次，其他设备使用导入密钥
  • 通过密码生成密钥：使用自定义的密码短语生成密钥，该方式需要在所有设备上都使用相同的密码短语

开始同步

完成了上述设置之后，就可以开始愉快的同步了。

第一次同步时需要手动点击思源笔记界面左上角小云朵的标志进行一次手动同步，之后就会自动同步了。

‍