笔记老丢、版本错乱？Obsidian LiveSync 自托管同步，半小时让所有设备归于一致-平芜编程栈

笔记老丢、版本错乱？Obsidian LiveSync 自托管同步，半小时让所有设备归于一致

【免费下载链接】obsidian-livesync项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync

你有没有这样的时刻：深夜在书房改完一份方案，第二天在地铁上打开平板，发现改的版本根本没同步过来；或者更糟，两台电脑各存了一份笔记，内容越改越分叉，最后你根本分不清哪份才是"最新"。

如果你正在用 Obsidian 记笔记，这个场景一定不陌生。Obsidian LiveSync就是为这类"跨设备笔记同步"而生的开源插件——它允许你把笔记数据同步到你自己的服务器（CouchDB）或对象存储上，设备之间实时保持一致，数据永远握在自己手里，不经过任何第三方。

这篇指南会从"它到底是什么"讲到"半小时跑通全部流程"，新手照做即可，老手也能挖到几个进阶彩蛋。

一、先问自己三个问题，再决定要不要装它

在动手之前，我们先花两分钟把账算清楚。

问题一：你现在是怎么同步的？

靠 U 盘拷？那是上个世纪的方法，容易忘、容易错。
靠网盘文件夹？Obsidian 的库文件结构特殊，网盘偶尔会"锁文件"、产生隐藏冲突副本。
靠 Obsidian 官方 Sync？很好用，但按月付费，且数据放在别人家服务器上。

问题二：你怕不怕数据被别人看？日记、灵感、客户信息、研究笔记……这些往往是很私密的东西。第三方云服务理论上"不会"看你的数据，但"理论上"三个字本身就让人不踏实。

问题三：你愿意花多少时间换一劳永逸？如果你愿意拿出半小时，部署一次、配置一次，之后所有设备就自动保持一致——这个投入产出比非常划算。

把同步这件事想成图书馆借书就很好理解了：你的每一条笔记是一本书，你的每台设备是一位读者，服务器是那家社区图书馆。你在书房写完，等于"把书还回图书馆"；到办公室打开平板，系统自动"把书借到新书架"。所有读者看到的永远是最新上架的那一版。

二、为什么是它：把三个候选方案摆上桌比一比

市面上能给 Obsidian 做同步的选项不少，我们挑最有代表性的三个，放在同一张桌子上比：

对比维度	Obsidian LiveSync（自托管）	Obsidian 官方 Sync	手动/网盘同步
数据所有权	完全自控	厂商托管	完全自控
费用	免费（自付服务器成本，极低）	按月订阅	网盘容量费
实时性	秒级实时	秒级实时	手动或延迟
端到端加密	可选，AES-GCM 256 位	有	通常无
多端支持	电脑/手机/平板全平台	全平台	依赖网盘客户端
冲突处理	自动合并+手动调解工具	有	靠运气

注意上面"冲突处理"这一行——这是很多人忽略的重点。多人或多设备同时改同一份笔记时，LiveSync 会先尝试自动合并不同段落的修改；遇到真正没法自动解决的，会弹出一个调解界面，把"保留哪一版"的决定权交还给你，而不是默默覆盖。这一点在后面避坑篇还会展开。

结论很直白：想要免费、想要数据绝对私密、又想要实时同步，LiveSync 是当前生态里最成熟的答案。官方文档所在的docs/目录里有完整的对比说明（如docs/settings.md），细节可以慢慢翻阅。

三、半小时上手：从零到两台设备实时同步

整个流程只需要三步：装插件 → 准备服务器 → 用 Setup URI 连第二台设备。

第 1 步：获取并安装插件

把源码拿到本地：

git clone https://gitcode.com/gh_mirrors/ob/obsidian-livesync.git cd obsidian-livesync npm install npm run build

然后打开 Obsidian：设置 → 社区插件 → 从文件夹安装，选中刚才的目录即可启用。装好后，首次打开会自动进入设置向导（Setup Wizard）——这是新手最友好的入口，绝大多数选项都已经帮你排好顺序了。

第 2 步：准备你的"图书馆"（服务器）

二选一，各取所需。

方案 A：CouchDB（推荐新手）。它就像那家"图书馆"，专门为文档同步而生。项目在docker/目录下直接提供了现成的编排文件，最省事的跑法：

docker run -d --restart always \ -e COUCHDB_USER=admin \ -e COUCHDB_PASSWORD=你的强密码 \ -p 5984:5984 \ couchdb:latest

跑起来之后访问http://localhost:5984/_utils建一个数据库，比如叫obsidian-notes。数据库名、账号、密码，这就是之后插件要用的全部"钥匙"。

方案 B：对象存储（适合已有云资源）。如果你手上本来就有 S3 兼容的服务（各家云厂商基本都支持），直接填上 endpoint、Access Key、Bucket 名称和区域即可，见下图——填法跟设置一个网盘挂载差不多。

第 3 步：填写连接信息并测试

在设置向导里选择远程类型，填入刚才的信息，点Test Settings and Continue。如果连接失败，先点旁边的Check database configuration让插件自动检查并修复 CouchDB 的配置项（例如 CORS 和权限开关）。修复按钮全部消失、变成对勾，就说明服务器端已就绪。

这里有一个强烈建议：开启端到端加密 + 路径混淆。加密基于 256 位 AES-GCM，数据在离开设备那一刻就被上锁；路径混淆连文件名都一并加密。这样一来，哪怕服务器被拖库，别人看到的也只是一堆乱码——图书馆里的书虽然放在公共书架上，但每一本都套着只有你能打开的密码锁。

第 4 步：用 Setup URI 连接第二台设备

这是全流程里最有仪式感的一步。在已经配置好的第一台设备上，命令面板运行Self-hosted LiveSync: Copy settings as a new Setup URI，输入一个密码短语，会得到一串以obsidian://setuplivesync?settings=开头的加密字符串。

这串 URI 相当于图书馆的"会员卡 + 密码"——里面打包了服务器地址、账号、加密设置等全部信息，但它是加密的，路上被截获也没关系，因为你还握有解密它的密码短语。

在第二台设备上安装插件，运行Open setup URI，粘贴这段字符串、输入密码短语，选择"作为第二台设备加入"，然后等着——你第一台设备上的笔记就会像退潮后的贝壳一样，一批批出现在新设备里。

验证方法很简单：在第一台设备新建一条测试笔记，等状态栏的上传指示消失；再到第二台设备确认它出现了，然后反方向再发一条。双向都通，说明你的"私人图书馆"正式开张了。

四、进阶彩蛋：把同步调教成你想要的样子

基础同步跑通之后，接下来这几招能让你从"能用"升级到"好用"。

玩法一：只同步该同步的

不是所有文件都值得进图书馆。在同步设置里，你可以：

只同步指定文件夹；
排除临时文件、缓存目录；
跳过超过指定大小的大文件（比如视频）；
按需调整同步频率：实时、每小时、每天，或者干脆手动。

想象一下：书房里的每一本书都值得搬到图书馆吗？显然不是——杂志和废稿留在本地就好。

玩法二：隐藏文件同步

如果你用 Obsidian 的一些插件，会发现.obsidian、.trash这类隐藏文件里也藏着关键配置。LiveSync 提供独立的**隐藏文件同步（Hidden File Sync）**功能，可以单独开启并选择要覆盖的隐藏文件范围。

值得注意：隐藏文件同步与普通笔记同步是两个独立开关，很多人踩过"笔记同步了但插件配置没同步"的坑，源头就在这儿。

玩法三：P2P 直连同步

如果你的两台设备经常处于同一网络、或者你想绕开"中央服务器"这个概念，LiveSync 还提供 WebRTC P2P 同步。它不依赖中心数据库，设备之间直接加密传输，只需一个轻量的信令中继负责"互相发现"。你可以在 P2P 状态面板里实时看到连接状态和在线设备。

注意：P2P 更像是"邻里直接互相借书"，而 CouchDB 是"社区图书馆"。二者可以并行——主力用服务器，临时场景用 P2P，互不冲突。

玩法四：让新设备一键恢复"全部配置"

LiveSync 不仅能同步笔记，还能通过自定义同步把 Obsidian 设置、主题、插件配置一并带到新设备。换新电脑时，装好插件、粘贴 Setup URI，熟悉的界面和配置就全部回来了。

五、避坑指南：四个高频问题的幽默解法

再顺的路也有几个弯，提前知道能省不少时间。

坑一：连接测试总是失败。优先怀疑三件事：URL 是否完整、账号密码是否写对、CouchDB 的 CORS 是否配置。前两个自查即可，第三个让插件的自动检查帮你修。如果实在不行，把docker-compose.yml里的端口映射（默认5984:5984）和防火墙放行检查一遍。

坑二：CORS 报错刷屏。这就像你想进图书馆，门卫说"可以"，但安保系统说"不行"。要么在插件设置里勾选使用 Request API 绕过浏览器限制，要么老老实实把服务器端的 CORS 配置补上——项目文档docs/setup_own_server_cn.md里有一份现成的local.ini片段，复制即用。

坑三：加密密码忘了。这是最"社死"的坑：数据确实安全，安全到连你自己都进不去。预防方案永远是：把加密密码和 Setup URI 的密码短语分开存放，都放进密码管理器，别记在笔记里（否则就成鸡生蛋问题了）。

坑四：同一份文件在两边都被改了。简单冲突会自动合并，复杂冲突会弹出调解框。此时先别急着手动删改文件，用命令面板里的冲突检查工具，看每个版本的分支情况，再决定保留哪一版。记住一句话：冲突不可怕，可怕的是在没看清分支时就点覆盖。

六、出发前检查清单

把下面这张表从头到尾过一遍，基本就不会翻车：

阶段	检查项
部署前	所有设备 Obsidian 版本一致；服务器端口（5984）可访问；原有笔记已备份
配置时	测试连接通过；数据库配置修复完成；已开启端到端加密；Setup URI 已存到密码管理器
使用中	每周瞄一眼状态栏是否异常；每月验证一次数据库健康；及时升级插件版本

另外记住状态栏那排小图标的含义：闪电 ⚡ 表示正在同步，别在这时候关闭 Obsidian；圆圈箭头 📲 表示网络请求中，稍等即可；警告 ⚠ 出现时第一时间打开日志看第一条报错，而不是只看最后的总结。