Fast Note Sync For Obsidian

Fast Note Sync 是一套专注于 Obsidian 用户的私有化笔记同步与备份解决方案，由客户端插件（Fast Note Sync for Obsidian）和服务端（Fast Note Sync Service）组成。它不依赖第三方云服务，支持 Mac、Windows、Android、iOS 全平台，提供实时同步、附件支持、配置同步与版本历史，且全部数据由用户自主掌控。

为什么选择 Fast Note Sync？

• 完全私有部署：服务端可运行在本地、NAS 或自建服务器，数据不出内网。
• 低延迟实时同步：基于 WebSocket，笔记变更毫秒级推送到所有在线设备。
• 无侵入设计：插件轻量，仅监听 .md 文件与附件变更，不影响 Obsidian 原生体验。
• 支持附件与配置同步：图片、音视频等附件可同步；1.4+ 版本起支持 .obsidian 配置文件同步（测试中）。
• 版本历史可追溯：每篇笔记的修改记录均可在插件或 Web 管理界面查看、恢复或复制。

⚠️ 注意：

• 附件同步需插件 v1.0+ 与服务端 v0.9+；
• 配置同步需插件 v1.4+ 与服务端 v1.0+，目前处于测试阶段；
• 不同步 Obsidian 的设置文件（如 app.json），避免冲突。

核心组件

1. Obsidian 插件：Fast Note Sync

• 极简配置：粘贴服务端生成的配置即可启用。
• 自动监听 Vault 内所有 .md 文件的创建、修改、删除。
• 支持多语言界面，适配主流操作系统。

📌 当前插件尚未上架 Obsidian 官方社区商店，请手动安装：

1. 访问 GitHub Releases
2. 下载 ZIP 包，解压至 .obsidian/plugins/obsidian-fast-note-sync/
3. 在 Obsidian 设置中启用插件，并粘贴服务端提供的配置。

2. 服务端：Fast Note Sync Service

基于 Golang + WebSocket + SQLite + React 构建，主打高性能与低资源占用。

主要功能：

• 🖥️ Web 管理面板（端口 9000）：创建用户、管理仓库、查看笔记、生成客户端配置。
• 🔄 多端实时同步：支持自动创建 Vault，变更实时广播。
• 📎 附件同步：支持图片、音频、视频等非配置类文件。
• 📜 笔记历史：每篇笔记的完整修改历史（需服务端 v1.2+）。
• ⚙️ 配置同步：同步 .obsidian 目录下的插件与主题配置（需 v1.0+，测试中）。

快速部署服务端（三选一）

✅ 推荐方式：一键脚本（自动注册 systemd 服务）

bash <(curl -fsSL https://raw.githubusercontent.com/haierkeys/fast-note-sync-service/master/scripts/quest_install.sh)

• 自动下载适配系统的二进制文件
• 安装至 /opt/fast-note，创建 fast-note 命令
• 启用开机自启，支持 start|stop|status|update 等管理命令

🐳 Docker 部署（适合已有容器环境）

# 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"  # HTTP API
      - "9001:9001"  # WebSocket
    volumes:
      - ./storage:/fast-note-sync/storage  # 笔记与附件存储
      - ./config:/fast-note-sync/config    # 配置目录

运行：docker compose up -d

💻 手动运行（高级用户）

从 Releases 下载二进制，执行：

./fast-note-sync-service run -c config/config.yaml

使用流程

1. 启动服务端，访问 http://你的服务器IP:9000
2. 首次使用需注册管理员账号（可在配置中关闭公开注册）
3. 登录后，点击 “复制 API 配置”
4. 在 Obsidian 插件设置中 粘贴该配置，点击“连接”
5. 插件自动开始同步当前 Vault，后续所有操作实时生效

适合谁用？

• 希望 完全掌控笔记数据，拒绝第三方云同步的 Obsidian 用户
• 需要在 多台设备间无缝切换，且要求低延迟同步
• 已有 NAS、树莓派、云服务器，愿意花 5 分钟部署私有服务
• 对配置一致性有需求（如多台电脑使用相同插件布局）