Self-hosted LiveSync

Self-hosted LiveSync 是社区开发的 Obsidian 同步插件，面向希望掌控服务端和数据路径的用户。它可以把仓库连接到 CouchDB、对象存储或实验性的 WebRTC 点对点通道，并支持端到端加密和基础冲突处理。

三条同步路径

CouchDB

CouchDB 是项目文档最完整的部署路径，可运行在自有服务器、树莓派或云主机。使用者需要配置数据库、账户、CORS、HTTPS、反向代理和备份，不能只完成容器启动就视为可长期运行。

对象存储

插件也支持 MinIO、S3、Cloudflare R2 等对象存储。它能减少维护完整数据库服务的需求，但 bucket 权限、访问密钥、区域、API 费用和数据恢复仍由使用者负责。

WebRTC

WebRTC 可以在没有固定服务器的情况下进行点对点同步，不过官方仓库将它标为实验性能力，而且至少要有一个可连接的在线端点。它适合测试和特定网络条件，不应直接替代已经稳定运行的生产同步链路。

第一次部署的安全顺序

1. 关闭 Obsidian，完整复制仓库和 .obsidian 配置目录。
2. 只在测试仓库中安装插件，选择 CouchDB 或对象存储中的一种后端。
3. 配置端到端加密与远端权限，运行插件提供的连接检查。
4. 先让主设备完成第一次上传，再逐台接入其他设备。
5. 验证新增、重命名、删除、附件与冲突文件后，才迁移正式仓库。

设置与插件如何同步

LiveSync 可通过 Customisation Sync（Beta）或 Hidden File Sync 同步设置、片段、主题和插件。移动端与桌面端的插件能力、启动时间和配置需求并不总是相同，开启前应决定是否需要独立配置档案，并保留可恢复的 .obsidian 副本。

运行时必须盯住的状态

状态栏会显示网络请求、上传下载、待处理数据和错误。项目建议在进度指示消失前不要关闭 Obsidian，尤其是在删除或重命名大量文件之后。升级插件或服务器前也应先备份仓库与后端数据。

不可混用：项目明确说明它不能与官方 Obsidian Sync 同时同步，也不应和 iCloud 或其他同步服务共同监听同一仓库，否则可能产生重复和损坏。

如果还没有确定是否值得承担服务器、数据库、证书和升级维护，可先查看 Obsidian 官方 Sync、网盘、Syncthing 与插件方案对比。Self-hosted LiveSync 适合明确需要自托管并能维护备份的人，不是所有多设备笔记用户的默认选项。

适合谁接手维护

它适合已经会维护数据库、对象存储、TLS 和备份恢复，希望自托管笔记同步的研究者、工程师和高级用户。若只是想让电脑与手机稳定同步，不愿承担服务器安全和故障恢复，官方 Sync、系统云盘或更简单的插件通常更合适。项目采用 MIT 许可证。

官方仓库：https://github.com/vrtmrz/obsidian-livesync