多设备同步总览先在第一台设备完成上传

同步是 Joplin 体验闭环的核心，也是新手最容易配错的一环。这一页讲清原理和顺序，后面几页再逐个配置具体服务。

同步的底层逻辑

Joplin 的同步架构不绑定任何厂商：同步过程抽象成通用接口，具体云端（Nextcloud、Dropbox、OneDrive、WebDAV、S3 等）只是"能读写删除列出文件"的驱动。所以：

• 换同步服务很简单，数据结构在哪个目标都一样；
• 同步目录里的内容本质是一个开放格式数据库，应用自己管理，不要手工编辑里面的文件。

首次配置的正确顺序（重要）

官方帮助中心反复强调的顺序问题：

1. 只在第一台设备上配置同步目标；
2. 在这台设备上执行"同步"，把全部笔记上传到云端；
3. 盯着侧栏同步进度，直到显示完成；
4. 这时才去第二台设备安装 Joplin、配置同一个同步目标；
5. 第二台设备执行同步，笔记下载下来。

顺序反了的典型症状：第二台设备上先建了一堆本地笔记，同步后出现大量冲突或数据不一致。

日常同步机制

• 应用运行期间自动后台同步，内容一有变化就会触发；
• 也可以随时点"同步"按钮手动触发；
• 终端版可在 shell 里执行 joplin sync，配合定时任务实现无人值守同步；
• 移动端例外：应用退后台/锁屏后同步中断，需要手动触发，见移动端常见问题。

配置入口

配置界面（桌面 Ctrl+,，移动端左上角菜单）> 同步：选择同步目标、填凭据、测试连接。

接下来按你选的服务读对应页：

同步行为细节可能随版本变化，以官方最新版为准。