Fast Note Sync Service 快速开始指南4 步把 Obsidian 插件连上自建笔记同步服务【免费下载链接】fast-note-sync-serviceHigh-performance, low-latency note synchronization, online management, and remote REST API service platform.项目地址: https://gitcode.com/gh_mirrors/fa/fast-note-sync-serviceFast Note Sync Service简称 FNS是一款高性能、低延迟的自建笔记同步服务基于 Golang WebSocket React 构建。只需在自己的服务器上部署一次配合 Obsidian Fast Note Sync 插件使用就能实现笔记、附件、.obsidian配置文件的毫秒级多端实时同步数据完全自己掌控。本文用 4 步带你完成 Docker 部署与 Obsidian 插件连接全程不到 10 分钟。为什么选择自建笔记同步服务FNS 不止是同步还是一个完整的笔记管理平台核心能力说明 多端实时同步笔记变更毫秒级分发到所有在线设备支持 Vault 自动创建️ 附件同步图片、PDF、音视频等非笔记文件同步大附件分片传输 Web 管理面板浏览器里管理用户、笔记库、笔记与附件 REST API标准接口方便脚本、AI 助手对笔记增删改查 原生 MCP可接入 Cherry Studio、Cursor 等 AI 客户端让 AI 读写你的笔记️ 多数据库原生支持 SQLite、MySQL、PostgreSQL☁️ 多存储备份适配本地磁盘、S3、OSS、R2、WebDAV支持定时 ZIP 归档第 1 步用 Docker 一键部署笔记同步服务打开 Obsidian 前先准备一台服务器或家里的 NAS / 旧电脑并安装好 Docker。只需两条命令# 拉取镜像 docker pull haierkeys/fast-note-sync-service:latest # 启动容器9000 端口 挂载数据目录 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小贴士不想敲命令仓库自带 docker/docker-compose.yaml用它docker compose up -d同样可以一键启动。偏好直接装到系统项目还提供一个一键安装脚本自动注册 systemd 服务、开机自启见 scripts/quest_install.sh也支持下载 Release 二进制后执行./fast-note-sync-service run -c config/config.yaml手动运行。第 2 步打开 Web 管理面板并注册账号浏览器访问http://服务器IP:9000首次访问会让你注册一个账号——第一个注册的账号即为管理员后面可随时在面板里创建更多用户。登录后进入Vaults笔记库页面插件连接后对应的笔记库会自动出现在这里笔记和附件数量一目了然。如需关闭注册功能仅允许管理员建号修改配置文件中的user.register-is-enable: false即可完整配置见 config/config.yaml。第 3 步一键复制 API 配置登录管理面板后找到并点击复制 API 配置按钮。它会自动生成一段 JSON 配置包含服务器地址和 API Token已复制到剪贴板——千万不要泄露给他人Token 就是你这台笔记库的钥匙。第 4 步在 Obsidian 中粘贴配置完成连接打开 Obsidian → 设置 → 第三方插件 → 社区插件市场搜索并安装Fast Note Sync插件进入插件设置页把刚才复制的 JSON 配置整段粘贴进去启用插件插件会自动创建/连接 Vault 并开始双向同步。连接成功后你在任何一台设备上编辑笔记几毫秒内就会同步到其他所有设备和 Web 管理面板图片附件也会自动上传同步验证与常见问题✅验证方法在 Obsidian 新建一条笔记立即打开 Web 面板的 Notes 页面搜索能查到即表示同步链路已打通再编辑一次插件端应实时收到变更。遇到的问题解决办法打不开:9000页面检查 9000 端口是否放行防火墙/安全组、容器是否运行想用 MySQL / PostgreSQL修改database.type及连接信息默认是 SQLite 零配置外网 HTTPS 访问参考仓库中的 Nginx 反代示例 scripts/https-nginx-example.conf附件想存到网盘/对象存储配置storage段支持本地磁盘、阿里云 OSS、S3、R2、WebDAV想升级或查看版本面板系统设置页内置版本信息与在线检查更新进阶玩法连上之后还能干什么REST API用脚本或 AI 助手直接对笔记做增删改查接口文档见 docs/REST_API.mdMCP 接入把 FNS 作为 MCP 服务端接入 Cherry Studio / CursorAI 即可读写你的笔记并实时同步笔记分享生成带密码保护、短链的分享链接自动解析笔记内引用的图片附件Git 自动化笔记变更时自动推送至远程 Git 仓库天然多一层版本备份。 更多细节请参考中文文档 docs/README.zh-CN.md。部署完成后你的私有笔记同步服务就搭建完毕了——从此笔记不再依赖任何第三方网盘。【免费下载链接】fast-note-sync-serviceHigh-performance, low-latency note synchronization, online management, and remote REST API service platform.项目地址: https://gitcode.com/gh_mirrors/fa/fast-note-sync-service创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考