Obsidian 最佳多端同步方案
概述
Obsidian 官方提供的同步服务价格不菲，而基于 iCloud / OneDrive 等网盘的方案在多端同步时常常遇到冲突和延迟问题。Fast Note Sync 是一个开源的自建同步方案，通过 WebSocket 实现实时双向同步，配合 Obsidian 插件，可以在全平台无缝协作。
主要特性
- 实时同步：基于 WebSocket，笔记修改后即时同步到所有设备
- 附件支持：图片、PDF 等附件完整同步
- 配置同步：Obsidian 设置、主题、插件配置跨设备统一
- 离线编辑：断网时正常编辑，恢复连接后自动合并
- 笔记历史：保留修改历史，支持回滚到任意版本
- 回收站：误删文件可恢复
NOTEFast Note Sync 使用 Golang + WebSocket + SQLite 构建，资源占用极低，适合部署在轻量 VPS 或 NAS 上。
部署服务端
使用一键脚本部署
适用于 Linux 服务器，脚本会自动检测系统环境并创建 Systemd 服务：
bash <(curl -fsSL https://raw.githubusercontent.com/haierkeys/fast-note-sync-service/master/scripts/quest_install.sh)使用 Docker 部署
创建 docker-compose.yml 文件：
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" - "9001:9001" volumes: - ./storage:/fast-note-sync/storage - ./config:/fast-note-sync/config启动服务：
docker-compose up -dWARNING端口说明：
9000：API 端口，用于 Web 管理面板和 REST 接口9001：WebSocket 端口，用于笔记实时同步
初始化配置
- 浏览器访问
http://<你的服务器IP>:9000，进入 Web 管理面板。 - 首次访问需要注册账户，设置用户名和密码。
- 进入管理面板后，点击 复制 API 配置，保存备用。
WARNING注册完成后，建议修改配置文件
config.yaml关闭公开注册：修改后重启服务生效。
反向代理如需通过域名访问，可使用 Nginx Proxy Manager 反向代理
9000和9001端口，并启用 SSL 加密。WebSocket 端口9001需要在 NPM 的 Custom Locations 中配置ws协议支持。
配置 PC 端
PC 端（Windows / macOS / Linux）通过安装 Obsidian 插件实现同步。
安装插件
方式一：通过 BRAT 安装（推荐）
- 先安装 BRAT 插件。
- 打开 BRAT 设置 → 点击 Add beta plugin。
- 输入仓库地址：
https://github.com/haierkeys/obsidian-fast-note-sync。 - 等待安装完成后启用插件。
方式二：手动安装
- 前往 Releases 下载最新版本。
- 解压到 Obsidian 仓库的
.obsidian/plugins/目录下。 - 重启 Obsidian，在设置中启用插件。
配置同步
- 打开 Obsidian 设置 → 第三方插件 → Fast Note Sync。
- 点击 Paste Remote Config（粘贴远程配置）按钮。
- 粘贴在服务端管理面板中复制的 API 配置信息。
- 配置完成后，插件会自动开始同步。
同步排除在插件设置中可以配置 Sync Exclusion & Whitelist，排除不需要同步的文件或文件夹（如
.obsidian/workspace.json等本地状态文件）。
macOS 注意事项
如果 Obsidian 来自非 App Store 渠道且系统阻止打开，执行：
sudo xattr -d com.apple.quarantine /Applications/Obsidian.app配置手机端
手机端（iOS / Android）同样通过安装 Obsidian 插件实现同步，配置流程与 PC 端一致。
iOS
- 在 App Store 下载 Obsidian。
- 创建或打开一个仓库（选择”在此设备上存储”即可）。
- 安装 BRAT 插件，然后通过 BRAT 安装 Fast Note Sync 插件（步骤同 PC 端）。
- 粘贴远程配置，等待首次同步完成。
Android
- 在 Google Play 或 GitHub 下载 Obsidian。
- 创建仓库，推荐存储在内部存储。
- 安装 BRAT → 安装 Fast Note Sync 插件 → 粘贴远程配置。
首次同步时，如果 PC 端仓库内容较多，手机端可能需要较长时间完成初始同步。建议在 Wi-Fi 环境下进行，避免中途关闭 Obsidian。
多端同步注意事项
- 首次使用：建议先在一台设备上完成全部笔记和配置，再在其他设备上安装插件并同步，避免空仓库覆盖已有内容。
- 冲突处理：如果多台设备同时编辑同一篇笔记，Fast Note Sync 会自动合并修改。极端情况下的冲突会保留双方版本，需手动处理。
- 版本回滚：在 Web 管理面板中可以查看笔记的修改历史，选择任意版本进行恢复。