Nextcloud 同步配置与三步排错法

Nextcloud 是自托管阵营的首选，也是最容易因细节配错的目标。官方 FAQ 专门为它写了排错清单，这里整理成配置加三步排错。

配置步骤

1. 配置界面 > 同步，同步目标选 Nextcloud；
2. 填三项：

• WebDAV URL：从 Nextcloud 网页端左侧栏"设置"里复制官方给出的 WebDAV 地址；
• 用户名与密码；

1. 点"检查同步配置"验证，通过后执行首次同步。

URL 的两个致命细节

官方反复强调的坑都在 URL 上：

1. 末尾要追加你给 Joplin 的专属目录：比如基础地址是 …/remote.php/webdav/，打算让笔记放在 Joplin 子目录，就填 …/remote.php/webdav/Joplin；
2. 这个目录必须先在 Nextcloud 里手动建好——URL 里写了 Joplin 但目录不存在，同步必失败。

三步排错法

第一步：查密码。 用户名密码手动逐字输入，不要复制粘贴——粘贴常带上不可见字符。开了双因素认证（2FA）的，普通密码登录会被拒，必须到 Nextcloud 后台为 Joplin 创建应用专用密码。

第二步：查 URL。 核对是否从官方设置页复制的地址、是否补上了子目录、目录是否已存在。

第三步：查服务端。 确认 Nextcloud 服务本身可访问、WebDAV 功能未被管理员禁用。

与 E2EE 的配合

自托管用户的一大理由就是数据完全自主。建议配合端到端加密使用——即使服务器管理员也无法读取笔记内容。开启步骤见开启 E2EE 的正确步骤。

终端版用户

终端版配置方式不同：目标编号为 5（Nextcloud），用 :config 命令逐项填 URL、用户名、密码，官方帮助中心有对应命令示例。

换服务器怎么办

从一台 Nextcloud 迁到另一台（或改域名），先把旧目录里全部文件原样搬到新位置（包括 .resource 目录），再改 Joplin 的 URL——顺序反了会被判定为"远端数据被清空"而删除本地数据。这个高危操作在WebDAV 同步配置里有完整步骤。

Nextcloud 版本与界面可能随其自身更新变化，以官方最新版为准。