Self-hosted LiveSync 插件配置与维护

本文是 Self-hosted LiveSync 系列 的插件配置篇。请确保已完成 CouchDB + Caddy 服务端部署 再继续。

安装插件

打开 Obsidian，进入 设置 → 社区插件 → 浏览，搜索 Self-hosted LiveSync，安装并启用。

⚠️ 安装前先备份你的 vault。

⚠️ 不能与其他同步方案同时运行。如果你之前用 iCloud、官方 Sync 或 Remotely Save，先暂停它们。

第一台设备：Setup Wizard 配置

插件启用后会弹出向导，选择 Minimal Setup，按以下步骤操作：

1. 选择远程类型

选 CouchDB。

2. 填写连接信息

3. 测试连接

点击测试，插件会自动检查配置并给出修复建议，按提示处理即可。

4. 开启端对端加密（强烈建议）

设置一个 E2EE 加密密码（Passphrase），用于加密笔记内容。所有设备必须使用同一个密码，丢失后数据无法恢复，请妥善保存。

同时建议开启 Path Obfuscation（路径混淆），让服务器上的文件名也变成密文。

5. 选择同步模式

选 LiveSync（实时同步）。

6. 生成 Setup URI

这一步将你的配置导出为加密字符串，用于快速配置其他设备。可以自己设置 URI 密语，或让插件自动生成一个（类似 patient-haze 的短语）。URI 和密语都要记下来。

注意区分两个密码：

• E2EE 加密密码：加密笔记内容，所有设备必须相同
• URI 密语：仅用于解密 Setup URI，只在导入配置时使用一次

后续设备：用 Setup URI 导入

在新设备上安装插件后，打开命令面板，搜索 “Use the copied setup URI”，粘贴 URI 并输入 URI 密语。

系统会询问这是否是后续设备，选择是。等待状态栏的同步指示器消失后重启 Obsidian。

⚠️ 指示器消失前不要关闭 Obsidian，否则可能导致数据不完整。

数据库维护

这是 LiveSync 长期使用绕不开的话题。

为什么数据库会越来越大

CouchDB 是只追加写入的数据库，每次文件改动都产生新版本，旧版本不自动删除。插件默认为每个文档保留约 100 个历史版本，文件删除后旧数据块也不会自动清理。插件作者明确表示，在多设备同步环境下无法安全地自动回收垃圾数据，所以没有自动清理机制。

实际存储占用通常是 vault 原始大小的 1.3–2.5 倍，开启加密后更大。

预防措施（建好就配）

进入插件设置 → 10. Patches，开启：

• Do not keep metadata of deleted files：删除笔记后不保留元数据
• Delete old metadata of deleted files on start-up：每次启动时自动清理已删除文件的旧元数据

进入高级设置，开启：

• Batch database update：将频繁编辑时的写入合并批处理，减慢版本堆积速度

数据库已经很大了怎么处理

入口在 设置 → 11. Maintenance：

• Perform cleanup：清理旧版本历史，速度较快，但不能清理孤立数据块
• Rebuild everything：清空本地和远端数据库，从本地文件重新上传——最彻底，但需要重新全量同步

插件作者的原话：只有 Rebuild everything 能真正有效缩小数据库体积。

常见问题

连接失败 检查防火墙是否开放 80、443 端口。先在浏览器访问 https://你的域名/e=_/_utils/ 确认服务端正常，再排查插件配置。

移动端连接失败 移动端强制要求 HTTPS，纯 HTTP 会被直接拒绝。在浏览器里打开域名确认没有证书警告。

CORS 报错 检查 local.ini 里 origins 一行，三个来源缺一不可：app://obsidian.md,capacitor://localhost,http://localhost，注意不要有多余空格。

数据目录权限问题 CouchDB 容器以 uid 5984 运行，目录权限不对时容器会退出：

chown -R 5984:5984 ~/livesync/data/couchdb