第 4 章 · 坚果云 WebDAV 同步配置

1. 同步原理

Joplin 采用「本地优先 + 增量同步」：笔记在本地始终有完整副本，冲突时保留冲突副本，不会静默覆盖。增量同步只传输发生变化的笔记与资源，日常使用流量很小；同步日志可以在「工具 → 日志」中查看，便于定位异常。

同步的对象不只是笔记正文，还包括笔记本层级、标签、附件资源与笔记历史版本，因此第一次同步会比之后明显慢一些。需要留意的是，Joplin 的同步是「触发式」而非实时推送：手动点同步、按设定的间隔自动同步，或退出应用时同步，才会把改动传到服务器。两台设备同时编辑同一条笔记时，后同步的一方会拿到一份冲突副本，而不是直接覆盖对方的内容，这也是本地优先设计的取舍。

2. 先选对方案

不确定用哪个同步后端？先看 同步方案怎么选 的四类方案对比（坚果云 WebDAV / Joplin Server / OneDrive / 文件系统），再回到本章完成坚果云 WebDAV 的具体配置。个人用户综合首选坚果云 WebDAV，追求省心可订阅 Joplin Cloud，团队或开发者适合自托管。

3. 坚果云 WebDAV 配置（国内推荐）

1. 在坚果云「账户信息 → 安全选项 → 第三方应用管理」生成应用专用密码（非登录密码）。
2. 在 Joplin「设置 → 同步」选「WebDAV」，地址 https://dav.jianguoyun.com/dav/，用户名填邮箱，密码填应用专用密码。
3. 点击「应用并测试」，再「立即同步」即可。

免费版每月流量约 1GB 上传 / 3GB 下载，文字笔记够用。坚果云 WebDAV 的官方地址是 dav.jianguoyun.com，若提示证书错误，请检查系统时间是否准确。配置完成后，可以在 Joplin 的同步状态页面查看上次同步时间与同步目标数量，确认没有报错后再开始多设备使用。

应用专用密码只在生成时显示一次，建议当场存进密码管理器；它和坚果云登录密码不是一回事，把登录密码填进 Joplin 会直接认证失败。服务器地址末尾的斜杠不要漏掉，若想把笔记单独放在坚果云的某个目录里，先在网页端建好该目录，再把目录名追加到地址后面。测试按钮通过后仍建议手动点一次「立即同步」，因为测试只验证账号能否登录，不验证目录读写权限。

• 401：账号或密码不对，九成是把登录密码当成了应用专用密码。
• 403：第三方应用访问未开启，或账号被临时限制，回坚果云安全选项检查。
• 404：地址写错或目录还没在坚果云端创建，确认路径与实际目录一致。
• 提示超出流量或频繁超时：免费版月度限额已用尽，等下月重置或换用其他同步方案。

4. Joplin Cloud 配置

官方同步服务，数据存储在欧洲，支持 E2EE 与笔记发布协作；在「设置 → 同步」选「Joplin Cloud」登录即可。Joplin Cloud 提供 30 天免费试用，支持笔记发布、协作编辑与共享笔记本，详情见 官方套餐页。

5. 同步冲突与排查

多设备离线编辑同一笔记会产生 conflict 副本，手动合并即可；养成「切换设备前先同步」的习惯。同步卡住可「重置同步状态」。遇到同步异常，官方文档 同步说明 与 GitHub Issues 是重要参考。更多同步场景可看 同步方案对比 与 同步失败排查。

6. 多设备接入顺序与流量调优

接入第二台、第三台设备时，顺序比参数更重要。先让桌面端单独完成一次完整同步并确认同步状态页没有报错，再在新设备上填同一个同步目标、同一组账号密码；新设备首次同步会把服务器上的笔记全量拉下来，这一步建议在 Wi-Fi 下做。确认两端笔记数量一致后，最后才考虑启用端到端加密——如果顺序反过来，某台设备还没拿到密钥就开始编辑，容易产生无法解密的冲突副本。

1. 桌面端配置同步目标，手动同步一次并查看同步状态。
2. 第二台设备填完全相同地址与账号，首次同步完成后核对笔记数量。
3. 两端互改一条测试笔记，确认改动能双向到达，再开始日常使用。
4. 需要加密时，在全部设备都同步完成后统一启用并逐一输入主密码。

图片、PDF 与录音附件是流量消耗的大头，纯文字笔记几乎不占额度。免费版用户可以把同步间隔调长、避免每分钟自动同步，并在手机端关闭「使用移动数据同步」；笔记里少贴大附件、把大文件改存网盘再放链接，也能明显减轻同步压力。若同步长期卡在某一条笔记，先看「工具 → 日志」里报的是哪个资源，再针对性处理，比反复点「重置同步状态」更有效。方案取舍见 同步方案全面对比，加密细节见 手册第 5 章。