Obsidian多设备同步完整指南：从零配置到无忧使用，新手也能一次搞定

用Obsidian的人，早晚都会撞上一堵墙——“我怎么在另一台设备上看我的笔记？”

你可能已经体验过这个场景：在公司电脑上用Obsidian写了一下午的会议纪要，晚上回到家想用家里的电脑继续整理，打开Obsidian——只有一个空空如也的库。你在手机上也装了Obsidian，但里面什么都没有。你想同步，但搜索出来的方案要么要花钱，要么要配WebDAV、配Git、配各种你听都没听过的技术名词。

我在2024年入坑Obsidian的时候，同步这个问题上栽过跟头。先是试iCloud—— Windows 上用着各种卡顿和文件重复。然后试Git——手机端完全没法用。再试Remotely Save配坚果云WebDAV——折腾了半个多小时才连上，结果同步过程完全看不到细节，出冲突了只能手动对比两个文件。

直到后来发现了Nutstore Sync——坚果云官方的Obsidian同步插件，免费、零配置、完全可控。这篇指南的目标就是：让一个从来没有配置过同步的Obsidian新手，跟着步骤走，一次搞定多设备同步。

这篇文章会覆盖完整的流程：装Obsidian → 装Nutstore Sync → 注册坚果云 → OAuth登录 → 首次同步 → 选同步方向 → 配置冲突策略 → 验证多设备。每一步都有操作说明、预期效果和常见问题。

开始之前说一句：Nutstore Sync是坚果云官方Obsidian同步插件，是免费的，每个月都有免费的1G上传流量，3G下载流量。坚果云已经稳定运行了15年，可以放心使用，插件通过坚果云账号登录，如果你还没有账号，可以先注册一个再开始体验：坚果云官网。

---

第一步：确认你的设备清单

在开始之前，先明确你需要同步哪些设备。Obsidian支持以下平台：

• Windows（桌面端）
• macOS（桌面端）
• Linux（桌面端）
• iOS（iPhone/iPad）
• Android（手机/平板）

Nutstore Sync在这五个平台上全部支持，体验一致。你现在可能只有一台电脑，但以后会加手机、加平板、换新电脑——所以从一开始就选一个全平台都能用的方案，省得以后推倒重来。

一个重要的概念先理清： 同步不是"把笔记存到云端"，而是"让每台设备上的笔记保持一致"。你在公司电脑上改了标题，回家打开家里的电脑，标题已经是最新的了——这才是同步的意义。所以同步是双向的、持续的、自动的，不是一次性的拷贝。

---

第二步：在第一台设备上装好Obsidian

如果你已经装好了，跳过这一步。如果还没装：

1. 打开Obsidian官网（obsidian.md），下载对应你操作系统的安装包
2. 安装完成后打开Obsidian
3. 点击"Create new vault"（创建新库），给你的笔记库起个名字（比如"My Notes"），选择一个存放位置
4. 进入Obsidian主界面后，随便创建一篇测试笔记——输入一些内容，保存

此时你的Obsidian已经可以正常使用了，但只能在这台设备上看到笔记。接下来我们装上Nutstore Sync，让这个库可以在所有设备上同步。

小提示： 库的存放位置很重要。建议放在你用户目录下的一个独立文件夹里，比如 C:\Users\你的用户名\Obsidian\My Notes（Windows）或 /Users/你的用户名/Obsidian/My Notes（macOS）。这个位置后面在其他设备上创建库的时候要用到——建议保持一致的目录结构。

---

第三步：安装Nutstore Sync插件

这是整个流程中最简单的一步：

1. 在Obsidian里，点击左下角的齿轮图标（设置）
2. 在左侧菜单中找到"Community plugins"（社区插件市场）
3. 如果之前没开启过社区插件，需要先点"Turn on community plugins"（开启社区插件）
4. 点击"Browse"（浏览），在搜索框中输入"Nutstore Sync"
5. 找到Nutstore Sync插件，点击"Install"（安装）
6. 安装完成后点击"Enable"（启用）
   

此时你应该能在Obsidian左侧的工具栏下面看到Nutstore Sync插件。点击它，会弹出Nutstore Sync的操作面板。

预期效果： 插件安装并启用后，左侧工具栏出现坚果云图标。点击图标打开操作面板，面板顶部有一个"登录"按钮。

常见问题：

• 搜不到Nutstore Sync插件？ 确认你的Obsidian版本在1.5以上。Nutstore Sync基于最新的插件API开发，老版本Obsidian可能不兼容。去官网更新到最新版。
• 点击"Browse"后加载不出来？ 可能是网络问题。社区插件市场托管在GitHub上，偶尔会被墙。换个网络环境再试，或者等几分钟再刷新。
• 安装失败？ 同样是网络问题。Obsidian插件是从GitHub下载的，网络不稳定时容易失败。多试几次，或者换个时间段。

---

第四步：注册坚果云账号

Nutstore Sync是坚果云官方的Obsidian插件，需要坚果云账号才能使用。

1. 打开坚果云官网注册页面
2. 用邮箱注册一个免费账号
3. 验证邮箱后登录

为什么需要坚果云账号？ 因为Nutstore Sync用的是坚果云的云存储来同步你的笔记文件。你的笔记会安全地存储在坚果云的服务器上，然后从服务器同步到你的其他设备。坚果云从2011年运营至今已有15年，经历了时间的考验，服务稳定可靠。

免费方案够用吗？ 坚果云免费账号每月有1G上传流量和3G下载流量。纯文本笔记的话，这个流量绰绰有余——一篇2000字的Markdown文件大约2-3KB，1G流量够你上传约30万篇笔记。即使你的笔记里有一些截图和PDF，日常使用也完全够用。而且Nutstore Sync用的是智能增量同步，你改一个字只传一个字，修改已有文件几乎不消耗流量。

安全方面： 坚果云通过了ISO27001信息安全管理体系认证和公安部信息系统安全等级保护三级备案（等保三级）。所有文件使用AES-256 加密 存储，传输过程走SSL/TLS全链路加密——这跟网上银行用的是同一套数据加密标准。目前坚果云服务了超过千万用户和十万家以上的企业机构，包括中国石油、中银证券、清华大学等。

---

第五步：OAuth一键登录

有了坚果云账号之后，在Obsidian里完成登录：

1. 点击左侧工具栏的坚果云图标，打开Nutstore Sync面板
2. 点击"登录"按钮
3. 自动跳转到浏览器，打开坚果云的OAuth授权页面
4. 输入你的坚果云账号和密码（或者用坚果云App扫码登录）
5. 点击"授权"，浏览器会提示"授权成功"
6. 自动回到Obsidian，此时Nutstore Sync面板显示已登录状态
   

整个过程没有让填任何一个服务器地址、端口号、应用密码。 这就是OAuth一键登录和传统WebDAV配置最大的区别。如果你之前用过Remotely Save，你应该还记得那个繁琐的过程——去坚果云网页端生成应用密码，复制一段像 https://dav.jianguoyun.com/dav/ 的服务器地址，再回到Obsidian里一个个填进去。OAuth直接省掉了所有这些步骤。

预期效果： 登录成功后，Nutstore Sync面板顶部显示你的坚果云账号名，下方出现"同步"按钮和配置选项。

常见问题：

• 浏览器没有自动跳转？ 如果浏览器没有自动打开，Obsidian会提示你手动复制授权链接到浏览器打开。完成后，Obsidian会自动检测授权状态。
• 授权页面打不开？ 检查网络连接。坚果云官网在国内访问没有问题。如果浏览器打不开，可能是你的网络环境限制了外部链接跳转。
• 授权成功但Obsidian没反应？ 等几秒钟。如果还是没有反应，关掉Nutstore Sync面板再重新打开。这是因为Obsidian需要重新读取授权状态。
• 可以用微信/QQ登录吗？ 坚果云支持第三方账号登录（微信、QQ等），但首次使用OAuth授权时建议用邮箱注册的账号，兼容性最好。

---

第六步：首次同步——最重要的一步

登录完成后，接下来是首次同步。这一步很关键，因为它决定了你的笔记是"上传到云端"还是"从云端下载"。

场景A：这是你的第一台设备，云端还是空的

这是最常见的情况——你刚开始用Nutstore Sync，云端还没有你的笔记。操作步骤：

1. 点击Nutstore Sync面板中的"同步"按钮

2. 插件会扫描你的本地笔记库，生成一个执行列表

3. 执行列表里会列出所有待上传的文件——因为云端是空的，所以所有本地文件都会标记为上传
   

4. 仔细看一眼执行列表，确认没有不该上传的文件（比如你的私人日记文件夹如果不想同步，可以后面配置排除规则）

5. 点击"确认同步"

6. 等待同步完成——首次同步的时间取决于你的笔记库大小。几百个纯文本文件一般一两分钟就能完成。如果有大量图片和PDF，时间会长一些。

场景B：这是你的第二台设备，云端已经有笔记了

比如你已经在家里的电脑上同步过了，现在要在公司电脑上也装Nutstore Sync。操作步骤：

1. 安装Nutstore Sync并用同一个坚果云账号OAuth登录
2. 点击"同步"按钮
3. 插件会扫描本地和云端，生成执行列表
4. 执行列表会显示：哪些文件需要从云端下载到本地（因为本地还没有）、哪些本地文件需要上传到云端（如果你已经在第二台设备上创建了新笔记）
5. 在确认之前，把同步方向切到"仅接收"（先从云端拉取所有笔记），等第一轮接收完成后再切回"双向同步"
6. 点击"确认同步"

为什么要先"仅接收"再"双向"？ 第二台设备刚安装时，本地的库可能是空的或者只有一两篇测试笔记。如果直接用双向同步，可能会把本地的那一两篇测试笔记上传到云端。先"仅接收"可以确保第二台设备的库和云端完全一致，避免不必要的数据混乱。

预期效果： 同步完成后，你在第一台设备上写的所有笔记，在第二台设备上也能看到了。此时在任意一台设备上修改一篇笔记，在另一台设备上点击同步，修改就会被同步过去。

---

第七步：理解五种同步方向

Nutstore Sync跟其他同步方案最大的不同在于——每次同步之前，你可以选择同步方向。不是"只能双向同步"或者"只能单向备份"，而是五种方向任选，而且可以逐文件调整。

点击同步按钮后，弹出的执行列表确认弹窗里，都有一个方向选择器：

1. 双向同步（默认，日常使用）

本地改了的上传，云端改了的下载。两边都改了的话，按你设定的冲突策略处理。这是99%日常场景下的选择——你在两台设备上各自编辑笔记，同步后两边保持一致。

2. 仅发送（只推不拉）

只把本地的改动上传到云端，不下载云端的任何改动。使用场景：你在本地大改了一堆笔记，但不确定云端的状态是否干净（比如另一台设备可能误操作了），你想先把本地版本"锁"到云端。

3. 仅发送并覆盖云端（强制推送）

不管云端是什么状态，用本地版本完全覆盖云端。使用场景：灾难恢复。比如你发现云端因为某种原因出现了文件损坏或错乱，但本地版本是完整的——用这个模式把本地版本强推上去。

4. 仅接收（只拉不推）

只从云端下载改动到本地，不上传本地的任何改动。使用场景：新设备初始化（刚才第六步说的）、或者你临时在一台设备上做了些实验性的修改不想同步。

5. 仅接收并还原（强制拉取）

不管本地是什么状态，用云端版本完全覆盖本地。使用场景：本地文件被误删或损坏，想从云端恢复。或者刚换了新电脑，把整个库从云端拉下来。

这五种方向的实用性： 没有人会天天 切换 方向。99%的时间你只需要双向同步。但剩下那1%的场景——灾难恢复、新设备初始化、误操作回滚——这五种方向能让你精准控制数据流向，避免"按同步按钮之前心里没底"的焦虑感。

---

第八步：配置冲突策略

多设备同步最怕什么？冲突。 你在公司电脑上改了一段话，没同步就走了；回家在家里的电脑上改了同一段话，然后同步——系统发现同一段话有两个不同的版本，怎么办？

Nutstore Sync提供了四种冲突策略，在设置中可以选择：

策略一：无冲突合并（默认推荐）

这是Nutstore Sync最聪明的模式。当你分别在两台设备上修改了同一篇笔记，但修改的是不同的段落——Nutstore Sync用Yjs算法检测到没有真正的冲突，自动把两边的修改合并到一起，互不覆盖。

比如你在公司改了第三段，在家改了第五段——自动合并，两段修改都保留。你根本不需要操心。

策略二：Diff3合并 + AI辅助

当真正检测到冲突（两台设备改了同一个地方），用Diff3三路合并算法生成对比视图，同时AI分析两种修改的语义，给出合并建议。改动以绿色高亮（新增内容）和红色高亮（删除内容）标注。你可以逐条确认AI建议，或者手动调整。

这个模式适合团队协作、和别人共用笔记库的场景。

策略三：本地优先

冲突发生时，以本地版本为准，覆盖云端版本。适合"我已经做了大改，云端那个旧版本不要了"的场景。

策略四：服务器优先

冲突发生时，以云端版本为准，覆盖本地版本。适合"这台设备上的修改是实验性的，云端版本才是正式版"的场景。

推荐配置： 日常使用选"无冲突合并"，它能在90%的场景下安静地自动处理，不打扰你的写作流。偶尔遇到真正冲突时，再临时切换到"Diff3合并 + AI辅助"来精细处理。

---

第九步：配置.obsidian目录同步

Obsidian库里面有一个隐藏文件夹叫 .obsidian，里面存放了你的所有Obsidian配置：主题、插件、快捷键、CSS片段、模板等等。

Nutstore Sync可以设置同步 .obsidian 目录。这意味着：你在第一台设备上精心调好的主题、安装的插件、自定义的快捷键，同步之后，在第二台设备上也会自动生效。你不需要在每台设备上重新配置一遍。

但有一些注意事项：

• .obsidian/workspace.json 这个文件记录的是你在这台设备上的窗口布局（打开了哪些面板、分屏怎么排列等等），每台设备的布局可能不一样，同步之后可能会互相覆盖。如果你发现窗口布局总是被同步打乱，可以在Nutstore Sync的设置中排除这个文件。
• 插件的配置文件（比如各种插件的data.json）会同步。但不同平台的插件配置可能有细微差异（比如移动端和桌面端），一般不会出大问题。
• themes 和 snippets 目录的同步非常实用——主题和CSS片段一键同步，不用重新下载。

---

第十步：在多台设备上验证同步

现在你已经完成了第一台设备的配置。接下来在第二台设备上装Obsidian和Nutstore Sync，验证同步是否正常工作。

在第二台设备上的操作：

1. 安装Obsidian（和第一台设备相同的版本）
2. 打开Obsidian，创建一个新的空白库（位置建议和第一台设备保持一致）
3. 安装Nutstore Sync插件，用同一个坚果云账号OAuth登录
4. 点击同步按钮
5. 在弹出的执行列表中，把方向切到"仅接收"
6. 点击确认同步
7. 等待同步完成

验证同步是否正常：

同步完成后，做以下几个测试：

• 检查第一篇笔记是否出现在第二台设备的Obsidian中
• 在第一台设备上修改一篇笔记的标题，保存后点击同步
• 在第二台设备上点击同步，检查标题是否更新
• 在第二台设备上修改一篇笔记的内容，保存后点击同步
• 在第一台设备上点击同步，检查内容是否更新

全部通过，你的多设备同步就配置成功了。

移动端（手机/平板）的配置和桌面端完全一样。 在手机上装好Obsidian后，同样在社区插件市场安装Nutstore Sync，同样用OAuth登录，同样点击同步。移动端的操作面板和桌面端一致，五种同步方向和四种冲突策略全都有。

---

第十一步：日常使用技巧

同步配置好之后，日常使用就是"编辑 → 点同步 → 继续编辑"。但有几个小技巧能让体验更好：

技巧一：养成"离开前同步"的习惯

每次在一台设备上写完笔记、准备切换到另一台设备之前，点一下同步按钮。看一下执行列表里的变更内容，确认无误后点确认同步。习惯之后整个过程只需要几秒钟，但能确保你换设备时看到的永远是最新版本。

技巧二：善用执行列表的逐文件方向调整

有时候你不想同步整个库的所有变更。比如你在本地写了一半的草稿，不想让它在其他设备上出现——在执行列表里找到那个文件，方向切到"跳过"，它就不会被上传。

技巧三：定期检查云端状态

每隔一段时间（比如每周一次），可以登录坚果云网页端看看你的笔记文件在云端的存储状态。这是一个好习惯——确保备份是完整的。

技巧四：超大附件不要放笔记库里

如果你有几百MB的视频文件、大型PDF资料，不建议放在Obsidian笔记库里。建议放在坚果云的其他同步文件夹里，笔记里用链接引用。这样笔记库保持轻量，同步飞快。

技巧五：利用历史版本功能

Nutstore Sync同步到坚果云的文件都有历史版本记录。如果你不小心删了一段重要内容、保存并同步了——别慌。登录坚果云网页端，找到那个文件，恢复之前的版本就行。这个功能在防误删和防勒索病毒方面非常实用。

---

对比：如果不用Nutstore Sync，用Remotely Save + 坚果云WebDAV需要多折腾多少步

我们来做一道算术题。假设你是第一次接触Obsidian同步的新手，以下是两种方案的完整操作步骤对比：

Nutstore Sync方案（本文方案）：

1. Obsidian插件市场搜索"Nutstore Sync"，安装并启用
2. 点击登录，跳转坚果云OAuth页面，输入账号密码，授权
3. 点击同步，检查执行列表，确认
4. 完成

Remotely Save + WebDAV方案：

1. 先注册坚果云账号
2. 登录坚果云网页端，找到"账户信息" → “安全选项” → “第三方应用管理”
3. 点击"添加应用密码"，输入一个名称（比如Obsidian），生成一串随机密码
4. 把这串密码复制下来（只显示一次，丢了要重新生成）
5. 记下WebDAV服务器地址（形如 https://dav.jianguoyun.com/dav/ ）
6. 回到Obsidian，安装Remotely Save插件
7. 打开Remotely Save设置，选择"Remote Type"为WebDAV
8. 填服务器地址
9. 填坚果云账号（邮箱）
10. 填刚才那串应用密码
11. 点击"Check Connectivity"测试连接
12. 如果连不上，回去检查地址有没有多一个斜杠、密码有没有复制全
13. 连接成功后才能开始同步
14. 同步过程中看不到执行列表，看不到哪些文件被上传下载
15. 出冲突了只能手动对比两个文件

光是配置步骤就差了10步。而且做错了哪一步，还没有故障排查工具帮你定位——Remotely Save在这方面几乎是空白。

---

Q&A

Q：我有多个Obsidian库，Nutstore Sync能分别同步吗？

A：可以。每个Obsidian库是独立的，你在每个库里分别安装Nutstore Sync、分别用同一个坚果云账号登录即可。插件会为每个库维护独立的同步状态。注意免费流量（1G上传+3G下载/月）是所有库共享的。

Q：同步过程中断网了怎么办？

A：Nutstore Sync支持断点续传。网络恢复后，插件会自动从断点继续同步，不会重传已经同步完成的部分。大文件场景下（比如你在同步一个50MB的PDF），这个特性非常重要——不会因为网络波动导致前功尽弃。

Q：我可以只同步某些文件夹，不同步另一些吗？

A：可以。在Nutstore Sync的设置里，你可以配置"同步范围"——选择只同步指定的文件夹，排除不需要同步的目录。比如你的库里有私人日记文件夹不想上云端，直接排除即可。另外还支持配置"跳过超大文件"的阈值，超过一定大小的文件自动跳过不参与同步。

Q：如果我同时用Nutstore Sync和Obsidian Sync会冲突吗？

A：不推荐同时使用两个同步工具。它们各自维护独立的同步状态，互相不知道对方的存在，可能导致意外的冲突和数据覆盖。二选一即可。

Q：免费的1G上传流量用完了怎么办？

A：对于纯文本笔记来说，1G上传流量几乎不可能用完。但如果你的笔记库里有大量图片和PDF，首次全量同步可能会接近限额。免费流量用完后，当月不能再上传，但下载不受影响。可以选择升级付费方案，也可以等下个月流量重置。另外，Nutstore Sync的增量同步机制意味着修改已有文件消耗的流量极少——真正消耗流量的是新增大附件。

Q：如果我换了一个新的坚果云账号，之前同步的笔记怎么办？

A：更换账号后，Nutstore Sync会以新账号的云端状态为准。如果你想保留之前的笔记，先在旧账号下做一次完整同步，确保所有设备上的笔记都是最新版本。然后注销旧账号，登录新账号——首次同步时插件会检测到云端为空，执行列表会显示所有本地文件待上传。确认后，笔记就全部上传到新账号的云端了。

Q：安卓手机和iPhone上用Nutstore Sync的体验一样吗？

A：体验完全一致。移动端的Nutstore Sync有着和桌面端相同的操作面板——执行列表确认弹窗、五种同步方向、四种冲突策略，一个不少。iOS和Android的Obsidian都支持社区插件，直接在移动端的插件市场安装即可。

Q：我可以和同事共享某一个Obsidian库一起协作吗？

A：可以，但需要注意配置。你和同事用各自的坚果云账号，在各自的Obsidian中安装Nutstore Sync。然后在坚果云中，把存放笔记的文件夹共享给同事。同事在自己的Obsidian中创建一个库指向共享文件夹。同步时建议使用"Diff3合并 + AI辅助"策略，两个人同时改同一篇笔记时能智能处理冲突。