Joplin同步配置指南：WebDAV、Nextcloud、OneDrive与自建方案详解

同步原理简介

Joplin 采用「本地优先」架构：所有笔记先保存在本地数据库，同步时按笔记本为单位与远端目标做增量对比。这意味着即使没有网络，你也可以完整使用 Joplin，联网后再自动合并。

同步方案对比

方案一：坚果云 WebDAV（国内推荐）

1. 注册坚果云账号，在「账户信息」→「安全选项」中添加「应用密码」；
2. Joplin「工具」→「选项」→「同步」；
3. 同步目标选择 WebDAV，填写：

URL: https://dav.jianguoyun.com/dav/
用户名: 坚果云登录邮箱
密码: 应用密码（不是登录密码）

4. 点击「测试同步」提示成功后，再点「同步」按钮。

方案二：OneDrive

1. 同步目标选择「OneDrive」；
2. 点击「登录」，浏览器完成微软账号授权；
3. 返回 Joplin 点击「同步」。数据存放在 OneDrive 的 Apps/Joplin 目录。

方案三：自建 Nextcloud

适合已有 NAS 或 VPS 的用户：

1. 部署 Nextcloud 并创建专用账户；
2. Joplin 同步目标选 WebDAV，URL 填 https://你的域名/remote.php/dav/files/用户名/；
3. 输入账户密码或应用密码，测试同步。

# 快速部署 Nextcloud（Docker 示例）
docker run -d -p 8080:80 nextcloud

方案四：S3 兼容存储

同步目标选择「S3」，填入 Endpoint、Region、Access Key、Secret Key 与 Bucket，适合使用阿里云 OSS、腾讯 COS、Cloudflare R2 的用户。

开启端到端加密（重要）

无论使用哪种同步方案，都强烈建议开启 EES：

1. 「选项」→「加密」，点击「启用加密」；
2. 设置高强度主密码（记在密码管理器里）；
3. 在其他设备上同步后输入同一主密码完成解密。

开启后，同步服务器上只有密文，隐私内容不怕泄露。

多设备同步最佳实践

1. 首次配置顺序：先在数据量最大的一台设备完成首次上传，其他设备再同步下载，避免空数据覆盖；
2. 避免多端同时编辑同一条笔记：Joplin 按「最后写入优先」处理冲突，可能覆盖早期修改；
3. 移动端设置：手机端可在「配置同步」中设置「仅 Wi-Fi 同步」，节省流量；
4. 定期检查冲突笔记：同步冲突会生成「(冲突)」后缀的笔记副本，定期清理。

常见同步问题排查

总结

Joplin 同步的精髓在于「自由选择」：国内用户首选坚果云 WebDAV，海外用户用 OneDrive/Dropbox，极客自建 Nextcloud。无论哪种方案，配合端到端加密，就能得到一套不输商业产品、且数据完全属于自己的跨平台笔记系统。