简体中文 / English / 日本語 / 한국어 / 繁體中文

For issues, please open a new issue, or join our Telegram group for help: https://t.me/obsidian_users

For users in mainland China, we recommend using the Tencent cnb.cool mirror: https://cnb.cool/haierkeys/fast-note-sync-service

High-performance, low-latency note sync, online management, and remote REST API service platform
Built with Golang + WebSocket + SQLite + React

Data access requires the client plugin: Obsidian Fast Note Sync Plugin

---

• 🧰 MCP (Model Context Protocol) Native Support:

  • FNS can serve as an MCP server, connecting to compatible AI clients such as Cherry Studio and Cursor, enabling AI to read and write private notes and attachments, with all changes synced to all devices in real time via WebSocket.

• 🚀 REST API Support:

  • Provides standard REST API interfaces, supporting programmatic access (e.g., automation scripts, AI assistant integration) for CRUD operations on Obsidian notes.
  • See the RESTful API Documentation or OpenAPI Documentation.

• 💻 Web Management Panel:

  • Built-in modern management interface to easily create users, generate plugin configurations, manage vaults, and note content.

• 🔄 Multi-device Note Sync:

  • Supports automatic Vault creation.
  • Supports note management (add, delete, update, query), with changes distributed in real-time to all online devices within milliseconds.

• 🖼️ Attachment Sync Support:

  • Full support for syncing non-note files such as images.
  • Supports chunked upload/download for large attachments, with configurable chunk sizes for improved sync efficiency.

• ⚙️ Config Sync:

  • Supports synchronization of .obsidian configuration files.
  • Supports PDF reading progress synchronization.

• 📝 Note History:

  • View the historical revision versions of each note on the web page and the plugin side.
  • (Requires server v1.2+)

• 🗑️ Recycle Bin:

  • Supports automatic movement of deleted notes to the recycle bin.
  • Supports restoring notes from the recycle bin. (Attachment recovery will be added in subsequent updates)

• 🚫 Offline Sync Strategy:

  • Supports automatic merging of notes edited offline. (Requires plugin-side settings)
  • Offline deletions are automatically supplemented or synced upon reconnection. (Requires plugin-side settings)

• 🔗 Sharing Feature:

  • Create/cancel note sharing.
  • Automatically resolves referenced images, audio, video, and other attachments in shared notes.
  • Provides sharing access statistics.
  • Supports setting an access password for shared notes.
  • Supports generating short links for shared notes.

• 📂 Directory Sync:

  • Supports folder create/rename/move/delete synchronization.

• 🌳 Git Automation:

  • Automatically updates and pushes to a remote Git repository when attachments and notes change.
  • Automatically releases system memory after tasks complete.

• ☁️ Multi-storage Backup & Unidirectional Mirror Sync:

  • Compatible with multiple storage protocols: S3/OSS/R2/WebDAV/Local.
  • Supports full/incremental ZIP scheduled archive backups.
  • Supports unidirectional mirror sync of Vault resources to remote storage.
  • Automatic cleanup of expired backups with configurable retention days.

• If you find this project useful and want to support its continued development, please support me via:

  Ko-fi (Outside China)		WeChat Pay (China)
  	or

  • Supporter list:
    • Support.zh-CN.md
    • Support.zh-CN.md (cnb.cool mirror)

• ♨️ View Changelog

We are continuously improving. Here are our future development plans:

• More database type support

If you have suggestions for improvements or new ideas, feel free to share them by opening an issue — we will carefully evaluate and adopt suitable proposals.

We provide multiple installation methods. One-click script or Docker is recommended.

Automatically detects the system environment and completes installation and service registration.

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

Users in China can use the Tencent cnb.cool mirror:

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

Main script behavior:

• Automatically downloads the Release binary for the current system.
• Installed to /opt/fast-note by default, with a global shortcut command fns created at /usr/local/bin/fns.
• Configures and starts a Systemd (Linux) or Launchd (macOS) service for automatic startup on boot.
• Management commands: fns [install|uninstall|start|stop|status|update|menu]
• Interactive menu: Running fns directly opens an interactive menu supporting install/upgrade, service control, boot startup configuration, and switching between GitHub/CNB mirrors.

---

# 1. Pull the image
docker pull haierkeys/fast-note-sync-service:latest

# 2. Start the container
docker run -tid --name fast-note-sync-service \
    -p 9000:9000 \
    -v /data/fast-note-sync/storage/:/fast-note-sync/storage/ \
    -v /data/fast-note-sync/config/:/fast-note-sync/config/ \
    haierkeys/fast-note-sync-service:latest

Create a docker-compose.yaml file:

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; /api/user/sync is the WebSocket endpoint
    volumes:
      - ./storage:/fast-note-sync/storage  # Data storage
      - ./config:/fast-note-sync/config    # Configuration files

Start the service:

docker compose up -d

---

Download the latest version for your system from Releases, extract and run:

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

1. Access the Management Panel: Open http://{ServerIP}:9000 in your browser.
2. Initial Setup: Register an account on first access. (To disable registration, set user.register-is-enable: false in the configuration file)
3. Configure the Client: Log in to the management panel and click "Copy API Configuration".
4. Connect Obsidian: Open the Obsidian plugin settings page and paste the copied configuration.

The default configuration file is config.yaml. The program will automatically look for it in the root directory or the config/ directory.

View the full configuration example: config/config.yaml

View the full configuration example: https-nginx-example.conf

FNS natively supports MCP (Model Context Protocol).

FNS can serve as an MCP server, connecting to compatible AI clients such as Cherry Studio and Cursor, enabling AI to read and write private notes and attachments, with all changes synced to all devices in real time via WebSocket.

FNS provides the MCP interface via the SSE protocol, with the following general parameters:

• Endpoint URL: http://<your-server-ip-or-domain>:<port>/api/mcp/sse
• Auth Header: Authorization: Bearer <your-api-token> (obtained from the "Copy API Configuration" in the WebGUI)
• Optional Header: X-Default-Vault-Name: <VaultName> (used to specify the default vault for MCP operations if the vault parameter is not provided in the tool call)

Please refer to the following configuration in your MCP client: (Note: Replace <ServerIP>, <Port>, <Token>, and <VaultName> with your actual information)

{
  "mcpServers": {
    "fns": {
      "url": "http://<ServerIP>:<Port>/api/mcp/sse",
      "type": "sse",
      "headers": {
        "Content-Type": "application/json",
        "Authorization": "Bearer <Token>",
        "X-Default-Vault-Name": "<VaultName>"
      }
    }
  }
}

• Obsidian Fast Note Sync Plugin
  • Obsidian Fast Note Sync Plugin / cnb.cool mirror
• Third-party Clients
  • FastNodeSync-CLI — A bidirectional real-time sync command-line client based on Python and the FNS WS interface, suitable for headless Linux server environments (such as OpenClaw), achieving sync capabilities equivalent to Obsidian desktop/mobile.