Fast Note Sync Service 部署指南一键脚本、Docker 与二进制 3 种安装方式怎么选【免费下载链接】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 ServiceFNS是一个高性能、低延迟的笔记同步、在线管理与远程 REST API 服务平台基于 Golang WebSocket React 构建可让 Obsidian 笔记在多台设备间实时同步并支持附件、配置、Git 自动化与云存储备份。本文将从一键脚本、Docker、二进制文件3 种安装方式带你完成 Fast Note Sync Service 部署帮新手快速选对方案。3 种安装方式怎么选对比维度一键脚本 ⭐推荐Docker手动二进制上手难度一条命令需了解容器基础需手动配置开机自启自动注册系统服务restart: always需自行配置升级方式fns update一键升级重新拉取镜像手动替换文件适用场景个人服务器 / 树莓派已有容器环境的用户离线环境 / 深度定制 简单结论个人用户优先选一键脚本有容器基础选Docker离线内网或想深度改造才用二进制。方式一一键脚本安装推荐一条命令自动完成 Fast Note Sync Service 部署脚本会自动检测系统环境、下载对应平台的 Release 二进制文件并完成服务注册安装脚本位于 scripts/quest_install.shbash (curl -fsSL https://raw.githubusercontent.com/haierkeys/fast-note-sync-service/master/scripts/quest_install.sh)国内网络环境可使用腾讯cnb.cool镜像源加速下载bash (curl -fsSL https://cnb.cool/haierkeys/fast-note-sync-service/-/git/raw/master/scripts/quest_install.sh) --cnb脚本会自动帮你做什么下载适配当前系统的二进制安装到/opt/fast-note在/usr/local/bin/fns创建全局快捷命令fns配置并启动SystemdLinux或LaunchdmacOS服务实现开机自启安装完成后日常运维只需记住fns这个命令fns status # 查看服务状态 fns stop # 停止服务 fns update # 一键升级到最新版 fns # 直接回车进入交互式管理菜单交互式菜单支持安装/升级、服务控制、开机自启配置以及 GitHub / CNB 镜像源切换对新手非常友好。方式二Docker 部署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:latestDocker 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 # RESTful API 与 WebSocket 端口 volumes: - ./storage:/fast-note-sync/storage # 笔记与附件数据 - ./config:/fast-note-sync/config # 配置文件docker compose up -d几个关键点9000 端口同时承载 RESTful API 和 WebSocket 接口/api/user/sync为同步地址客户端通过它实时接收毫秒级变更storage目录存放笔记、附件和数据库请定期备份容器基于 Alpine glibc 构建镜像体积小见 docker/Dockerfile启动脚本 docker/entrypoint.sh 会自动管理日志轮转方式三手动二进制安装下载对应平台的发布包并运行从项目 Releases 页面下载与你系统匹配的二进制包支持 Linux amd64/arm64/arm、macOS Intel/Apple Silicon、Windows解压后直接运行./fast-note-sync-service run -c config/config.yaml没有外网的离线环境怎么办可以先从有网的机器 clone 仓库源码git clone https://gitcode.com/gh_mirrors/fa/fast-note-sync-service再用 Makefile 交叉编译后拷贝到内网机器例如make build-linux-arm64 # 产物在 build/linux_arm64/这种方式不注册系统服务适合需要自行用systemd单元文件托管、或做深度定制的场景。部署完成后的 4 步快速上手访问管理面板浏览器打开http://{服务器IP}:9000初始化账号首次访问需注册管理员账号如需关闭注册在配置文件中设置user.register-is-enable: false获取客户端配置登录后点击“Copy API Config”复制 API 配置连接 Obsidian在 Obsidian Fast Note Sync 插件设置页粘贴配置笔记即开始实时同步同步成功后你可以在 Web 管理面板直接搜索和编辑笔记搜索支持路径、内容和正则三种模式附件图片等也会同步到服务端并在 Vault 卡片中统计大小系统设置页可查看当前版本、检查更新并配置主题外观与密钥常用配置参数速查默认配置文件为config.yaml程序会自动在根目录或config/目录下查找完整示例见 config/config.yaml配置项默认值说明server.http-port:9000HTTP / WebSocket 监听端口server.run-moderelease可切为debug便于排查部署问题app.temp-pathstorage/temp临时文件目录user.register-is-enabletrue是否允许 Web 面板注册新账号进阶Nginx 反向代理配置示例公网部署建议套一层 Nginx 反代并配置 HTTPS完整示例见 scripts/https-nginx-example.conf。如果你的反向代理部署在独立主机上记得把代理 IP 加入配置中的trusted-proxies白名单否则系统会忽略其转发的 Host 头。常见问题 FAQQ1部署后无法访问 9000 端口先确认防火墙/安全组已放行 9000 端口容器部署再检查docker ps容器状态和端口映射。Q2客户端连不上 WebSocket 怎么办确认客户端填写的地址是http://服务器IP:9000接口路径为/api/user/sync若走了 Nginx 反代需启用代理头转发与 WebSocket 升级。Q3如何升级版本一键脚本用户直接fns updateDocker 用户docker compose pull docker compose up -d二进制用户下载新包替换后重启即可数据保存在storage目录中不受影响。至此Fast Note Sync Service 的 3 种部署方式就讲完了一键脚本适合绝大多数个人用户Docker 适合容器环境二进制则留给离线与定制场景。选一种跑起来把 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），仅供参考