Joplin教程
🤖 摘要：本文解析Joplin的本地优先架构与同步机制，详述坚果云与群晖WebDAV配置方法。涵盖冲突处理、大附件管理、移动端优化及数据备份等跨平台实践，并提供笔记整理建议，助力用户安全高效实现多端无缝同步。
你提供的标题非常清晰，但 <code>Starred Blocks:</code> 后方为空。如果你是在整理技术博客/文档的目录或核心知识点，我可以先为你补全该系列 01 篇 的完整技术框架与可落地内容。后续你只需将 <code>Starred Blocks</code> 替换为你的核心笔记/代码块/配置示例即可。
🔍 一、Joplin 开源架构核心解析
| 层级 | 技术栈/机制 | 说明 |
|---|---|---|
| 客户端 | Electron (桌面) / React Native (移动) / Headless CLI / Browser Extension | 统一渲染层，共享核心逻辑 |
| 数据存储 | SQLite + AES-256 本地加密 | 笔记、标签、资源、元数据均落盘于本地 DB，主密码可选加密 |
| 同步引擎 | Plugin Architecture (Sync Provider) | 内置 WebDAV/Dropbox/OneDrive/S3/Nextcloud，扩展性强 |
| 同步协议 | RESTful + 文件哈希比对 + 时间戳冲突检测 | 无中心服务器，纯点对点/云存储托管模式 |
| 开放生态 | MIT License + Joplin API (v2) | 支持 Web Clipper、Markdown/HTML/JEX 导出、第三方插件（如 Mermaid/Excalidraw） |
💡 架构亮点：Joplin 采用 <code>Local-First + Sync-As-Plugin</code> 设计，数据所有权完全归属用户，同步层与业务层解耦，适合私有化部署与高隐私场景。
🌐 二、WebDAV 多端同步配置指南（坚果云 & 群晖）
1. 坚果云（国内推荐）
- WebDAV 地址：<code>https://dav.jianguoyun.com/dav/</code>
- 认证方式：账号 + 应用专用密码（非登录密码，需在 <code>账户设置 → 安全设置 → 应用密码</code> 生成）
- 同步频率：建议桌面端 <code>30s~1min</code>，移动端 <code>5~10min</code>（省流量/省电）
- 注意事项：免费版同步流量 1GB/月，建议配合 <code>Joplin CLI</code> 定期导出 <code>jex</code> 备份
2. 群晖 NAS（私有化部署）
- 开启服务：<code>文件管理器 → 设置 → WebDAV 服务 → 启用 HTTPS + 端口(默认5005/5006)</code>
- 客户端配置：
// Joplin Options → Sync → WebDAV "url": "https://<你的NAS域名或IP>:<端口>/webdav/", "user": "<群晖账号>", "pass": "<应用密码或原始密码>", "useSSL": true, "verifySSL": false // 自签证书可关闭，生产环境建议配置CA或Let's Encrypt - 性能优化：在群晖 <code>Docker</code> 部署 Joplin Server（官方支持）可彻底摆脱 WebDAV 文件碎片化问题，适合多用户/高并发场景。
🛠️ 三、全平台同步最佳实践
| 场景 | 推荐方案 | 避坑指南 |
|---|---|---|
| 冲突处理 | Joplin 自动保留 <code>.jplink</code> 冲突文件，定期执行 <code>Tools → Sync → Check for conflicts</code> | 勿手动重命名同步中的文件，易导致哈希断裂 |
| 大附件同步 | 启用 <code>Options → Advanced → Resource storage: Link to local file</code>（仅桌面端） | WebDAV 单文件建议 <50MB，超限改用 S3/网盘直链 |
| 移动端省电 | iOS/Android：关闭 <code>Sync on background</code>，改为 <code>WiFi only + 手动触发</code> | 避免开启 <code>实时同步</code> 导致后台频繁唤醒 |
| 数据兜底 | 每月执行 <code>File → Export → JEX (all resources)</code> + WebDAV 版本快照 | JEX 为官方无损备份格式，支持完整还原标签/笔记/资源树 |
| 多端一致性 | 桌面端编辑后，等待同步完成图标变绿再关闭；移动端首次打开建议 <code>手动同步</code> | 避免网络切换期同时写入，触发 <code>Merge failed</code> |
📦 附：<code>Starred Blocks</code> 可填充项建议
如果你是在整理技术笔记，可将以下模块作为 <code>Starred Blocks</code> 的核心内容：
- [ ] Joplin WebDAV 配置截图/JSON片段
- [ ] 坚果云/群晖 WebDAV 测试连通命令（curl/wget）
- [ ] 冲突文件自动清理脚本（Python/Bash）
- [ ] Joplin CLI 批量导出/导入示例
- [ ] Docker Compose 部署 Joplin Server（可选进阶）如需我：
- 生成对应环境的完整配置模板（含群晖 HTTPS 证书部署/坚果云流量监控）
- 补充 <code>Joplin Server</code> 私有化对比方案（自托管 vs WebDAV）
- 将本文转为 Markdown/Notion/Obsidian 兼容格式
请回复你的具体需求或补充 <code>Starred Blocks</code> 内容，我将按你的技术栈继续深化。
