服务端部署
思路很简单:服务器 + 域名,服务端装同步服务,Obsidian 里装插件填服务端信息。作者博客里有一份简单教程,照抄就行。
- 在服务器创建文件夹,进入后新建
docker-compose.yml,把官方的 compose 脚本粘贴进去,端口默认 9000; - 国内服务器注意:把镜像地址换成国内镜像源,否则拉镜像会报错;
- 启动:
docker compose up -d- 浏览器访问,首次注册(用户名随意,邮箱可用真实的也可虚拟的)→ 进入后管理员初始化,把当前用户设为管理员 → 右上角可切换到简体中文;
- 到「设置 → 安全与令牌」,把开放注册关闭;
- 创建要同步的笔记仓库,点「授权」生成授权命令。
Obsidian 端配置
- Obsidian 设置 → 第三方插件 → 浏览,搜索 Fast Note Sync,安装并启用;
- 插件设置里,更新源改成腾讯(国内网络更新更快);
- 把服务端生成的授权信息粘贴到远端配置;
- 「同步控制」里把配置项同步打开;
- 刚配好可能显示服务已断开,退出再重新进入,同步日志里就能看到配置和笔记都同步上来了。
亮点功能实测
- 服务端 Web 管理:笔记管理(刷新/编辑/预览)、附件管理(查看/删除)、分享笔记(可设密码)、回收站;
- 更新日志:什么时间新建/修改/删除了什么,一清二楚,再也不用担心笔记丢失;
- 历史版本:每个笔记都能看历史版本、只看差异、一键恢复到某版本
- 配置文件直接改:仓库的配置(配色、快捷键、核心插件数据)都可以在 Web 端调整;
- 备份任务:设定定时全量备份,存储可以选阿里云/腾讯云对象存储、Cloudflare R2、坚果云、WebDAV,也可以同步到 GitHub 仓库。
进阶:AI 联动
把仓库作为 MCP 对接 Cherry Studio、Cursor 这类 AI 客户端,AI 就能直接读你的仓库文件。更进一步,如果服务器支持,可以在上面跑一个常驻的 AI Agent 服务,把笔记仓库的 API 直接开放给它——这样即使电脑不开机,AI 也能帮你读写笔记:告诉你当天的任务安排、最近写了什么,你有想法它还能直接写进笔记。下次打开 Obsidian,自动从同步仓库拉取新内容。
参考文献