我终于找到了比官方更丝滑的 Obsidian 同步方案

在几个月前我发布过介绍 Obsidian 同步方案的视频，目前已经有2万多的播放量了：

在 YouTube 上观看

哔哩哔哩

在那之后，我其实一直是 Self-hosted LiveSync 的忠实拥护者。

Pasted image 20260526102743.png

因为它确实很强。实时同步很丝滑，冲突处理也非常聪明。哪怕我有三四个设备同时编辑一个文档，它也能帮我合并好。

但它也有一个我越来越受不了的问题：它依赖 Apache CouchDB 做实时同步，而 CouchDB 里的内容我们是没办法像普通文件那样直接查看和管理的。

更麻烦的是，LiveSync 删除文件并不是真的“删掉”，而是打一个删除标记。这样其他设备才能知道哪些内容被删了，哪些内容被改了。

这样一来，数据库会越来越大，最后可能变成你本地仓库的两倍、三倍。

你当然可以重建数据库，不过设备一多，重建和重新拉取的过程就很容易出问题，而且速度也慢。

Pasted Image 20260526102505_697.png

后来我注意到一个国内开发者做的同步方案。当时我其实没太在意，心里想的是：我都已经有 LiveSync 了，为什么还要换一个新轮子？

但等我真的被 LiveSync 折腾烦了之后，去试了一下这个插件，第一感觉就是：这东西有点厉害。

这个开发者更新非常勤快，功能也做得越来越完整。对我来说，它最打动我的地方不是“又一个同步插件”，而是它把很多以前不好处理的事情都补上了。

Pasted image 20260526102039.png

除了实时同步之外，它还有几个我特别喜欢的点：

这个插件提供了一个 Web 的管理页面，在这个页面里我可以直接看到笔记并且编辑，而且可以直接管理我的附件，甚至我可以直接管理我的回收站里面的内容
它的配置也很简单，只需要在后台生成一个 token，然后授权就可以了
而且你可以直接去把笔记链接分享出去，用你的服务器的地址，而且还可以加密码，这也是非常方便的
同时它还有 AI 功能，可以直接开放 API 端口，让 AI 通过网络访问你的仓库内容，不需要在本地一直挂着。而且这个 API 是支持读写笔记的，也就是说 AI 可以直接帮你修改笔记
可以非常方便的同步 Obsidian 的配置文件，配置设置，而且可以在外部页面去修改
每次的同步记录，包括删除的文档，都可以很清楚地看到，恢复起来也方便很多
可以有自动化任务，比如说定时备份，并且可以直接把仓库上传到 GitHub

如果你想看完整的演示过程、插件实际界面，以及我为什么会觉得它比官方还丝滑，我会把详细视频放在这篇文章后面。本文就只保留最核心的部署内容。

在 YouTube 上观看

部署方法

服务端

安装服务

这里需要大家有1台VPS和一个域名，然后搭建 haierkeys/fast-note-sync-service

Pasted image 20260526103718.png

推荐使用 Docker Compose，在目标文件夹创建 docker-compose.yaml 然后粘贴：

version: '3'
services:
  fast-note-sync-service:
    image: haierkeys/fast-note-sync-service:latest
    container_name: fast-note-sync-service
    restart: always
    ports:
      - "9000:9000"  # RESTful API & WebSocket port, where /api/user/sync is the WebSocket endpoint
    volumes:
      - ./storage:/fast-note-sync/storage  # Data storage
      - ./config:/fast-note-sync/config    # Configuration files

说明：

国内用户可以使用镜像：docker.cnb.cool/haierkeys/fast-note-sync-service:latest

反代配置

官方提供了一个 Nginx 反代配置示例

我自己用的是 Caddy，只要简单添加一个网站就可以了，剩下的都会自动配置好。

demo.weichen.ink {
    reverse_proxy localhost:9000
}

安装插件

进入 Obsidian 设置页面，打开第三方插件标签，搜索 Fast Note Sync 然后安装即可。

截屏2026-05-26 10.40.30.png

同步仓库

访问管理面板：在浏览器打开 http://{服务器IP}:9000。
初始化设置：首次访问需注册账号。(如需关闭注册功能，请在配置文件中设置 user.register-is-enable: false)
配置客户端：登录管理面板，点击 “复制 API 配置”。
连接 Obsidian：打开 Obsidian 插件设置页面，粘贴刚才复制的配置信息即可。

最后

如果你现在也在找一个比官方更省钱、比传统替代方案更顺手，而且又能兼顾 Web 管理和 AI 接入的 Obsidian 同步方案，我觉得这个方案很值得你试一下。

至于它实际用起来到底有多顺、界面长什么样、还有哪些需要注意的地方，我会在视频里详细展开。