思源笔记 S3 同步设置教程

## 一、前言

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

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

- 多设备同步的需求
- 省钱的需求(仍然需要花钱)

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

如果比起省一些钱,你更在意少花点时间折腾,请直接 [年付订阅](https://link.zhihu.com/?target=https%3A//b3log.org/siyuan/pricing.html%3Fr%3DJeffreyChen) ,使用官方云同步服务。

## 二、省钱,但无法免费

1. 思源笔记第三方存储功能(功能特性)[(点此进入定价页面)](https://link.zhihu.com/?target=https%3A//b3log.org/siyuan/pricing.html%3Fr%3DJeffreyChen)

- 可接入第三方云端存储(S3/WebDAV)的 ​**功能特性已经收费**​(从2024年1月,v2.12.0版本开始),​**一次付费后终身可用**(订阅会员包含了功能特性,在会员有效期内不需要为此单独付费)
- 目前打折价 64 元:[https://b3log.org/siyuan/pricing.html](https://link.zhihu.com/?target=https%3A//b3log.org/siyuan/pricing.html%3Fr%3DJeffreyChen)
- 七牛云 [Kodo](https://zhida.zhihu.com/search?content_id=232622883&content_type=Article&match_order=1&q=Kodo&zhida_source=entity) 对象存储(**很便宜**的,不用担心)
- **免费额度**

|标准存储每月免费空间|标准存储每月免费 CDN 回源流量|标准存储每月免费写请求 PUT/DELETE|标准存储每月免费读请求 GET|每月免费上传流量|
| ----------------------| -------------------------------| -----------------------------------| ----------------------------| ------------------|
|10GB|10GB|10万次|100万次|无上限|

- 按量计费,具体看价格文档:[https://www.qiniu.com/prices/kodo](https://link.zhihu.com/?target=https%3A//www.qiniu.com/prices/kodo)

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

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

如果你还没有付费,可以先免费试用订阅,也可以直接升级 功能特性​ 或 年付订阅​ :[https://b3log.org/siyuan/pricing.html](https://link.zhihu.com/?target=https%3A//b3log.org/siyuan/pricing.html%3Fr%3DJeffreyChen)

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

页面如下:

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

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-e7e1a801162ce999a1b7d52d954c0519_r-20251123204952-zdkwhcu.jpg)

## 2. 注册七牛云

### 注意,帖子最初写于 2024 年,如果注册流程在之后有变化,请随机应变。

​**点击打开七牛云官网**​:[https://www.qiniu.com/](https://link.zhihu.com/?target=https%3A//s.qiniu.com/euIjyi)

点击页面右上角「立即注册」,按流程注册:

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-3192ed74652c31fbc655d92d5880ae9a_r-20251123204952-mbt3exg.jpg)

注册成功后,账号类型选择「个人用户」:​

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-259733b2e61b4592a9aa35c74bf2cc60_r-20251123204952-7d62bqy.jpg)

前往 [https://portal.qiniu.com/developer/user/security](https://link.zhihu.com/?target=https%3A//portal.qiniu.com/developer/user/security) 绑定微信,然后可能会退出登录,此时重新登录即可

前往 [https://portal.qiniu.com/developer/user/identity](https://link.zhihu.com/?target=https%3A//portal.qiniu.com/developer/user/identity) 完成实名认证:

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-4db6f33baa038f9030b98b6411fe730b_r-20251123204951-eap0blk.jpg)

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-f669cd9c0659e0d5c7561330f56fca65_r-20251123204951-kig9iij.jpg)

用手机微信扫码,输入姓名和身份证号,再扫脸验证(扫码之后如果页面打不开,请点击二维码下方的「刷新」后重新扫码):


![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-1a838065827ff6b4f678654caf9e3487_r-20251123204951-qfamgvh.jpg)

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-743b46c37b43c751eaf7791c8a0c3df3_r-20251123204952-jlmbnka.jpg)

## 3. 创建存储桶(Bucket)并设置

打开 [https://www.qiniu.com/products/kodo](https://link.zhihu.com/?target=https%3A//www.qiniu.com/products/kodo) ,点击「立即使用」:

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-41f3bd01277219cd64db617df1f81d32_r-20251123204952-5lz4ret.jpg)

新建空间(也就是 Bucket )(空间名复制备用):


![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-489f54cf7e71fe34357aca801b2c0f4a_r-20251123204951-fjou3bj.jpg)

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-46b7b560a67854de4b2b92af7b75b30c_r-20251123204951-xgrx31q.jpg)

## 4. 配置 SiYuan 云端设置

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

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-e7e1a801162ce999a1b7d52d954c0519_r-20251123204952-zdkwhcu.jpg)

1. **Endpoint** 输入访问地址(格式大致为: `http://s3.【【这里填区域简称 Region ID】】.qiniucs.com/`​ )  
    获取方法如下:  
    打开 [https://developer.qiniu.com/kodo/4088/s3-access-domainname](https://link.zhihu.com/?target=https%3A//developer.qiniu.com/kodo/4088/s3-access-domainname) ,按照页面说明复制刚刚创建的空间对应的区域 Region ID 字符串,组合成一个链接: `http://s3.【【这里填区域简称 Region ID】】.qiniucs.com/` :

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-b2866b1ca4952cc331045fbd85269db9_r-20251123204951-v2kwc97.jpg)

1. 输入 **Acess Key** 和 **Secret Key**  
    获取方法如下:  
    前往 [https://portal.qiniu.com/developer/user/key](https://link.zhihu.com/?target=https%3A//portal.qiniu.com/developer/user/key) 复制 AccessKey (AK) 和 SecretKey (SK) :

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-c29f8b78595517ceb06b316ac7bb9a54_r-20251123204951-63wdrau.jpg)

1. **Bucket** 输入你的存储桶名称,也就是你创建的空间的名称
2. **Region** 输入区域简称 Region ID ,之前在 [https://developer.qiniu.com/kodo/4088/s3-access-domainname](https://link.zhihu.com/?target=https%3A//developer.qiniu.com/kodo/4088/s3-access-domainname) 中查找过
3. **Timeout (s)**  默认为 30 。这个是超时时间,在数据量大或者网速慢的情况下需要改大一些
4. **Addressing** 改为 **Path-style**
5. **TLS Verify** 默认为 **Verify**
6. **启用云端同步** 在看完教程之后再开启,不着急
7. **同步冲突时生成冲突文档** 按需开启
8. **云端同步模式** 按照需求设置:

- 自动同步(数据不再变动后 30 秒进行一次同步)
- 手动同步(仅启动和关闭软件时自动同步一次,其他时候需要手动触发同步)
- 完全手动同步(启动和关闭时均不同步,完全手动控制同步时机和同步方向)
- 点击 **云端同步目录** 右侧 **设置** ,应该可见账户下所有 S3 存储桶,点击目标存储桶即可

## 5.尝试同步

### ※ 注意,在使用同步功能前请认真了解[《思源笔记同步指南》](https://link.zhihu.com/?target=https%3A//ld246.com/article/1683395267749%3Fr%3DJeffreyChen)中的内容,这关乎你的笔记数据安全

### ※ 注意,在使用同步功能前请认真了解[《思源笔记同步指南》](https://link.zhihu.com/?target=https%3A//ld246.com/article/1683395267749%3Fr%3DJeffreyChen)中的内容,这关乎你的笔记数据安全

### ※ 注意,在使用同步功能前请认真了解[《思源笔记同步指南》](https://link.zhihu.com/?target=https%3A//ld246.com/article/1683395267749%3Fr%3DJeffreyChen)中的内容,这关乎你的笔记数据安全

1. 导出 Data 备份好

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-f69b2b94add0cfc82e3d900fdcc19cac_r-20251123204951-zkfm79f.jpg)

1. 打开 **启用云端同步** 开关,手动点击一次顶栏的同步图标进行同步,如果报错,请自行定位问题。  
    *你可以对照教程看看哪一步做错了,也可以在*​*[链滴](https://link.zhihu.com/?target=https%3A//ld246.com/)*​*上提问…*
2. 点击进入空间,查看存储量,判断是否上传成功:

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-7d678c4fbf667eef5704a2b59f6c41ce_r-20251123204951-tpg6iju.jpg)

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-d88ff78ddcf1a5c414cf9dedce14d29a_r-20251123204951-ydcsfz7.jpg)

1. 在配置好的设备上导出配置文件的压缩包,然后在其他需要同步的设备中导入:

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-705b9121cbf8ee0e8290efdb1bc5f895_r-20251123204951-cq5350y.jpg)

1. 在其他设备上调整其他选项(不同设备,选项可以不同):

- **启用云端同步** 在确认无误之后再开启,不着急
- **同步冲突时生成冲突文档** 按需开启
- **云端同步模式** 按照需求设置:

  - 自动同步(数据不再变动后 30 秒进行一次同步)
  - 手动同步(仅启动和关闭软件时自动同步一次,其他时候需要手动触发同步)
  - 完全手动同步(启动和关闭时均不同步,完全手动控制同步时机和同步方向)
- 建议在使用频次较低的设备上使用 **完全手动同步模式**​ 并关闭 **同步冲突时生成冲突文档**​ ,每一次使用时通过 **下载云端数据快照** 同步从另一台设备上传的云端数据,避免数据冲突。需要注意的是:这样做并不代表你可以在多台设备上同时修改笔记,更好的方法是养成习惯:在切换设备前手动点击同步图标,等待数据完全同步至云端后关闭软件,之后再切换设备下载云端数据。
- 建议在第一次尝试使用第三方同步功能时,在所有的设备上都使用 **完全手动同步模式**​ ,能有效避免误操作覆盖数据,之后再把常用设备改为 **自动同步**
- 点击 **云端同步目录** 右侧 **设置** ,应该可见账户下所有 S3 存储桶,点击目标存储桶即可

## 6. 按需充值

可以在财务中心查看费用与充值:[https://portal.qiniu.com/financial/overview](https://link.zhihu.com/?target=https%3A//portal.qiniu.com/financial/overview)

![](https://b3logfile.com/file/2025/11/siyuan/1763878244266/assets/v2-2a6a5b400b1127b73fd93592ed657022_r-20251123204952-7p8c9cj.jpg)

## **END**

p.s.

- 除了七牛云,你也可以选择其他的服务商。关于服务商的选择可以参考这篇文章:[《第三方同步选择 - S3 服务商对比推荐》](https://link.zhihu.com/?target=https%3A//ld246.com/article/1668672970787%3Fr%3DJeffreyChen) ,不过​**具体的数据很可能已经过时**,需要留意;各个厂商的配置方法大同小异。
- 使用 S3 同步只会同步工作空间下的 ***repo*** 文件夹(里面是经过加密的文件分块,不包含整个工作空间),如需单独同步工作空间目录下的某些文件或文件夹,请在关闭思源笔记后手动复制到其他设备。

‍「友情链接」:[【代码片段分享】思源笔记用到现在积累的所有代码片段](https://link.zhihu.com/?target=https%3A//ld246.com/article/1700551933609%3Fr%3DJeffreyChen)

如果本篇教程对你有帮助,能否请你点击: [阅读原文](https://link.zhihu.com/?target=https%3A//ld246.com/article/1692089679062%3Fr%3DJeffreyChen) ,给原文增加一点浏览量,以及为这篇知乎文章点一个「赞同」与「收藏」。你的鼓励与支持就是我创作的最大动力。
  • Sandbox

    如果帖子标签含有 Sandbox ,则该帖子会被视为“测试帖”,主要用于测试社区功能,排查 bug 等,该标签下内容不定期进行清理。

    466 引用 • 1241 回帖 • 611 关注

相关帖子

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...

推荐标签 标签

  • 单点登录

    单点登录(Single Sign On)是目前比较流行的企业业务整合的解决方案之一。SSO 的定义是在多个应用系统中,用户只需要登录一次就可以访问所有相互信任的应用系统。

    9 引用 • 25 回帖 • 8 关注
  • 快应用

    快应用 是基于手机硬件平台的新型应用形态;标准是由主流手机厂商组成的快应用联盟联合制定;快应用标准的诞生将在研发接口、能力接入、开发者服务等层面建设标准平台;以平台化的生态模式对个人开发者和企业开发者全品类开放。

    15 引用 • 127 回帖
  • NetBeans

    NetBeans 是一个始于 1997 年的 Xelfi 计划,本身是捷克布拉格查理大学的数学及物理学院的学生计划。此计划延伸而成立了一家公司进而发展这个商用版本的 NetBeans IDE,直到 1999 年 Sun 买下此公司。Sun 于次年(2000 年)六月将 NetBeans IDE 开源,直到现在 NetBeans 的社群依然持续增长。

    78 引用 • 102 回帖 • 724 关注
  • BAE

    百度应用引擎(Baidu App Engine)提供了 PHP、Java、Python 的执行环境,以及云存储、消息服务、云数据库等全面的云服务。它可以让开发者实现自动地部署和管理应用,并且提供动态扩容和负载均衡的运行环境,让开发者不用考虑高成本的运维工作,只需专注于业务逻辑,大大降低了开发者学习和迁移的成本。

    19 引用 • 75 回帖 • 702 关注
  • 星云链

    星云链是一个开源公链,业内简单的将其称为区块链上的谷歌。其实它不仅仅是区块链搜索引擎,一个公链的所有功能,它基本都有,比如你可以用它来开发部署你的去中心化的 APP,你可以在上面编写智能合约,发送交易等等。3 分钟快速接入星云链 (NAS) 测试网

    3 引用 • 16 回帖
  • 30Seconds

    📙 前端知识精选集,包含 HTML、CSS、JavaScript、React、Node、安全等方面,每天仅需 30 秒。

    • 精选常见面试题,帮助您准备下一次面试
    • 精选常见交互,帮助您拥有简洁酷炫的站点
    • 精选有用的 React 片段,帮助你获取最佳实践
    • 精选常见代码集,帮助您提高打码效率
    • 整理前端界的最新资讯,邀您一同探索新世界
    488 引用 • 384 回帖
  • OpenStack

    OpenStack 是一个云操作系统,通过数据中心可控制大型的计算、存储、网络等资源池。所有的管理通过前端界面管理员就可以完成,同样也可以通过 Web 接口让最终用户部署资源。

    10 引用 • 8 关注
  • frp

    frp 是一个可用于内网穿透的高性能的反向代理应用,支持 TCP、UDP、 HTTP 和 HTTPS 协议。

    17 引用 • 7 回帖 • 1 关注
  • Python

    Python 是一种面向对象、直译式电脑编程语言,具有近二十年的发展历史,成熟且稳定。它包含了一组完善而且容易理解的标准库,能够轻松完成很多常见的任务。它的语法简捷和清晰,尽量使用无异义的英语单词,与其它大多数程序设计语言使用大括号不一样,它使用缩进来定义语句块。

    561 引用 • 677 回帖 • 1 关注
  • jsDelivr

    jsDelivr 是一个开源的 CDN 服务,可为 npm 包、GitHub 仓库提供免费、快速并且可靠的全球 CDN 加速服务。

    5 引用 • 31 回帖 • 120 关注
  • 深度学习

    深度学习(Deep Learning)是机器学习的分支,是一种试图使用包含复杂结构或由多重非线性变换构成的多个处理层对数据进行高层抽象的算法。

    45 引用 • 44 回帖 • 2 关注
  • V2Ray
    1 引用 • 15 回帖 • 4 关注
  • Sublime

    Sublime Text 是一款可以用来写代码、写文章的文本编辑器。支持代码高亮、自动完成,还支持通过插件进行扩展。

    10 引用 • 5 回帖 • 1 关注
  • TensorFlow

    TensorFlow 是一个采用数据流图(data flow graphs),用于数值计算的开源软件库。节点(Nodes)在图中表示数学操作,图中的线(edges)则表示在节点间相互联系的多维数据数组,即张量(tensor)。

    20 引用 • 19 回帖
  • SEO

    发布对别人有帮助的原创内容是最好的 SEO 方式。

    36 引用 • 200 回帖 • 54 关注
  • 职场

    找到自己的位置,萌新烦恼少。

    127 引用 • 1708 回帖 • 1 关注
  • Wide

    Wide 是一款基于 Web 的 Go 语言 IDE。通过浏览器就可以进行 Go 开发,并有代码自动完成、查看表达式、编译反馈、Lint、实时结果输出等功能。

    欢迎访问我们运维的实例: https://wide.b3log.org

    30 引用 • 218 回帖 • 663 关注
  • Eclipse

    Eclipse 是一个开放源代码的、基于 Java 的可扩展开发平台。就其本身而言,它只是一个框架和一组服务,用于通过插件组件构建开发环境。

    76 引用 • 258 回帖 • 641 关注
  • 工具

    子曰:“工欲善其事,必先利其器。”

    308 引用 • 773 回帖
  • 浅吟主题

    Jeffrey Chen 制作的思源笔记主题,项目仓库:https://github.com/TCOTC/Whisper

    2 引用 • 34 回帖 • 1 关注
  • iOS

    iOS 是由苹果公司开发的移动操作系统,最早于 2007 年 1 月 9 日的 Macworld 大会上公布这个系统,最初是设计给 iPhone 使用的,后来陆续套用到 iPod touch、iPad 以及 Apple TV 等产品上。iOS 与苹果的 Mac OS X 操作系统一样,属于类 Unix 的商业操作系统。

    89 引用 • 150 回帖 • 1 关注
  • abitmean

    有点意思就行了

    44 关注
  • ZooKeeper

    ZooKeeper 是一个分布式的,开放源码的分布式应用程序协调服务,是 Google 的 Chubby 一个开源的实现,是 Hadoop 和 HBase 的重要组件。它是一个为分布式应用提供一致性服务的软件,提供的功能包括:配置维护、域名服务、分布式同步、组服务等。

    61 引用 • 29 回帖 • 14 关注
  • Windows

    Microsoft Windows 是美国微软公司研发的一套操作系统,它问世于 1985 年,起初仅仅是 Microsoft-DOS 模拟环境,后续的系统版本由于微软不断的更新升级,不但易用,也慢慢的成为家家户户人们最喜爱的操作系统。

    232 引用 • 484 回帖 • 1 关注
  • Scala

    Scala 是一门多范式的编程语言,集成面向对象编程和函数式编程的各种特性。

    13 引用 • 11 回帖 • 180 关注
  • ZeroNet

    ZeroNet 是一个基于比特币加密技术和 BT 网络技术的去中心化的、开放开源的网络和交流系统。

    1 引用 • 21 回帖 • 667 关注
  • Kubernetes

    Kubernetes 是 Google 开源的一个容器编排引擎,它支持自动化部署、大规模可伸缩、应用容器化管理。

    119 引用 • 54 回帖