Joplin WebDAV同步配置教程：坚果云/Nextcloud一站搞定

为什么选择WebDAV同步Joplin

Joplin支持多种同步方式，其中WebDAV是一种非常灵活且自主可控的方案。相比Joplin Cloud或OneDrive等商业同步服务，WebDAV让你可以选择自己的服务器或信任的第三方网盘，避免被单一服务商锁定。

对于国内用户来说，坚果云提供的WebDAV服务是最常用的选择之一。对于技术用户，Nextcloud、群晖NAS等自托管方案则提供了更高的数据控制权。

WebDAV同步的工作原理

Joplin的WebDAV同步流程如下：

1. Joplin将笔记数据打包成加密或不加密的文件
2. 通过WebDAV协议上传到指定的服务器目录
3. 其他设备通过WebDAV读取这些文件
4. Joplin自动合并不同设备上的修改

整个过程对用户透明，只需要配置一次，之后就可以自动同步。

准备工作

确认WebDAV服务可用

无论使用哪种WebDAV服务，都需要提前准备好：

• WebDAV服务器地址
• 用户名
• 密码或应用密码
• 一个用于Joplin同步的专用目录

建议的同步目录结构

在WebDAV服务器上为Joplin创建独立目录，例如：

/joplin-sync/

避免与其他应用混用同一个目录，防止文件冲突。

坚果云WebDAV配置

获取坚果云WebDAV信息

1. 登录坚果云网页版
2. 点击右上角头像 → 「账户信息」
3. 选择「安全选项」
4. 在第三方应用管理中添加Joplin应用
5. 系统会生成专用的应用密码
6. 记录服务器地址、账号和应用密码

Joplin中配置坚果云同步

1. 打开Joplin
2. 点击「工具」→「选项」→「同步」
3. 同步目标选择「WebDAV」
4. WebDAV URL填写坚果云提供的服务器地址
5. 用户名填写坚果云账号
6. 密码填写应用密码（不是登录密码）
7. 点击「检查同步配置」
8. 如果显示成功，点击应用并开始同步

坚果云注意事项

• 免费用户有每月上传和下载流量限制
• 注意查看流量使用情况，避免超额
• 建议开启Joplin端到端加密，保护笔记内容
• 同步目录建议专门新建一个

Nextcloud WebDAV配置

获取Nextcloud WebDAV地址

1. 登录Nextcloud网页版
2. 点击左下角「设置」
3. 在左侧找到「管理」→「概览」
4. 页面底部会显示WebDAV地址，通常是：

   https://your-nextcloud-domain/remote.php/dav/files/username/

5. 在末尾加上Joplin专用目录，例如：

   https://your-nextcloud-domain/remote.php/dav/files/username/joplin/

Joplin中配置Nextcloud

1. 打开Joplin同步设置
2. 选择「WebDAV」
3. URL填入上面拼接好的地址
4. 用户名填入Nextcloud账号
5. 密码填入Nextcloud密码或应用密码
6. 检查配置并应用

使用Nextcloud应用密码

为了安全，建议创建专用应用密码：

1. 登录Nextcloud
2. 点击头像 →「个人设置」→「安全」
3. 在「设备和会话」下创建应用密码
4. 命名为「Joplin Sync」
5. 复制生成的密码到Joplin中使用

群晖NAS WebDAV配置

开启群晖WebDAV服务

1. 登录群晖DSM
2. 打开「套件中心」
3. 安装「WebDAV Server」套件
4. 打开WebDAV Server设置
5. 启用HTTP或HTTPS（建议HTTPS）
6. 设置端口号（默认5005/5006）

配置Joplin同步群晖

群晖WebDAV地址格式：

https://your-synology-domain:5006/home/joplin/

或者使用QuickConnect ID：

https://your-id.quickconnect.to:5006/home/joplin/

将地址、用户名、密码填入Joplin WebDAV设置中即可。

端到端加密设置

为什么建议开启加密

即使使用可信的WebDAV服务，开启端到端加密也能确保：

• 服务商无法读取笔记内容
• 数据在传输和存储过程中都是密文
• 即使账号被盗，笔记内容仍然安全

开启加密步骤

1. 在Joplin中进入「工具」→「选项」→「加密」
2. 点击「启用加密」
3. 设置主密码（务必牢记，无法找回）
4. 在所有设备上输入相同主密码
5. 等待加密同步完成

加密注意事项

• 主密码丢失后无法恢复笔记
• 首次加密同步可能需要较长时间
• 所有设备都需要升级到支持加密的版本

常见同步问题与解决

同步失败：授权错误

如果提示用户名或密码错误：

1. 检查是否使用了应用密码而非登录密码
2. 确认URL拼写正确
3. 检查账号是否有WebDAV访问权限
4. 尝试在浏览器中访问WebDAV地址测试

同步冲突

当多个设备同时修改同一笔记时可能出现冲突：

1. Joplin会生成冲突笔记副本
2. 手动对比并合并内容
3. 删除不需要的副本
4. 重新同步

同步速度慢

优化同步速度的方法：

• 检查网络连接是否稳定
• 减少单次同步的笔记数量
• 关闭不必要的附件自动同步
• 使用距离更近的服务器

无法连接WebDAV服务器

排查步骤：

1. 检查网络是否通畅
2. 确认服务器地址和端口正确
3. 检查防火墙是否放行WebDAV端口
4. 确认SSL证书是否有效（HTTPS情况下）

不同平台配置差异

Joplin在Windows、macOS、Linux、Android、iOS上的WebDAV配置基本一致：

1. 打开设置 → 同步
2. 选择WebDAV
3. 输入URL、用户名、密码
4. 检查配置

移动端通常需要在设置中找到「同步」或「Synchronisation」选项。

WebDAV与其他同步方式对比

最佳实践建议

为了让WebDAV同步更稳定可靠，建议：

1. 专用目录：为Joplin创建独立同步目录
2. 定期备份：不要完全依赖同步，定期导出备份
3. 开启加密：保护敏感笔记内容
4. 监控流量：注意坚果云等服务的流量限制
5. 保持更新：及时升级Joplin版本
6. 避免冲突：不要同时在多个设备编辑同一笔记

总结

WebDAV是Joplin最灵活的同步方案之一，特别适合希望掌控数据主权的技术用户。坚果云是国内最容易上手的WebDAV服务，Nextcloud和群晖NAS则适合有自托管能力的用户。配置时最重要的是正确填写服务器地址、用户名和应用密码，并强烈建议开启端到端加密。遇到同步问题时，优先检查授权信息、网络连接和服务器地址拼写。