☰
Obsidian 同步指南:坚果云 WebDAV 与 Remotely Save 配置避坑
2026/10/9 2:33:37 网站建设 项目流程

如果用 Obsidian 写笔记,而且坚持了两三个月,多半会遇到一个绕不过去的坎:笔记越攒越多,电脑、手机、平板各有一份,改着改着就分不清哪边才是最新版本。我刚入坑时也干过手动拷贝、微信传文件的蠢事,结果经常出现两个同名笔记,内容还对不上。后来朋友一句话点醒我:“你把库接到坚果云上,用 WebDAV 同步不就好了?”这才接触到 Obsidian 同步神器的正确打开方式——坚果云配 Remotely Save 插件。这篇文章就是一份完整的坚果云插件食用指南,覆盖注册、配置、避坑、备份全流程,适合不想付费订阅官方 Sync、又希望多设备无感同步的 Obsidian 用户。

坚果云是国内少有的开放 WebDAV 接口的云盘,和 Obsidian 的本地文件核心天然对路。它解决的是非常具体的问题:Obsidian 把数据存成本地 Markdown 文件,只要你想在另一台设备上继续写,就必须有一个中间仓库来中转。坚果云充当这个中转仓库,插件负责把本地文件推上去、拉下来。我自己用这套方案一年半,笔记从几百篇攒到几千篇,没丢过数据,踩过的坑刚好可以整理出来,给后来的人省点时间。

1. 同步方案选型回顾与坚果云的定位

1.1 为什么说同步是 Obsidian 用户绕不开的坎

Obsidian 的核心设计是本地 Markdown 文件,好处是数据自主、迁移自由,坏处是没有内置多设备同步。官方 Sync 一年要几百块,很多人不想掏这个钱,于是同步这件事成了 Obsidian 玩家的必修课。说个场景,大家应该都有共鸣:白天在公司用电脑写了两篇笔记,晚上回家用手机翻,发现手机还停留在三周前的版本,瞬间就不太想写了。这种撕裂感足以劝退一批新手,所以同步不是“进阶玩法”,而是长期使用的基本需求。

Obsidian 官方没有开放自家 Sync 的 API,第三方插件只能另辟蹊径,最常见的是 WebDAV、对象存储和自建存储。WebDAV 和坚果云在国内的组合,赢在不折腾且稳定——注册就能用,没有复杂的服务器配置。我刚开始也以为 WebDAV 是什么黑科技,后来才明白它就是一个“网络文件夹”,Obsidian 把文件往里放,另一台设备再从里面拿,就这么简单。

1.2 我为什么最终选了坚果云

选坚果云有四个原因。第一,国内云盘对 WebDAV 支持极差,百度网盘、阿里云盘基本不走标准 WebDAV,而坚果云不仅支持,还做得比较规范。第二,国内服务器,访问速度和稳定性比国外网盘好,手机上同步几百篇笔记不用干等。第三,免费额度对纯文本笔记足够用,Markdown 加图片附件一天也就几兆到几十兆,大部分用户根本用不完。第四,应用密码机制成熟,第三方应用只能用专用密码,不会暴露主账号密码。

当时也犹豫过“坚果云免费版会不会偷偷限速”,实测下来纯文本同步完全没问题。坚果云真正会限制的是单一应用请求频率和月流量,细节放在避坑部分展开。如果你的库特别大,比如塞了视频或大量 PDF 附件,那就得掂量一下免费额度,或者考虑只用坚果云同步.md文件,附件走另一套方案——这是进阶玩法,新手不用一开始就纠结。

1.3 这些方案我也试过,但都放弃了

Git 仓库同步:技术宅最爱,但要手动 commit、push、pull,Obsidian 移动端装 Git 体验很差,附件一多仓库体积爆炸,最后我放弃了。iCloud:只在苹果生态里好用,如果同时有 Windows 或 Android,基本是灾难,Windows 端 iCloud 客户端慢且经常静默失败。OneDrive:路径嵌套过深,Obsidian 插件偶发报告异常,国内连接也不算稳定。Dropbox 就更不用提了,访问容易断,不适合当主力同步盘。

还有一点,如果你在 Linux 上装过坚果云客户端,用 WebDAV 方案时不是非留不可。我在一台 Ubuntu 机器上就完全卸载了坚果云客户端,只保留 WebDAV 配置,Obsidian 照常同步。这从侧面说明坚果云客户端只是入口,真正的存取能力在服务端。需要提醒的是,卸载 Linux 客户端时记得把~/.nutstore等配置目录也清理掉,否则重装时会残留账号信息,容易误导排查方向。

2. 坚果云官方同步插件食用指南:从零到一配置

2.1 前置准备:账号、应用密码与远程目录

第一步不需要安装任何客户端。先去坚果云官网注册账号,然后在网页端“账户信息”“安全选项”“应用密码”里生成一个专用密码。注意:这个密码只显示一次,生成后立刻复制保存,丢了就重新生成,旧的会自动失效。不要直接把坚果云登录密码填进插件,因为插件会把凭据保存在 Obsidian 的本地配置文件里,万一设备丢了,专用密码随时可以撤销,主密码暴露就很麻烦。

建议在网页端手动创建一个远程目录,比如ObsidianVault,之后插件统一往这个目录写数据。这样坚果云里的其他资料和笔记库互相隔离,将来要迁移或备份,直接处理这一个目录就行。目录名不建议用中文,虽然坚果云支持 UTF-8,但某些第三方 WebDAV 客户端对非 ASCII 路径处理并不统一,全英文最省心。

2.2 安装 Remotely Save 插件并完成 WebDAV 配置

打开 Obsidian,进入“设置”“第三方插件”,关闭“安全模式”后点击“浏览”,搜索Remotely Save,安装并启用。然后在插件设置里,Remote Service 选WebDAV,填这几个字段:

配置项填写内容
Server URLhttps://dav.jianguoyun.com/dav/(必须以 /dav/ 结尾)
Username坚果云登录邮箱
Password刚才生成的应用密码(不是登录密码)
Remote Path/ObsidianVault(对应网页端创建的目录)

填完后点Check Connection按钮,看到成功提示说明 WebDAV 已连通。这里有个新手高频踩坑点:URL 末尾漏了/dav/,或者把dav.jianguoyun.com写成了www.jianguoyun.com,都会导致认证失败。dav子域名专门为 WebDAV 协议服务,www只承载网页登录,入口逻辑完全不一样,不要混用。

提示:坚果云的应用密码和 WebDAV URL 属于敏感信息,任何情况下不要把这两样东西截图发到群里或帖子里。如果怀疑泄露,去网页端旧密码重新生成即可,比换主密码方便得多。

2.3 首次同步验证:一个小技巧让你少走弯路

刚配置完不要立刻把整个正式库同步上去。我的建议是先建一个test-vault临时库,放两三个测试笔记,连接同一个远程路径,点一次“Sync”按钮。观察这几个点:

  • Obsidian 底部状态栏会显示当前同步的文件数和剩余数;
  • 切到浏览器进入坚果云网页端,打开对应目录,看.md文件是否出现;
  • 在另一台设备上建一个空库,连同一个 WebDAV,同步下来,确认内容一致。

这套验证大约十分钟,但能提前暴露 URL 写错、应用密码复制带空格、远程路径不对等几乎所有配置问题。千万不要冲动地直接同步主库。我当年就是直接拿整个库去同步,结果卡在几万个附件列表上,排查了很久才发现是 URL 里的一个斜杠写错了。小库验证通过后再切回正式库,稳稳的。

2.4 移动端配置:手机 Obsidian 接上同一套仓库

手机端 Obsidian 同样支持 Remotely Save。Android 在应用商店安装 Obsidian 后,进入设置启用社区插件,搜索 Remotely Save,填入同样的 WebDAV 配置。iOS 流程也类似,但有一个容易忽略的点:iOS 的 Obsidian 首次进入时选Download而不是Create empty vault,否则会生成一个空库,再手动连接同步就很别扭。

移动端首次同步建议连 Wi-Fi,因为全量下载附件会消耗流量。同步完成后,Obsidian 会在本地重建完整的.obsidian配置目录,主题和插件一并下载下来,体验与电脑端基本一致。如果发现手机锁屏后同步不跑,优先检查系统电池优化设置,把 Obsidian 设为“不受限制”,否则后台同步会被系统杀掉。这个坑在 MIUI 和 iOS 上都遇到过,不提前设置好就总以为插件坏了。

3. 避坑实录:这些坑我替你踩过了

3.1 限流与频率限制:为什么突然同步失败

坚果云 WebDAV 对单个应用的并发请求有严格限制,短时间高频调用会触发 429 或 503 错误,表现就是点了同步按钮半天没反应,或插件提示请求过于频繁。这个限制平时不会触发,但两种场景最容易中招:一是第一次全量同步,大量小文件排队上传;二是自动同步间隔设得太短,比如一分钟一次,稍微有点风吹草动就去请求。

应对方法有三条。一是首次同步前先手工点一次同步,让插件自己分批处理;二是把自动同步间隔拉长到五到十分钟,Obsidian 笔记不是聊天工具,晚几分钟同步完全能接受;三是在 Remotely Save 设置中配置忽略列表,把.trash、.git这类目录排除掉。尤其是.git,里面成千上万的 objects 文件会让坚果云流量和请求频率双爆炸,排除后同步速度会有质的提升。

3.2 冲突文件与重复副本:多设备编辑要小心

多设备同时编辑同一个笔记,是 WebDAV 同步最容易产生冲突的场景。A 设备上传了修改,B 设备又基于旧版本保存,插件无法判断哪个是最终版本,就会生成类似我的笔记 的副本.conflict.md的冲突文件。这不算数据丢失,但会污染文件夹结构。Obsidian 1.4 之后的快照机制还会生成“重复副本”目录,时间一长就非常乱。

我的处理习惯是每天花一分钟看一眼同步状态。有冲突时打开两份文件对比,手动保留正确的一版,删除另一个,不要积压成堆。另外,如果当天有多台设备要编辑同一个笔记,尽量错开时段,比如电脑上午改完,手机晚上再看,给同步留出传播窗口。这个习惯能省掉大量整理冲突文件的时间。

3.3 认证失败的常见原因排查

把认证失败的常见原因整理成表,排查时按顺序对照,比瞎猜高效得多:

现象原因处理办法
401 Unauthorized密码填成了登录密码换成应用密码
401 Unauthorized应用密码复制时带了空格粘贴后肉眼检查一遍
404 Not FoundURL 少了 /dav/ 后缀核对 Server URL
405/409 错误远程目录不存在或路径不对先在网页端建目录再同步
连接超时本地网络到坚果云域名不稳定切换网络或重启路由
反复要求重新认证插件版本过旧更新 Remotely Save 到最新版

排查顺序一定从 URL 开始,再到账号密码,最后才考虑网络问题,不要一上来就重装插件。我遇到过一次很奇怪的认证失败,最后发现是把账号邮箱填进了用户名栏,而那串邮箱又恰好很长,不看设置界面根本察觉不到。这类细节往往才是最耗费时间的。

3.4 文件太多太大:首轮同步卡顿的应对策略

如果资料库已经跑了半年以上,里面可能躺着几千张图片和一堆 PDF,第一次全量同步会非常痛苦,甚至出现卡死。遇到这种情况,第一步确认两个选项已经开启:仅通过 Wi-Fi 同步、不删除本地文件。第二步,先用坚果云网页端手动上传一个大文件,验证整体连通性和当前限速状态。第三步,如果库实在太大,考虑分两阶段,先把.md文件同步过去,附件留在本地,后续再逐步放开。

坚果云对请求频率很敏感,但对单个文件大小的容忍度还行,几百兆的文件也能传,只是免费流量撑不住。这里建议大家养成一个习惯:Obsidian 库里的附件尽量压缩,图片能转 WebP 就转,既省流量,又让同步速度显著提升。我自己的库目前约两千篇笔记、近一千个附件,首次全量同步大约半小时,之后日常增量基本几秒钟就结束。

4. 进阶玩法:从同步到备份的完整体系

4.1 WebDAV 同步原理:一个比喻讲清楚

我一直觉得 WebDAV 是最好理解的同步方式。你可以把它想象成一个“带锁的网络文件夹”,锁通过用户名和密码验证。Obsidian 插件负责把本地文件窗口和网络文件夹对接:保存文件时,插件检测到变化,通过 HTTP 协议把文件传上去;其他设备连接同一文件夹后,发现远程版本更新,就把文件拉下来。本质上就是“上传”和“下载”两个动作的组合。

理解这个机制最大的好处,是遇到问题时能自己定位。上传失败就是本地到云端这段断了,下载失败就是云端到本地这段断了,不要一上来就怀疑插件。另一个层面,这个机制也解释了为什么 Markdown 纯文本格式对同步特别友好:它可以逐字对比、增量传输,不会因为二进制差异出问题。Typora 这类 Markdown 工具也能接 WebDAV,原因正是它读写的都是普通文本文件。

4.2 增量同步与文件监听:什么时候发出同步信号

很多人好奇,插件是每隔几分钟扫描一遍整个库吗?并不是,Remotely Save 依赖 Obsidian 的文件系统事件。只有你实际新建、修改、删除文件时,插件才会触发对应的同步任务。所以要换设备继续写之前,一定确认笔记保存完毕,且状态栏显示“已同步”。这个操作习惯很关键,能明显降低冲突率。

定时同步功能是另外一条机制,它每隔一段时间检查远程状态,但也不是全量对比,而是通过文件修改时间和大小来判断哪些文件变了。本地有元数据缓存,所以日常增量极快。也正因为如此,不要轻易删除库里的.obsidian目录,里面除了编辑器设置,还保存了插件自身的同步状态,一旦删除,插件可能重新扫描全库,触发大规模的请求上传,得不偿失。

4.3 搭配备份:同步不等于备份,还得再加一道保险

把“同步”和“备份”混为一谈,是很多用户最容易忽略的风险。坚果云同步的是一个实时版本,如果你误删了一个文件夹,同步会把删除指令也传到云端,另一台设备立刻跟着删。所以必须有独立的备份方案,否则你备份的不是“昨天的笔记”,而是“上一分钟刚被删掉的笔记”。

我的做法是在坚果云之外再加两道保险。第一,每周手动把整个库打好 zip 压缩包,放到另一个网盘或移动硬盘里。第二,定期把坚果云 WebDAV 目录里的内容拉取到本地归档。这个方法不挑工具,写个简单脚本或纯手动都可以。Obsidian 数据全部是明文文件,备份尤其简单,打包就行,不需要导出复杂格式。

4.4 其他同步方案的横向对比

选型阶段我把主流方案都研究过,做成表格方便大家对照:

方案成本难度稳定性适用场景
坚果云 + Remotely Save免费低高大多数用户默认首选
Obsidian Sync(官方)年费低最高需要端到端加密或团队功能
Git + 远程仓库免费高中程序员、版本管理重度用户
Self-hosted LiveSync服务器费用高中追求实时同步且愿意折腾
Syncthing免费中高局域网场景、无中心服务器

自我托管方案里,Self-hosted LiveSync 走 CouchDB 数据库同步,实时性最强,但部署成本高,Windows 端还要配中间层,新手很容易被劝退。单纯想多设备同步的话,不建议一上来就上这套,先把坚果云玩熟,确定自己的痛点在哪,再考虑折腾也不迟。

我个人用了快两年,“坚果云 + Remotely Save + 每周压缩包备份”的组合,到现在都没换过。最大的体会是:同步工具不在多,而在稳定。“打开电脑就能看到手机刚写的笔记”这种体验一旦实现,就很难退回手动同步的日子了。如果你刚准备入坑 Obsidian,不用一上来就纠结官方 Sync,按这篇文章把坚果云接好,用临时库验证通过,再把正式库切过去,基本不会再遇到什么坑。最后分享一个小习惯:我每天晚上关电脑前瞄一眼同步状态栏,确认所有文件都已同步完成,这个三秒钟的动作,帮我躲掉了至少三次同步翻车事故。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询