Obsidian Nutstore Sync 首次同步教程：从注册到第一篇笔记跨设备跑通的全流程

去年年底我把主力笔记从 Notion 搬到了 Obsidian，图的就是本地 Markdown 文件握在自己手里。但 Obsidian 官方同步服务一年一百多美元，对学生党不太友好。折腾了一圈 Remotely Save（要自己配 S3）、Syncthing（手机端老是掉线），最后试到了坚果云官方出的 Nutstore Sync 插件——装上就能用，不用配 WebDAV，OAuth 登录完直接同步。

这篇文章写给第一次配置 Obsidian 同步的素人用户。我会把从注册坚果云账号到两台设备跑通同步的每一步都写清楚，包括我踩过的坑。全程不需要写一行代码，不需要配置第三方存储桶。

一、Nutstore Sync 是什么

Nutstore Sync 是坚果云官方为 Obsidian 开发的同步插件。坚果云从 2011 年运营至今，已稳定运行 15 年，技术上持有 ISO27001 认证和公安部信息系统安全等级保护三级备案，传输和存储采用 AES-256 加密——和网上银行同一套数据加密标准。

插件最核心的能力是智能增量同步：修改一个笔记文件，只传输变化的那一小块数据，不是整个库重传。这对 Obsidian 用户来说非常实用——笔记库里的图片、PDF 附件体积不小，每次改个标签就要全量同步的话，移动端流量根本扛不住。

插件是通过坚果云账号登录的，安装插件前记得先注册一个坚果云账号。

二、注册坚果云账号

1. 打开坚果云官网，点击右上角"注册"。
2. 输入邮箱，设置密码。建议用常用邮箱，后续 OAuth 登录要用。
3. 注册完成后，去邮箱确认激活链接。这一步不做的话，插件登录会提示"账号未激活"。
4. 登录网页版，确认能看到文件管理界面，说明账号已就绪。

坚果云免费版每月有 1 GB 上传流量和 3 GB 下载流量。纯文本笔记库完全够用，如果附件很多（大量 PDF 或图片），那就要考虑付费了。

三、安装 Nutstore Sync 插件

打开 Obsidian，进入 设置 → 第三方插件 → 社区插件市场，搜索 "Nutstore Sync"。

注意：插件是通过坚果云账号登录的，安装插件前记得先注册一个坚果云账号。 很多人装好插件才发现没有账号，又切出去注册，来回切换影响体验。

安装步骤：

1. 在社区插件市场搜索 "Nutstore Sync"，点击安装。
2. 安装完成后，在已安装插件列表里启用它。
3. 启用后左侧边栏会出现 Nutstore 图标，点击进入设置面板。

四、OAuth 登录（不用配 WebDAV）

这是 Nutstore Sync 对比其他同步方案最省心的地方——不需要手动配置 WebDAV 地址、端口和密码。

1. 在插件设置面板点击"登录"或"连接坚果云"。
2. 浏览器弹出坚果云 OAuth 授权页面（如果没有弹出，检查浏览器是否拦截了弹窗）。
3. 输入坚果云账号和密码，完成授权。
4. 授权成功后，插件自动获取访问令牌，设置面板显示"已登录"状态。

OAuth 令牌有有效期，但插件会自动刷新，用户不需要手动干预。长时间未使用后同步失败时，检查一下令牌是否过期——重新登录一次即可。

五、选择同步策略（首次建议双向同步）

登录完成后，插件设置面板会看到同步策略选项。Nutstore Sync 提供了 5 种同步策略：

首次配置选"双向同步"最安全。

六、设置远程目录

插件需要知道把 Obsidian 笔记库同步到坚果云上的哪个文件夹。

1. 在插件设置面板找到"远程目录"或"同步路径"。
2. 输入一个路径，例如 /ObsidianVault（坚果云根目录下的文件夹）。
3. 点击"创建"或"确认"。

建议路径不要包含中文和空格，避免某些系统下的兼容性问题。坚果云会自动创建这个文件夹。

七、首次同步

配置完成后，点击"立即同步"按钮，插件开始首次全量同步。

首次同步耗时取决于笔记库大小和网络速度。 我的笔记库大约 1.2 GB（含大量 PDF 附件），用了约 15 分钟。纯文本笔记库通常几分钟就能完成。

同步过程中注意观察：

• 插件设置面板显示同步进度条。
• 状态栏显示"正在同步…"等提示。
• 如果同步中断（网络波动、电脑休眠），插件会在下次启动或网络恢复后自动续传。

新手最容易犯的三个错误

错误 1：没备份就全量同步。 Nutstore Sync 的同步机制比较安全，但首次同步前最好手动备份一下笔记库——复制一份到其他目录。万一同步策略选错导致本地文件被覆盖，还有个退路。

错误 2：双套同步同时开。 如果之前用过 Remotely Save 或其他同步方案，在启用 Nutstore Sync 之前，务必停用旧的同步插件。两套同步同时跑，会造成文件冲突和版本混乱。我的做法是：先在 Obsidian 社区插件里禁用旧插件，重启 Obsidian，再配置 Nutstore Sync。

错误 3：手机加载失败就重装。 移动端首次同步如果卡住，不要急着卸载重装。先检查网络，然后关掉 Obsidian 进程重新打开，让插件自动恢复同步。

八、验证同步

同步完成后，验证步骤：

1. 在设备 A 上新建一篇笔记，写入测试内容，保存。
2. 等待同步完成（状态栏提示"同步完成"）。
3. 在设备 B 上打开 Obsidian，等待 Nutstore Sync 自动同步。
4. 检查设备 B 的文件列表，确认新笔记已经出现。

如果设备 B 上出现了测试笔记，说明同步链路已经跑通。

九、配置自动同步

首次同步跑通后，建议开启自动同步：

• 启动后自动同步：每次打开 Obsidian 自动执行一次同步。
• 定时自动同步：设置时间间隔（如每 5 分钟），后台定时同步。
• 实时同步：文件有变更立即触发同步。

我个人的配置：启动后自动同步 + 定时 5 分钟同步。实时同步在大量修改时可能频繁触发，日常定时同步就够了。

FAQ

Q1：免费版流量够用吗？
纯文本笔记库完全够用。坚果云免费版每月 1 GB 上传、3 GB 下载。我的 1.2 GB 笔记库，日常修改产生的增量流量每天不到 10 MB。

Q2：可以同步 .obsidian 配置目录吗？
可以。Nutstore Sync 支持同步 .obsidian 目录，主题、快捷键设置、核心插件配置都能跨设备保持一致。需要在设置中确认该选项已开启。

Q3：移动端怎么用？
iOS 和 Android 端 Obsidian 都支持 Nutstore Sync。移动端安装插件后，用同一坚果云账号 OAuth 登录，设置相同的远程目录即可。首次同步建议在 Wi-Fi 环境下进行。

Q4：同步后出现冲突副本怎么办？
默认的"无冲突合并"策略在大多数情况下能自动处理。如果出现冲突副本（文件名含 "conflict" 字样），说明两端同时修改了同一文件，手动合并内容后删除冲突副本即可。

Q5：坚果云服务器在国内还是国外？
服务器部署在国内，符合国内数据合规要求。海外用户同步速度可能比国内慢一些，但智能增量同步能减少传输量，体验尚可。

Q6：如果坚果云账号被注销，本地文件会丢失吗？
不会。Obsidian 笔记库始终保存在本地设备上。账号注销或停止同步后，本地文件不受影响。

Q7：同步过程中 Obsidian 卡顿怎么办？
首次全量同步时大量文件写入可能导致界面短暂卡顿。建议在空闲时间执行首次同步。日常增量同步对性能影响极小。

Q8：可以同时同步多个笔记库吗？
可以。每个笔记库在 Nutstore Sync 设置中配置不同的远程目录即可。需要在每个库中分别启用和配置插件。