Fast Note Sync
约 640 字大约 2 分钟
Fast Note Sync 是 Obsidian 的多端实时同步插件，需配合自托管后端 Fast Note Sync Service 使用，支持笔记、附件与配置的跨设备同步。
前置条件
插件本身只负责客户端同步，需先部署 Fast Note Sync Service 服务端：
- 使用 Docker 等方式部署后端（可参考 fast-note-sync-service 或 Zeabur 模板）。
- 浏览器访问服务端 Web 管理面板（如
http://localhost:9000或部署后的域名）。 - 注册账号，在「Note Vaults」中创建笔记库，并获取远端服务配置字符串。
安装插件
任选一种方式：
- BRAT（推荐，支持手机）：在社区插件中安装 BRAT，在 BRAT 设置里 Add plugin，粘贴
https://github.com/haierkeys/obsidian-fast-note-sync。 - 手动安装：从 Releases 下载，解压到仓库的
.obsidian/plugins/目录。
提示
插件尚未上架 Obsidian 官方社区商店，需通过 BRAT 或手动安装。
使用步骤
1. 连接服务端
方式 A：一键授权（桌面端）
- 在服务端 Web 面板左侧选择 Note Vaults。
- 点击 「一键授权 Obsidian」，系统会唤起 Obsidian 并完成授权信息传递。
方式 B：粘贴远端配置
- 在服务端复制远端服务配置字符串。
- 打开 Obsidian → 设置 → Fast Note Sync → 点击 「粘贴远端配置」，将配置粘贴到输入框并保存。
2. 开始同步
- 在 Obsidian 设置中启用 Fast Note Sync 插件。
- 确认插件设置中监听已开启（
isWatchEnabled为 true）。 - 新建或修改笔记，插件会自动监听 Vault 内笔记的创建、更新与删除，并通过 WebSocket 实时同步。
3. 手动全量同步
若需主动拉取远端全部笔记：
- 打开插件设置页。
- 点击 「手动同步」（Manual Sync）。
- 在同步日志中查看进度，等待「同步完成」提示。
主要功能
- 笔记实时同步：自动同步 Vault 内所有
.md的增删改 - 配置同步：多端 Obsidian 配置可同步，无需手动拷贝配置文件（需插件 v1.4+、服务端 v1.0+）
- 离线删除补全：离线期间的删除/变更，下次连接时与服务端对齐
- 附件云预览：附件可在线预览，减少本地占用
- 同步日志：便于排查每次同步的详细情况