不依赖插件将 Obsidian 笔记直写 CouchDB 实现跨设备同步

Thu, 25 Jun 2026 14:29:05 +0800

背景链接到标题

我的笔记托管在 Obsidian vault 中，通过 Self-hosted LiveSync 插件 + CouchDB 实现多端同步。

问题是：我操作远端节点（Mac mini）上的 Obsidian vault 时，如果直接写文件到磁盘，Obsidian LiveSync 不会触发同步——除非 Obsidian 进程处于激活状态。Obsidian CLI 能绕过这个问题，但 CLI 依赖 Obsidian 进程的 Unix socket，存在连接挂死的风险（实测遇到过）。

所以需要一条不依赖 Obsidian 进程的同步路径：直接把笔记内容推送到 CouchDB，让其他节点上的 LiveSync 插件自动拉取。

CouchDB 中的 LiveSync 存储结构链接到标题

LiveSync 在 CouchDB 中的文档结构如下：

plain 文档 — 索引文件，记录笔记的元数据和分片引用
leaf 文档 — 存储笔记内容的分片

一条 “hello world” 笔记在数据库里是这样的：

plain 文档：

{
  "_id": "inbox/hello-world.md",
  "path": "Inbox/hello-world.md",
  "type": "plain",
  "children": ["h:xxxxxxxxxxxx", "h:yyyyyyyyyyyy"],
  "ctime": 1782357049136,
  "mtime": 1782357049137,
  "size": 143,
  "eden": {}
}

leaf 文档：

Sync on OHTLY Blog

不依赖插件将 Obsidian 笔记直写 CouchDB 实现跨设备同步

背景 链接到标题

CouchDB 中的 LiveSync 存储结构 链接到标题

背景链接到标题

CouchDB 中的 LiveSync 存储结构链接到标题