5 分钟部署 Fast Note Sync ServiceDocker 一键搭建 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是一个高性能、低延迟的 Obsidian 笔记同步服务器提供在线笔记管理和远程 REST API 服务。本教程带你通过 Docker 一键部署 FNS5 分钟内拥有属于自己的私有笔记同步平台实现多设备实时同步、附件同步与 Web 管理面板。一、Fast Note Sync Service 是什么FNS 是一款基于 Golang WebSocket React 构建的自建笔记同步服务需要配合 Obsidian 客户端插件使用。它的核心能力包括多设备实时同步笔记变更毫秒级推送到所有在线设备️附件同步图片等大文件支持分块上传下载Web 管理面板浏览器直接管理库Vault、笔记和附件️多数据库支持原生支持 SQLite、MySQL、PostgreSQL⚙️REST API / MCP可通过脚本或 AI 助手如 Cherry Studio、Cursor读写笔记部署完成后你可以像下面这样在浏览器中管理自己的笔记库查看每个 Vault 的笔记数量与存储占用二、部署前准备环境与端口说明开始之前请确认你的服务器已安装 Docker并了解 FNS 使用的两个端口端口用途9000REST API WebSocket 同步接口/api/user/sync9001监控/度量端口数据方面FNS 依赖两个挂载目录建议放在持久化磁盘上/data/fast-note-sync/storage/笔记、附件、日志等数据/data/fast-note-sync/config/配置文件默认为 config/config.yaml三、一键启动Docker Run 方式 只需两条命令即可完成部署# 1. 拉取官方镜像 docker pull haierkeys/fast-note-sync-service:latest # 2. 启动容器 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 ps中状态为Up说明服务已成功运行。 容器内部通过 docker/entrypoint.sh 自动创建日志目录并启动服务日志滚动保存在storage/logs/下无需额外配置。四、进阶方式Docker Compose 部署如果你希望服务随机器重启自动拉起推荐使用 Compose 方式。参考仓库中的 docker/docker-compose.yaml核心内容如下services: fast-note-sync-service: image: haierkeys/fast-note-sync-service:latest container_name: fast-note-sync-service restart: always ports: - 9000:9000 volumes: - ./storage:/fast-note-sync/storage - ./config:/fast-note-sync/config然后执行docker compose up -d即可。仓库还提供了带 Nginx 反向代理的完整示例见 scripts/docker-composer/。五、首次配置注册管理员并连接 Obsidian浏览器打开http://服务器IP:9000首次访问注册账号该账号即为管理员如需关闭注册功能可在配置文件中将user.register-is-enable设为false登录后点击Copy API Config复制配置打开 Obsidian 插件设置页粘贴刚才复制的配置并保存连接成功后Obsidian 中的笔记会实时同步到服务器。在 Web 面板中你可以按路径、内容或正则搜索笔记并在线查看、编辑、恢复历史版本图片、音频等附件同样会同步上来支持在线预览与浏览器直接下载六、管理面板上手设置与版本检查进入系统设置页面可以查看当前版本、检查更新、自定义 Web 界面配色与字体以及管理鉴权 Token 加密密钥。日常更新只需docker pull后重建容器挂载的config/与storage/目录保证数据不受影响七、常见问题排查 打不开 9000 端口检查云服务器安全组/防火墙是否放行以及docker logs fast-note-sync-service中是否有报错。想换端口修改docker run的-p 9000:9000中左侧端口即可容器内端口保持不变。如何升级到新版本docker pull haierkeys/fast-note-sync-service:latest docker stop fast-note-sync-service docker rm fast-note-sync-service # 重新执行上面的 docker run 命令备份怎么办定期备份storage/目录即可服务也内置了面向 S3、OSS、WebDAV 等的定时 ZIP 备份与镜像同步能力详见配置文件 config/config.yaml 中storage相关段落。到这里你的 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-service创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考