还在为 Obsidian 同步发愁?这款开源神器,让你实现全平台秒传
大家好,我是小明同学。
如果要评选最好用的本地笔记软件,Obsidian 绝对榜上有名。
但很多 Obsidian 用户都有一个共同的痛点:多端同步怎么解决?
官方自带的 Sync 服务虽然省心,但价格确实不便宜。用 iCloud 或 OneDrive 的话,经常遇到同步慢、容易产生冲突文件的问题。而用 Git 同步,对于移动端(尤其是 iOS)来说极其折腾,每次都要手动推拉,做不到“无感”。
今天介绍一款在 GitHub 上开源的项目:Fast Note Sync For Obsidian。

版本提示: 本文截图基于 2026 年 3 月。截至 2026 年 11 月 8 日,插件最新 Release 为
2.4.0,服务端为3.6.1,示例已固定到3.6.1镜像。安全提示: 不要把服务端
9000端口直接裸露到公网。建议通过 VPN、内网访问,或放在带 HTTPS 和身份认证的反向代理后。首次注册管理员后尽快关闭注册,使用强密码,并定期备份storage与config。该插件目前在 Obsidian 社区目录中标记为未经 Obsidian 团队人工审核。
它能解决什么问题?
正如名字“Fast”一样,这款插件主打快和稳。不同于简单的同步脚本,它是一套完整的私有化同步架构。
根据其文档,它有几个核心特点:
1. 基于 Websocket 的实时同步
受够了手动点同步或者苦等网盘刷新?Fast Note Sync 基于 Websocket 构建,支持多端实时同步。你在电脑上敲下的每一行字,都会在很短的时间内同步到手机或平板上。这种体验非常接近官方的 Sync 服务。
2. 数据私有化部署
笔记是私密数据。Fast Note Sync 允许你将其部署在自己的服务器或 NAS 上。它配套了一个基于 Golang、Websocket、Sqlite 和 React 构建的高性能服务端。所有数据都在你自己的掌控中,不经过第三方服务器。
3. 全平台跨设备支持
它提供了原生插件支持,无论你使用的是 Mac、Windows,还是 Android、iOS。只要配置好服务端,各端就能随时调取最新的知识库。
4. 稳定且无打扰
它在后台悄悄运行,支持多语言,资源占用极低,不会干扰你正常的写作心流。
怎么上手使用?
因为是私有化方案,你需要简单的两步操作:
安装客户端插件:
在 Obsidian 插件市场(或通过安装包)安装 Fast Note Sync Plugin,填入你配置好的私有服务器地址。连接成功后,就可以开始同步了。
1.安装插件
- 优先 在 Obsidian 社区插件市场搜索 Fast Note Sync。如果商店版本暂未更新,再用 BRAT:搜索并安装 BRAT 插件。

进入插件设置界面, 点击 Add beta plugin 并粘贴 https://github.com/haierkeys/obsidian-fast-note-sync,最后点击Add plugin。

- 手动安装: 访问 https://github.com/haierkeys/obsidian-fast-note-sync/releases 下载安装包, 解压到 Obsidian 插件目录下 .obsidian/plugins
部署服务端:
在云服务器或 NAS 上部署 Fast Note Sync Service。服务端是用 Go 语言写的,非常轻量。配置要求不高,哪怕是最低配的 1 核 1G 服务器也能跑起来。此外,它还自带一个在线管理网页和远端 API。下面使用我本地极空间Z4Pro主力机进行部署。
1.在个人空间创建所需目录config和storage
2.打开Docker,选择Compose,点击新增项目,项目名字自定义
3.点击查询路径,找到我们刚才创建的目录,点击复制路径
1 | services: |
4.替换上述./storage和./config为我们刚才复制的路径,粘贴进黑框中,点击创建
5.访问管理面板: 在浏览器打开 http://{服务器IP或者NAS_IP}:9000。
6.初始化设置: 首次访问需注册账号。(如需关闭注册功能,请在配置文件中设置 user.register-is-enable: false)
7.配置客户端: 登录管理面板,点击 右上角头像–>“授权配置”,一键授权到Obsidian。

Obsidian同步插件配置
1.打开Obsidian,打开同步插件,可以看到远端配置已经自动配置好
2.选到同步配置,打开配置自动同步按钮
服务端同步
配置好,Obsidian的文件和配置就会自动同步到服务端了,如下图所示
如果你正在寻找一个掌控数据隐私、成本可控且足够稳定的 Obsidian 同步方案,这是个不错的选择。
插件仓库地址:https://github.com/haierkeys/obsidian-fast-note-sync
中国大陆地区,推荐使用腾讯 cnb.cool 镜像库: https://cnb.cool/haierkeys/obsidian-fast-note-sync
服务端仓库:https://github.com/haierkeys/fast-note-sync-service
中国大陆地区,推荐使用腾讯 cnb.cool 镜像库: https://cnb.cool/haierkeys/fast-note-sync-service
大家平时都在用什么方案同步 Obsidian?遇到了什么坑?欢迎在评论区交流。

