先交代一下我的实际使用场景:Obsidian 笔记库我从三年前开始用,里面攒了几千篇 Markdown 笔记和一堆图片附件,之前一直锁在 Windows 电脑本地。直到某天在地铁上想查一条半年前记过的信息,发现什么都拿不到,才意识到多端同步不能再拖了。
Obsidian 的定位是“本地优先”,这一点我很喜欢,但“本地优先”带来的直接后果就是同步要自己想办法。官方 Sync 确实省心,但要按月付费,而且访问速度时好时坏;网上很多人推荐用坚果云客户端直接同步整个库文件夹,我也试过,坑不少。最后折腾下来,最稳定、最可控的组合是:Obsidian + Remotely Save 插件 + 坚果云 WebDAV。
这篇文章会把从零配置到踩坑修复的整个过程完整写出来,包括电脑端和安卓手机端两侧的设置、坚果云应用密码的创建、首次同步的方向选择,以及流量限额、冲突处理这些容易翻车的地方。无论你是刚接触 Obsidian 的新手,还是已经用了很久但一直没搞定手机端同步的老用户,这套流程基本可以直接照搬。
1. 三种主流同步路径的真实差异:为什么我选中 WebDAV 插件这条路线
1.1 官方 Sync、客户端直连、WebDAV 插件的区别在哪里
Obsidian 同步这件事,市面上能走的路其实就三条:买官方 Obsidian Sync、用第三方云盘客户端直接同步库文件夹、或者用社区插件通过 WebDAV 协议同步。我先把三者的差异摆出来,方便你根据自己情况选。
| 方案 | 收费 | 数据隐私 | 上手难度 | 我的实际体验 |
|---|---|---|---|---|
| 官方 Obsidian Sync | 按月订阅 | 端到端加密,隐私保护最好 | 最简单 | 体验流畅,但免费党很难长期接受订阅 |
| 坚果云客户端直接同步库文件夹 | 免费 | 依赖坚果云自身的存储 | 看起来简单,实际坑多 | 小文件多、写入频繁,极易产生冲突副本 |
| Remotely Save 插件 + WebDAV | 免费 | 可配合插件自带加密 | 第一次设置稍麻烦 | 稳定可控,推荐长期使用 |
官方 Sync 我试用过一个月,确实省心,打开设置、开启同步、完事。但它的收费模式对很多学生党、轻量用户来说是一道坎,而且 Obsidian 的定位本来就是本地优先、数据自己掌握,很多人愿意接受一个免费方案。
坚果云客户端直接同步库文件夹,是最常见的入门做法,原理上听起来也很顺:把整个 Obsidian 库文件夹当成普通文件夹,放进坚果云同步目录里。但问题恰恰出在“普通文件夹”这四个字上。Obsidian 在运行时会频繁读写 .obsidian 目录下的 workspace.json、app.json 等配置文件,光标位置、窗口大小、打开过哪些标签页,都会触发写入。坚果云客户端在后台监听文件变化,两边同时操作同一批小文件,就会出现一种非常经典的现象:你明明改了笔记,手机上打开却是旧版本;或者电脑端突然冒出一个“xxx (冲突副本).md”,里面是两种内容缝合在一起的乱稿。
WebDAV 插件为什么能避开这些?因为它的同步逻辑是主动的、整批的:每隔一段时间把本地库和云端做一次比对,然后按版本推送或拉取。它不依赖文件系统事件监听,也不对正在使用的文件做实时同步,所以冲突概率天然低很多。对于 Obsidian 这种“大量小文件 + 频繁配置写入”的笔记库来说,这个差异是决定性的。
1.2 搭档为什么是坚果云:免费、国内快、还有历史版本兜底
选坚果云而不是其他网盘,我是认真对比过的。支持 WebDAV 的服务其实不算多,能稳定在国内访问的更少。坚果云在“省事 + 免费 + 稳定”这个平衡点上做得很到位,具体来说有四个原因:
第一,国内访问速度快。同步这种事,最怕服务器在境外,一次同步等半分钟。坚果云国内节点,基本能做到秒级同步小文本。
第二,免费版对纯文本笔记库完全够用。坚果云免费版每月上传流量 1GB、下载流量 3GB。Obsidian 如果是纯 Markdown 文本,一天新增几十 KB,一个月下来连 1GB 的零头都用不到。这一点后面我还会专门讲——如果你的库里有大量图片和 PDF,情况就完全不一样了。
第三,WebDAV 支持成熟稳定。坚果云是国内对 WebDAV 支持最友好的云盘之一,接口文档清晰,开发者生态也很成熟,Remotely Save 这种插件和它配合得相当顺。
第四,网页端有回收站和历史版本功能。哪怕某天手滑删了笔记,同步又恰好把删除操作传到了云端,也能通过坚果云网页端找回。这是很多本地方案不具备的兜底能力。
所以我的结论很直接:官方 Sync 适合不差钱、不想折腾、对数据隐私要求极高的人;坚果云客户端直连适合只在一个设备上轻度使用的人;而“Remotely Save 插件 + 坚果云 WebDAV”适合绝大多数想在多端之间自由切换的 Obsidian 用户。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 电脑端配置流程:从应用密码到首次推送的每一步细节
2.1 坚果云侧:先创建 WebDAV 应用密码,别犯“直接填登录密码”的错
我见过不少新手,打开 Remotely Save 插件设置后直接填坚果云的账号密码,结果死活连不上,然后在论坛里问“是不是插件坏了”。其实根本不是插件的问题,而是坚果云 WebDAV 压根不支持用登录密码访问。
正确做法是先在网页端生成一个“应用密码”,相当于给 WebDAV 单独发一把专用钥匙。操作路径:
- 浏览器打开坚果云网页版,登录后点右上角头像进入“账户信息”。
- 在“安全选项”里找到“添加应用密码”,备注名可以填“Obsidian 同步”,方便以后识别。
- 生成后是一串 16 位随机字符,复制保存好。
这里有两个点需要特别注意。第一,填到插件里的密码必须是这个应用密码,不是坚果云登录密码。第二,这串应用密码只会显示一次,关掉页面后就再也看不到了,建议直接放进密码管理软件或笔记里,别随手存在桌面上。
应用密码机制的本质,是把 WebDAV 访问权限从账号权限里剥离出来。即使这串密码泄露,对方也只能操作文件同步,动不了你的手机号、邮箱这些账号信息。所以坚果云官方强制走应用密码,本身就是一种安全设计。
2.2 Obsidian 侧:安装 Remotely Save 插件并完成四项关键配置
Obsidian 侧的操作也不复杂,按顺序来就行:
- 打开 Obsidian,进入“设置 → 第三方插件”,先关闭受限模式(老版本里叫安全模式),否则社区插件无法安装。
- 点“浏览”,在插件市场搜索框输入
Remotely Save,找到后点“安装”,装完再点“启用”。 - 进入 Remotely Save 的插件设置界面,最关键的是下面四项:
| 配置项 | 填写内容 |
|---|---|
| Remote service | 选 WebDAV |
| Server URL | https://dav.jianguoyun.com/dav/ |
| User Name | 你的坚果云注册邮箱 |
| Password | 第 2.1 步生成的应用密码 |
关于 Server URL 多说一句:结尾那个斜杠最好保留,有些服务对带不带斜杠的处理比较严格,加上它更稳妥。用户名填的是注册邮箱,不是手机号,这个也容易混。
填完这些,可以先点“Check”或“Test”按钮测试连通性,插件会提示是否连接成功。如果失败,优先检查密码是否填成了登录密码、Server URL 是否少了 https:// 前缀。
2.3 首次同步的方向选择与推送后的验证方法
第一次同步是整个过程中最危险的一步,危险在方向选择上。
Remotely Save 插件首次运行时,会弹出一个选择:你是要让“本地数据覆盖云端”,还是“云端数据覆盖本地”。这个选择一旦做错,后果是不可逆的。正确的操作是:先在电脑端把 Obsidian 库准备好,保证本地是完整、最新、无误的一份,然后选择“本地 → 远程”,把整个库推送到坚果云。如果方向反了,而云端恰好是空的,插件会把空目录同步回来,本地文件直接消失,到时候哭都来不及。
我当时的验证方式是:首次推送完成后,打开坚果云网页版,通过 WebDAV 目录确认云端是否出现了一个完整的库文件夹结构,.obsidian、笔记目录、附件目录都在,才算真正成功。如果一切正常,电脑端这步就结束了。
最后再提一个 Remotely Save 非常实用的隐藏功能:插件设置里有一项“将插件配置同步到远程”。勾选它之后,后续在新设备上装好 Remotely Save,插件会自动从云端拉取这份配置,不需要再手填一遍 WebDAV 地址、用户名、密码。这个功能在安卓手机上尤其省事,后面会用到。
3. 安卓手机端接入:安装 Obsidian、目录选择、首次拉取与后台保活
3.1 安卓端安装与库文件夹位置的选择:别放进坚果云客户端同步目录
Obsidian 官方安卓版是一个 APK 安装包。官网下载在国内部分地区速度一般,这也是“obsidian 下载太慢”这类搜索词那么热的原因。我一般建议去 Obsidian 官方在 GitHub 的 Releases 页面找安装包,认准官方账号,核对好文件名再下载,别从乱七八糟的第三方站点拿 APK,安全风险不值得冒。
装好之后,首次打开会要求选一个目录作为笔记库。如果你手机上恰好也装了坚果云客户端,这里会有一个特别诱人的陷阱:把 Obsidian 库直接放在坚果云客户端同步目录里,是不是就能一举两得?
千万不要这么干。一个文件夹如果有两个程序的进程同时在读写——坚果云客户端在后台监听文件变化,Obsidian 在实时写配置和笔记——冲突几乎是必然的。这和我在第一章说的情况一模一样,只是从电脑端换到了手机端。
正确做法是:手机端不用坚果云客户端管理库文件夹,而是把 Obsidian 库放在一个普通目录,比如“内部存储/Documents/Obsidian”,或者“内部存储/Obsidian库”。这个目录只归 Obsidian 和 Remotely Save 插件管,坚果云客户端全程不碰它。这样整个同步链路就变成了:电脑端 Obsidian ←→ 坚果云云端 ←→ 手机端 Obsidian,坚果云客户端根本不需要在手机端安装。
3.2 手机端插件配置:借助云端配置文件省去手填的麻烦
如果你在电脑端勾选了“将插件配置同步到远程”,手机端只需要安装 Remotely Save 插件,然后在插件设置里输入一次坚果云应用密码,插件会自动从云端拉取 WebDAV 地址和同步参数。这个体验非常好,省去了在手机小屏幕上逐项填 URL 的麻烦。
如果当时没勾选那个选项,也不需要重新拆电脑,直接对着电脑端插件设置里的几项内容,手填到手机端就行。四项参数完全一样:WebDAV、Server URL、用户名、应用密码。填完记得测一下连通性。
3.3 首次拉取的方向选择与权限确认
手机端第一次同步时,方向选择和电脑端正好相反——选“从远程复制到本地”。这一步会把云端已有的整个库下载到手机。如果选反了,手机上的空目录会把云端覆盖,等于电脑端的数据白推了。
首次拉取时要留意两个小细节:
第一,Obsidian 安卓版在连接新库时,如果系统弹出存储权限请求,一定要给足文件访问权限。有些系统会在这一步卡住,导致后面的文件写不进去。
第二,文件选择器里定位目录时,要选中你一开始建好的那个库目录,不要随手选个“内部存储”根目录,不然 Obsidian 会把这个目录下所有文件夹都当成笔记库内容,同步时把一堆无关文件也传到云端。
首次拉取完成后,手机上就能看到和电脑一模一样的笔记库,包括主题、插件配置。之后日常使用就是本地编辑、Obsidian 照常自动保存、插件按设定间隔自动同步。我习惯把同步间隔调到 10 分钟,既不会太频繁消耗流量,也能保证不至于等太久。
3.4 国产系统后台限制与“手动同步更可靠”的应对思路
这一步是安卓端最烦的一环,也是很多人在手机上用 Remotely Save 失败的根本原因。
MIUI、EMUI/HarmonyOS 这类国产系统对后台应用的管控非常激进。即使插件设置了 10 分钟同步一次,Obsidian 在后台也可能被直接冻结,定时器根本不会被触发。表现就是:你在手机上写了一篇笔记,锁屏后过半小时再打开电脑,发现电脑上根本没有这篇东西。
解决的思路分三步走:
- 在系统设置的应用管理里,把 Obsidian 的“自启动”和“后台活动”权限打开。
- 将 Obsidian 加入电池优化白名单,设置为“不限制”。
- 在最近任务列表里给 Obsidian 加锁,防止一键清理杀掉。
但说实话,即使做完这些,某些激进系统还是会找到办法杀后台。所以我的最终经验是:不要太指望手机端全自动实时同步。更好的习惯是,打开 Obsidian 编辑完之后,顺手点一下插件主界面那个同步按钮,手动触发一次同步。手动同步比任何保活设置都可靠,而且不依赖系统心情。如果忘了手动触发,下次打开 App 时插件会按间隔自动拉取,数据也不会丢,只是时效性差一点而已。
4. 同步冲突、流量限额与附件处理:手机端实战踩过的坑
4.1 双端同时编辑同一篇笔记:冲突是怎么发生的,如何避免
这是 WebDAV 同步方案下最没办法完全消除的一类问题。典型场景是:你在手机上改了一篇日记,保存后 App 还在后台没来得及同步;同一时间,电脑上又打开同一篇笔记做了修改,并且先一步同步成功。等手机端执行同步时,插件根据修改时间戳判断版本,最后以时间戳较新的那份为准,另一份被覆盖。
说实话,这不是 Remotely Save 的缺陷,而是任何基于文件版本比对的同步方案都绕不开的边界问题。避免它的核心策略只有一个:不要在短时间内跨设备编辑同一篇笔记。比如你在修改某个项目方案,就在一台设备上把它改完、同步完,再打开另一台设备查看。别一边在手机上改标题,一边在电脑上改正文,那样最后总要放弃一边。
另外,在 Remotely Save 插件设置里把“冲突检测/保留多版本”之类的选项打开。一旦真的发生冲突,插件会生成一个带明显标识的冲突副本,手动合并内容后删掉副本文件即可。有兜底总比没有强。
4.2 坚果云免费版流量额度:一个容易踩爆的隐形上限
坚果云免费版对 WebDAV 的流量限制是:每月上传 1GB、下载 3GB。这个额度对纯文本笔记来说绰绰有余,但很多人的 Obsidian 库根本不是纯文本。
我第一次踩爆这个额度,是因为往库里拖了一批 PDF 论文,一本几 MB,拖了几十本,再加上日常粘贴的截图,一个月没到,坚果云就开始限速,Remotely Save 同步报错。当时我还以为是自己配置出了问题,排查了大半天,最后登录坚果云网页版才发现是流量已经用完了。
坚果云对超限的处理方式是降速或返回错误,但不会直接停掉服务。所以当你发现 Remotely Save 突然同步失败时,先别急着怀疑配置,登录网页版看一眼流量用量,这个排查成本最低。
对策也很简单:如果你的库以纯文本为主,放心用;如果附件多,要么接受付费版,要么从源头控制图片体积。我目前的做法是,截图粘贴进 Obsidian 之前会压缩一下,尽量控制在几百 KB 以内,这样 1GB 上传额度一个月也够用。
4.3 图片和 PDF 附件:流量与可用性的取舍
关于附件,还有一个非常常见的误解。有人为了省流量,会在插件里设置忽略规则,把整个附件文件夹排除在同步之外。结果文本都同步过去了,手机上打开笔记,图片全部显示为断链。这不是同步坏了,而是你主动把图片文件排除在外了。
所以排除附件前,要先想清楚:你是更在意手机端能完整查看笔记内容,还是更在意流量额度?我目前的取舍是:手机端需要看图片,所以同步附件,但通过压缩图片控制流量;PDF 这类大文件不放进库里,单独放网盘,笔记里只留链接。这样既保证了笔记的完整性,又不至于让流量爆得太快。
4.4 误删文件与历史版本:关键时刻的兜底机制
有经验的用户都知道,再稳的同步方案也有手滑的时候。某天我在电脑上整理目录时误删了一整篇笔记,当时没注意,等发现时已经同步完成,云端文件也没了。
这时候第一个反应可以去 Obsidian 自带的 .trash 目录找,注意 Obsidian 默认删除是进软件回收站,不一定会直接到系统回收站。
如果软件回收站没有,还有一层保险:坚果云网页版的 WebDAV 目录有历史版本功能,可以查看文件的历史状态并恢复。我用这个功能找回过一次被同步覆盖的旧版本,当时就在心里给坚果云加了一分。
所以我的习惯是:平常不用刻意管它,但大脑里要记住“坚果云网页端能找回文件”这条退路。关键时刻,它能救命。
4.5 同步异常后的排查顺序:从网络到流量逐层确认
如果你的 Remotely Save 某天突然同步失败,别慌,按照下面的顺序排查,90% 的问题都能定位:
- 网络是否正常。手机端开飞行模式再关掉,或者切换 Wi-Fi 和流量,先排除网络问题。
- 应用密码是否仍有效。如果坚果云账号密码改过,应用密码也会失效,重新去网页端生成一个。
- WebDAV 地址和用户名是否填错。检查大小写、斜杠、邮箱地址,一个字符错误都会导致认证失败。
- 坚果云流量是否超限。登录网页端看一眼剩余流量,超了会报错。
- 手机后台进程是否被杀。看 Obsidian 是否正常在前台运行,同步失败是不是发生在后台被冻结的时候。
这套排查逻辑,本质上是从链路的最底层往上逐层确认。网络、认证、权限、配额、系统限制,每一层都有对应的检查手段,按顺序来就不会乱。
5. 进阶调优:把同步链路调整到可以长期安心使用的状态
5.1 忽略列表:哪些文件夹和文件不应该参与同步
Remotely Save 插件支持自定义忽略规则,这是控制同步流量和避免无意义同步的关键手段。我建议重点关注两类:
第一,临时收纳文件夹。比如“00 收件箱”这类临时存放杂物的目录,里面的东西经常变动,但大部分很快会被删除或归档,同步价值有限。把它加入忽略列表,可以减少大量无意义的文件比对和传输。
第二,明确不需要同步的大文件目录。比如一个专门放原始素材、设计图的文件夹,几百 MB 甚至几个 GB,根本没必要占用坚果云的流量额度。
但注意,忽略规则要克制。Obsidian 核心库目录、.obsidian 配置目录都不应该被忽略,否则笔记内容和插件配置都不同步了。忽略规则设置完,先做一次测试同步,确认不影响主流程。
5.2 加密同步:为敏感笔记增加一层保险
坚果云 WebDAV 默认走 HTTPS 传输,传输过程中是加密的,但文件本身存储在坚果云服务器上并不是端到端加密。如果你对某些笔记的隐私要求非常高,可以在 Remotely Save 插件里开启“加密”选项。插件会在上传前对文件内容做加密,下载时解密,相当于在坚果云之上再套一层保护。
这个功能有两个代价需要提前知道:第一,如果忘记加密密码,云端数据就再也解不开了,没有任何找回途径;第二,加密会略微降低同步速度,而且所有设备都要使用同一套加密配置。
我的建议是:不是所有资料都需要加密。日常笔记、读书札记、灵感片段,明文保存方便检索和复制;只有那些真正涉及账号信息、密钥、重要隐私的敏感文档,才值得单独放到一个加密的笔记库里。 Obsidian 本身支持多库,我可以为敏感内容单独建一个库,单独开启 Remotely Save 加密,两边互不干扰。
5.3 多设备、多仓库的路径规划
一个坚果云账户下可以创建多个 WebDAV 子目录,原理上每个 Obsidian 库对应一个子目录,互不干扰。我电脑上有“工作库”和“生活库”两个笔记库,在坚果云里分别同步到 /obsidian/work 和 /obsidian/life,两个库各用一套 Remotely Save 配置。
这样做的好处很明显:某个库同步出了问题,不会影响另一个库;某个库里的附件比较大,可以针对它单独调整忽略规则和同步频率;万一某天想换云服务,迁移成本也低,只需改一个库的配置。
5.4 Linux 用户与坚果云的相处方式
如果你在 Linux 上用 Obsidian,可能已经发现了:坚果云官方客户端在 Linux 上的体验远不如 Windows,某些发行版装起来很费劲,官方文档里甚至都没有专门的 Linux 客户端。这其实是搜索引擎里“linux 如何卸载坚果云”这类词来源的很大的原因。
我的建议是:Linux 上直接放弃坚果云客户端,也不要尝试装任何第三方 GUI 工具。你只需要 Remotely Save 插件的 WebDAV 同步就够了。Obsidian 库的同步不依赖系统客户端,插件自己就能完成与云端的数据交换。这样一来,Linux 用户体验反而最干净——不需要装任何云盘客户端,只在 Obsidian 里配置一次插件。
最后再分享一个我个人长期使用的习惯:每隔一段时间,我会主动登录坚果云网页版,看一眼 WebDAV 目录结构是否正常、剩余流量还剩多少。这个动作不是为了解决问题,而是为了尽早发现问题。同步方案再稳定,也架不住长时间不管不问。定期看一眼,比任何教程都靠谱。
