笔记老丢、版本错乱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 步准备你的图书馆服务器二选一各取所需。方案 ACouchDB推荐新手。它就像那家图书馆专门为文档同步而生。项目在docker/目录下直接提供了现成的编排文件最省事的跑法docker run -d --restart always \ -e COUCHDB_USERadmin \ -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圆圈箭头 表示网络请求中稍等即可警告 ⚠ 出现时第一时间打开日志看第一条报错而不是只看最后的总结。七、现在迈出你的第一步回顾一下我们解决了什么笔记跨设备实时同步、数据完全自控、免费可用、冲突可控、隐私可加密——这就是 Obsidian LiveSync 的全部价值。它不是一个需要你天天伺候的工具而是那种装好就忘了存在的隐形助手你在书房合上电脑转身在办公室打开平板一切早就在那里等你了。下一步别想太多照着第三节的前两步做clone 仓库、装好插件、跑起一个 CouchDB 容器。半小时后你会拥有一座只属于自己的笔记图书馆——所有设备都是它的读者而你是唯一持钥匙的管理员。✨【免费下载链接】obsidian-livesync项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
笔记老丢、版本错乱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 步准备你的图书馆服务器二选一各取所需。方案 ACouchDB推荐新手。它就像那家图书馆专门为文档同步而生。项目在docker/目录下直接提供了现成的编排文件最省事的跑法docker run -d --restart always \ -e COUCHDB_USERadmin \ -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圆圈箭头 表示网络请求中稍等即可警告 ⚠ 出现时第一时间打开日志看第一条报错而不是只看最后的总结。七、现在迈出你的第一步回顾一下我们解决了什么笔记跨设备实时同步、数据完全自控、免费可用、冲突可控、隐私可加密——这就是 Obsidian LiveSync 的全部价值。它不是一个需要你天天伺候的工具而是那种装好就忘了存在的隐形助手你在书房合上电脑转身在办公室打开平板一切早就在那里等你了。下一步别想太多照着第三节的前两步做clone 仓库、装好插件、跑起一个 CouchDB 容器。半小时后你会拥有一座只属于自己的笔记图书馆——所有设备都是它的读者而你是唯一持钥匙的管理员。✨【免费下载链接】obsidian-livesync项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
