Obsidian Cloud Sync 实测：562 星的自托管同步方案，真能替代官方？

用 Obsidian 的人应该都经历过这个纠结：要不要买官方的 Obsidian Sync？

8 美元一个月(个人版),一年下来快 100 美元。功能确实挺全——跨设备同步、版本历史、冲突解决,但说实话,对于很多人的需求来说,同步这件事其实不需要这么贵。

我最近在找替代方案的时候发现了这个插件:ai-bytedance/obsidian-cloud-sync。562 星,字节跳动 AI 部门出品,MIT 协议开源。试了一圈,来分享下真实体验。

它解决了什么问题

核心就一个事:让你的 Obsidian 笔记在多个设备间同步,但不用花一分钱,数据也不用经过 Obsidian 官方服务器。

具体场景:

• 不想订阅 Obsidian Sync,但需要在手机和电脑之间同步笔记
• 公司对数据有合规要求,笔记不能走第三方服务器
• 已经有了云盘会员(坚果云、Nextcloud 等),不想再为同步功能额外付费
• 习惯用 Git 管理文档,想直接用 GitHub 做同步

核心功能

多后端支持 目前实际可用的有:

• WebDAV: 最成熟,支持坚果云、Nextcloud 等主流 WebDAV 服务
• GitHub: MVP 阶段,支持公共和私有仓库,文件的增删改查都能同步
• iCloud: UI 占位中,还没实际功能
• Google Drive / OneDrive: 规划中,还没实现

我主要测试了 WebDAV(坚果云)和 GitHub 两种模式。

WebDAV 体验 坚果云在国内的同步速度确实可以。配置好地址、账号密码之后,点一下同步按钮,笔记就双向同步了。双向模式下,两端修改会被自动合并;也可以改成仅上传或仅下载。

有个小细节:WebDAV 的文件夹创建机制是按需的,空的文件夹不会直接出现在远程,只有里面有文件的时候才会自动创建。不过不影响使用,看个人习惯。

GitHub 体验 这个模式还挺有意思的。它用一个 GitHub 仓库当同步后端,每次同步其实就是提交一个 commit。好处是天然的版本历史,GitHub 每次提交都是一个快照,想看之前的版本直接看 commit history 就行。

配置需要一个 Fine-grained Personal Access Token,权限要设置 Contents: Read and write 和 Metadata: Read-only,仓库指定 owner/repo 格式。

我用了一个私有仓库测试,4 台设备同步了 500+ 个文件,没有丢数据。GitHub 有一个限制是不支持空目录,所以空文件夹只会在包含文件时才在远程出现,跟 WebDAV 一样。

同步模式

• 双向同步:两端修改合并
• 仅上传:本地为唯一数据源
• 仅下载:远程为唯一数据源

还有个”自动同步”模式,可以设置定时同步或者在文件改动时自动触发。我试了自动同步,间隔设为 5 分钟,日常使用基本无感。

选择性同步 可以配置忽略规则:忽略特定文件、文件夹、或者扩展名。比如我忽略了 .obsidian/workspace.json(个人布局数据,不需要同步)和 .DS_Store 文件。这个对多设备使用挺重要,不然每次切换设备布局都会乱跳。

冲突处理 基础级别的冲突处理——同名文件同时修改时,会提示你手动选择保留哪个版本。没有自动合并功能,所以对于多人协作编辑同一个文件来说不太合适。单人跨设备使用没问题。

内容加密(可选) 可以选择对内容加密后再上传。密钥需要自己保存好,作者特别警告”密钥丢失将无法解密历史内容”。

加密用的是对称加密算法,端到端——数据离开本地之前就已经加密了,云盘服务商只能看到密文。对于对隐私要求高的用户,这个功能算是加分项。但加解密会消耗 CPU,大文件(比如嵌入的图片、PDF)的同步速度会受影响。

Markdown 链接转换 同步时会把 Obsidian 的 [[wikilink]] 格式转换成标准 Markdown 链接 [text](path),这样在其他编辑器打开时也能正常显示。反过来从云端下载时会把标准链接再转回来。这个功能对跨工具场景很实用。

实际使用场景

场景一:手机 + 电脑无缝写作 电脑上写完笔记,手机上的 Obsidian 打开就能看到更新。外出时手机随手记,回家电脑整理。双向同步 5 分钟一次,基本无感。

场景二:利用现有网盘 已经有了坚果云或者 Nextcloud 的付费账号,不需要为 Obsidian 的同步功能再花钱。一个插件解决问题,一年省 100 美元。

场景三:Git 爱好者的工作流 用 GitHub 做后端,天然就带版本历史。想看一周前的笔记长什么样,直接翻 GitHub commit history。对于习惯版本控制的开发者来说,这个工作流非常自然。

场景四:合规场景 有些公司对笔记工具有要求:数据不能离开公司网络。用自建的 WebDAV 服务配合这个插件,笔记始终在公司内部流转,不需要依赖 Obsidian 官方的服务器。

快速上手

# 目前只有源码安装方式
git clone https://github.com/ai-bytedance/obsidian-cloud-sync
cd obsidian-cloud-sync
npm install
npm run build

# 复制产物到 Obsidian 插件目录
cp main.js manifest.json styles.css \
  /path/to/your/vault/.obsidian/plugins/cloud-sync/

然后重启 Obsidian,在设置 → 第三方插件里启用 Cloud Sync,配置同步后端(推荐先从 WebDAV 开始测试)。

首次使用强烈建议:先用一个不重要的测试仓库试一轮,确认功能正常后再切换到真实笔记。作者也在 README 里标明了 Alpha 状态,建议备份重要笔记。

优点和槽点

真香的点:

• 完全免费开源,MIT 协议,没有任何限制
• WebDAV 模式已经相当成熟,日常使用没问题
• GitHub 模式很有创意,自带版本历史,适合开发者
• 端到端加密可选,数据安全有保障
• 选择性同步规则很实用,避免同步不需要的文件
• Markdown 链接转换让笔记可以在其他编辑器中正常打开
• 字节跳动出品,代码质量有一定保证

想吐槽的地方:

• 安装太麻烦了——必须自己 clone、build、复制,没有一键安装包
• 还没上架 Obsidian 插件市场,安装和更新都得手动操作
• Alpha 阶段,稳定性还需要时间验证(不过我用了一周没出大问题)
• 冲突处理太基础了,只有手动选择覆盖,没有智能合并
• GitHub 模式下的私有仓库 API Token 管理有点繁琐
• 大文件加密后同步性能明显下降
• 文档比较简单,遇到问题需要看源码

和 Obsidian Sync 怎么选

方案	优点	缺点	适合人群
Cloud Sync 插件	免费、自托管、可选加密	安装麻烦、Alpha 阶段、手动冲突处理	技术用户、有现成云盘
Obsidian Sync 官方	一键开通、稳定、版本历史	收费(8$/月)、数据走 Obsidian 服务器	追求稳定、不折腾的用户
iCloud Drive	免费、原生支持	国内访问不稳定、大文件慢	Apple 生态用户
Git + GitHub	版本控制、完全可控	需要 Git 知识、非原生	开发者

如果你已经在用 Obsidian Sync,功能也满足需求,不建议折腾——插件再好,折腾成本也是成本。但如果你一直嫌 Sync 太贵,或者已经有现成的云盘资源,这个插件确实能帮你省下一笔钱。

总结

562 星对于一个还没上架插件市场的 Obsidian 插件来说不算少了。说明有不少人在等一个免费的、自托管的同步方案。

Cloud Sync 插件的思路是对的:提供一个轻量级的同步层,让数据走你自己控制的通道。WebDAV 模式已经可以用,GitHub 模式对于开发者来说也很有吸引力。

但说实话,它的成熟度还比不上 Obsidian Sync 官方方案。Alpha 标签不是摆设,作者自己也说重要笔记先备份。安装流程对非技术用户也不够友好。

不过如果你属于以下画像:

• 有坚果云/Nextcloud 等 WebDAV 服务
• 习惯折腾 Obsidian 插件
• 不想为同步功能额外付费
• 对数据隐私有一定要求

那这个插件值得一试。部署一次之后,日常使用体验基本跟官方 Sync 差不多,只是免费而已。

---

关于作者

柳钉鱼，全栈开发者，GitHub 重度用户。过去 3 年 Star 了 900+ 仓库，这里只写我真正用过或深度调研过的工具。

📧 发现好工具想推荐？发邮件到 [email protected]