Obsidian LiveSync 使用教程三步搭好自托管同步笔记从此只属于你自己【免费下载链接】obsidian-livesync项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync先问一个扎心的问题你手机里的笔记和电脑里的笔记是同一份吗如果你在地铁上灵光一现掏出手机想记一笔却发现那条备注还躺在昨晚的电脑里如果你在公司改完文档回家打开电脑看到的还是早上出门前的旧版本——那你大概率正被笔记碎片化折磨。而 Obsidian LiveSync社区版叫 Self-hosted LiveSync就是那个帮你把散落各处的笔记重新拼成一块的插件。它是 Obsidian 生态里的开源同步方案走的是自托管路线用 CouchDB、S3 兼容对象存储甚至设备直连P2P把笔记库同步到你的每一台设备上数据始终由你自己掌控。最妙的是它支持端到端加密就算服务器真的被攻破了对方看到的也只是一堆没钥匙打不开的乱码。先别急着装往下看你大概需要十分钟。它到底在干嘛一个包裹的旅程如果你没接触过同步这件事我用一个场景给你讲明白。假设你的笔记是一个个上了锁的信封你的 Obsidian 库你家的书桌。你在上面写字、改字一切都在本地。服务器一家私人邮局。它只负责转运不负责看内容。端到端加密信封上的那把锁。只有你手里的钥匙Vault 加密口令能打开邮局工作人员也打不开。另一台设备你家的另一个书桌。它拿着同一把钥匙随时拆信查看。所以流程是这样的你在笔记本上敲下一个字 → 插件把这个改动装进加密信封 → 丢进邮局CouchDB 或对象存储→ 手机端收到有包裹的通知 → 掏出钥匙拆开、合入自己的笔记。全程信封密封服务器只经手、不窥探。更妙的是这个项目还提供一条不需要邮局的路线——P2P 直连。两台设备之间直接建立加密通道交换笔记中间那个信号中继只负责让两台设备互相找到对方连你的一根头发都不经手。我们后面细说。为什么值得折腾一张对比表说话很多人觉得同步嘛官方服务不是现成的——是但问题在于数据住在哪、钥匙在谁手里。对比项Self-hosted LiveSync官方 Obsidian Sync手动拷贝文件数据住哪你自己的服务器/存储桶厂商服务器你的 U 盘/网盘钥匙在谁手里你端到端加密可选厂商你钱包感受免费或极低成本按月订阅免费上手难度中等一次配好一劳永逸低低同步效率实时改动即同步实时全手动纯靠自觉能同步什么笔记设置插件主题进阶功能笔记为主全部但会复制出 N 份一句话总结官方服务卖的是省心自托管卖的是主权。而 LiveSync 把自托管这件事的门槛压到了普通人也能迈过去的程度——不需要你懂数据库原理只需要按向导点几个按钮。谁真的在用三个普通人的一天不用想象这就是真实使用者们的日常。张博士在实验室、平板、手机三端写研究笔记。他的方案很简单在实验室那台服务器上跑了一个 CouchDB所有设备装上 LiveSync开启端到端加密。实验数据录入电脑的瞬间平板和手机上已经能看到文献批注随手记回家坐地铁也能翻。他的原话是同步这件事终于从我的待办清单里消失了。小李是那种连快递单号都不愿意多透露的人。她在家里那台 NAS 上部署了 CouchDB打开端到端加密 路径混淆连文件名都加密。对她来说哪怕哪天 NAS 被人搬走了里面的数据也只是一堆看不出含义的乱码——密码只要不写在设备上就没人能读。小王的创业团队更极端五个人共享产品文档和会议记录后端直接用现有的云对象存储比如 OSS、S3。每人一台设备各自的密钥独立文档改完一分钟内全员可见。他说以前靠群里发文件现在再也没人问最新版在谁那了。这三个场景对应三种后端恰好引出了下面这个问题。选择困难症三种同步后端怎么选LiveSync 支持三种后端你可以理解成三个不同性格的仓库。先选仓库再进向导整个过程不到半小时。选 CouchDB——新手和想一劳永逸的人CouchDB 是文档型数据库天生适合同步场景也是这个插件最成熟的搭档。部署方式很灵活自己有服务器就手动装想省事可以一键部署到 Fly.io嫌贵还可以用 IBM Cloudant 的免费额度甚至树莓派都能跑起来。适合人群绝大多数第一次用自托管同步的人。选对象存储——手里已有云服务账号的人如果你已经有 AWS S3、阿里云 OSS、腾讯云 COS或者 Cloudflare R2 这类账号那可以直接把它当成仓库连数据库都不用装。填一个访问密钥和存储桶完事。适合人群已有云服务、不想再添一台服务器的人。选 P2P——不想养服务器的人P2P 模式不需要任何中心数据库两台设备通过 WebRTC 直接交换加密数据只要有一个公共信号中继帮忙互相找到对方即可项目方就维护了一个公共中继。适合人群设备都在身边、对隐私要求极高、或者一分钱都不想花的人。代价是同步时至少得有一台设备在线像对讲机——得有人开着另一头才喊得通。亲手搭一遍从零到两台设备同步这一节是全程干货跟着做就行。以最推荐的 CouchDB 路线为例。第 0 步动手前花五分钟做三件事备份所有要参与的笔记库安全第一这不是客套话关闭 Obsidian Sync、iCloud 同步等任何会往同一个库写数据的服务——两个同步工具同时开等于两辆车抢一条车道想好加密口令和 Setup URI 口令并把它们分开存放。第 1 步把邮局开起来如果你有一台能联网的电脑或服务器跑一条命令就能部署 CouchDBdocker run --name couchdb-for-obsidian -d \ -e COUCHDB_USERadmin \ -e COUCHDB_PASSWORDyour_secure_password \ -p 5984:5984 \ couchdb:latest大白话翻译这条命令相当于领一个开箱即用的文件柜回家。-d表示放在后台运行两个-e是给柜子设置管理员账号和密码-p 5984:5984表示柜子开在 5984 号窗口等你取件。跑完你的 CouchDB 就上线了。记得给服务器配上 HTTPS尤其手机端要求必须走可信的加密连接。第 2 步拿一把万能钥匙服务器就绪后项目会帮你生成一把加密的 Setup URI长这样obsidian://setuplivesync?settings...。它是一串包含连接信息和凭据的加密字符串可以安全地在设备间传递。记住钥匙和开锁口令要分开存比如 URI 放密码管理器口令记在另一个地方。这就像银行卡和密码不能放同一个口袋。第 3 步配置第一台设备打开 Obsidian → 社区插件 → 搜索安装 Self-hosted LiveSync → 点击欢迎通知进入向导 → 选择第一次设置→ 粘贴 Setup URI → 输入口令 → 测试连接。连上之后会要求重启并初始化服务器还会弹出一个覆盖确认——只有在你有备份、且确定要让这台设备成为数据源头时才点确认。第 4 步第二台设备入场第一台设备同步正常后在命令面板里运行Self-hosted LiveSync: Copy settings as a new Setup URI生成一把专属于第二台设备的新钥匙别直接用第 2 步那把官方明确建议从工作正常的设备上重新生成。然后在新设备上粘贴、输入口令、选择重启并拉取数据一会儿功夫整个笔记库就搬过来了。第 5 步验证同步真的通了两台设备都开着在任意一端新建一条测试笔记然后看看另一端是否出现。双向都通了恭喜你的私人同步网络正式营业。你会栽的跟头我已替你踩过FAQ 快问快答Q状态栏一直转圈进度条不动了A大概率是网络不稳定、服务器配置有误或者两台设备同时改了同一个文件。先ping一下你的服务器地址确认网络再看插件日志命令面板搜 Show log第一条报错信息比最后的总结更有用。Q报 CORS 错误什么意思A想象你去朋友家朋友说可以进来但小区保安死活不放行。CORS 就是那个保安。解法有三个在插件设置里打开Use Request API to avoid CORS problem相当于给保安出示通行证或者去服务器上把 CORS 配好最省事的是用一键部署方案它会自动把 CORS 配好。Q加密密码忘了怎么办A……嗯如果没做过未加密备份那真的只能下次一定。所以请把加密口令存进密码管理器并定期导出一份不加密的备份当作逃生通道。Q两台设备同时改了同一个文件会打架吗A会但插件处理得很文明简单的冲突比如各改各的段落会自动合并复杂的冲突会弹窗让你选保留哪个版本而不是默默覆盖。就像两个人同时改购物清单一个加了牛奶、一个删了牛奶——最后总得有人拍板。QObsidian 打不开/启动失败了A先别慌别急着重置服务器。在笔记库根目录手动新建一个redflag.md文件再启动这是官方支持的安全阀能让你在插件正式启动前介入。详细的恢复流程见 docs/recovery.md。Q换了个服务器之前的配置全作废了A不用。只要笔记库还在用新服务器的 Setup URI 重新走一遍向导即可本地数据不会丢。三个藏起来的进阶玩法现在就能解锁玩法一连设置一起同步LiveSync 不仅能同步笔记还能同步你的 Obsidian 配置、代码片段、主题甚至插件。新设备装好 Obsidian 后粘贴一把钥匙几秒钟恢复成你熟悉的模样像手机换机一键迁移。开启路径先把普通笔记同步跑通再打开隐藏文件同步Hidden File Sync或配置同步Customisation Sync。玩法二彻底摆脱服务器——P2P 直连在P2P 同步里填入组 ID 和口令两台设备通过信号中继互相发现、直接建立加密通道交换数据。注意同步时至少有一台设备在线而且参与设备要使用同一组中继、组 ID 和口令。适合局域网内临时共享、或者对零服务器有执念的朋友。玩法三只同步你想同步的不是所有文件都需要塞进同步网络。你可以用选择器指定只同步某些文件夹、排除临时文件、限制文件大小甚至设置不同的同步频率实时/定时/手动。你的笔记库规则由你定。进阶彩蛋第二台设备做初始复制时如果觉得全量拉取太慢官方有一份 Fast Setup 指南教你用更聪明的姿势起步详见 docs/tips/fast-setup.md。想深挖这些文档按需取用官方中文总览README_cn.mdCouchDB 快速上手docs/quick_setup.md自建 CouchDB 服务器docs/setup_own_server.md对象存储配置docs/setup_object_storage.mdP2P 同步设置docs/setup_p2p.md疑难排障总入口docs/troubleshooting.md想从源码折腾克隆https://gitcode.com/gh_mirrors/ob/obsidian-livesync执行npm install和npm run build即可自己构建插件。最后说一句Obsidian LiveSync 给你的核心利益只有一条你的笔记从头到尾都只属于你自己。数据住自己的房子、钥匙攥在自己手里、同步规则自己定还全程实时——这大概就是数据自主最舒服的姿势了。现在就去动手吧备份 → 开一个 CouchDB → 安装插件 → 生成 Setup URI → 第二台设备扫码入场。四十分钟后你会在另一台设备上看到那篇刚刚写下的笔记然后发现——原来同步这种事也可以这么安静。【免费下载链接】obsidian-livesync项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Obsidian LiveSync 使用教程：三步搭好自托管同步，笔记从此只属于你自己
Obsidian LiveSync 使用教程三步搭好自托管同步笔记从此只属于你自己【免费下载链接】obsidian-livesync项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync先问一个扎心的问题你手机里的笔记和电脑里的笔记是同一份吗如果你在地铁上灵光一现掏出手机想记一笔却发现那条备注还躺在昨晚的电脑里如果你在公司改完文档回家打开电脑看到的还是早上出门前的旧版本——那你大概率正被笔记碎片化折磨。而 Obsidian LiveSync社区版叫 Self-hosted LiveSync就是那个帮你把散落各处的笔记重新拼成一块的插件。它是 Obsidian 生态里的开源同步方案走的是自托管路线用 CouchDB、S3 兼容对象存储甚至设备直连P2P把笔记库同步到你的每一台设备上数据始终由你自己掌控。最妙的是它支持端到端加密就算服务器真的被攻破了对方看到的也只是一堆没钥匙打不开的乱码。先别急着装往下看你大概需要十分钟。它到底在干嘛一个包裹的旅程如果你没接触过同步这件事我用一个场景给你讲明白。假设你的笔记是一个个上了锁的信封你的 Obsidian 库你家的书桌。你在上面写字、改字一切都在本地。服务器一家私人邮局。它只负责转运不负责看内容。端到端加密信封上的那把锁。只有你手里的钥匙Vault 加密口令能打开邮局工作人员也打不开。另一台设备你家的另一个书桌。它拿着同一把钥匙随时拆信查看。所以流程是这样的你在笔记本上敲下一个字 → 插件把这个改动装进加密信封 → 丢进邮局CouchDB 或对象存储→ 手机端收到有包裹的通知 → 掏出钥匙拆开、合入自己的笔记。全程信封密封服务器只经手、不窥探。更妙的是这个项目还提供一条不需要邮局的路线——P2P 直连。两台设备之间直接建立加密通道交换笔记中间那个信号中继只负责让两台设备互相找到对方连你的一根头发都不经手。我们后面细说。为什么值得折腾一张对比表说话很多人觉得同步嘛官方服务不是现成的——是但问题在于数据住在哪、钥匙在谁手里。对比项Self-hosted LiveSync官方 Obsidian Sync手动拷贝文件数据住哪你自己的服务器/存储桶厂商服务器你的 U 盘/网盘钥匙在谁手里你端到端加密可选厂商你钱包感受免费或极低成本按月订阅免费上手难度中等一次配好一劳永逸低低同步效率实时改动即同步实时全手动纯靠自觉能同步什么笔记设置插件主题进阶功能笔记为主全部但会复制出 N 份一句话总结官方服务卖的是省心自托管卖的是主权。而 LiveSync 把自托管这件事的门槛压到了普通人也能迈过去的程度——不需要你懂数据库原理只需要按向导点几个按钮。谁真的在用三个普通人的一天不用想象这就是真实使用者们的日常。张博士在实验室、平板、手机三端写研究笔记。他的方案很简单在实验室那台服务器上跑了一个 CouchDB所有设备装上 LiveSync开启端到端加密。实验数据录入电脑的瞬间平板和手机上已经能看到文献批注随手记回家坐地铁也能翻。他的原话是同步这件事终于从我的待办清单里消失了。小李是那种连快递单号都不愿意多透露的人。她在家里那台 NAS 上部署了 CouchDB打开端到端加密 路径混淆连文件名都加密。对她来说哪怕哪天 NAS 被人搬走了里面的数据也只是一堆看不出含义的乱码——密码只要不写在设备上就没人能读。小王的创业团队更极端五个人共享产品文档和会议记录后端直接用现有的云对象存储比如 OSS、S3。每人一台设备各自的密钥独立文档改完一分钟内全员可见。他说以前靠群里发文件现在再也没人问最新版在谁那了。这三个场景对应三种后端恰好引出了下面这个问题。选择困难症三种同步后端怎么选LiveSync 支持三种后端你可以理解成三个不同性格的仓库。先选仓库再进向导整个过程不到半小时。选 CouchDB——新手和想一劳永逸的人CouchDB 是文档型数据库天生适合同步场景也是这个插件最成熟的搭档。部署方式很灵活自己有服务器就手动装想省事可以一键部署到 Fly.io嫌贵还可以用 IBM Cloudant 的免费额度甚至树莓派都能跑起来。适合人群绝大多数第一次用自托管同步的人。选对象存储——手里已有云服务账号的人如果你已经有 AWS S3、阿里云 OSS、腾讯云 COS或者 Cloudflare R2 这类账号那可以直接把它当成仓库连数据库都不用装。填一个访问密钥和存储桶完事。适合人群已有云服务、不想再添一台服务器的人。选 P2P——不想养服务器的人P2P 模式不需要任何中心数据库两台设备通过 WebRTC 直接交换加密数据只要有一个公共信号中继帮忙互相找到对方即可项目方就维护了一个公共中继。适合人群设备都在身边、对隐私要求极高、或者一分钱都不想花的人。代价是同步时至少得有一台设备在线像对讲机——得有人开着另一头才喊得通。亲手搭一遍从零到两台设备同步这一节是全程干货跟着做就行。以最推荐的 CouchDB 路线为例。第 0 步动手前花五分钟做三件事备份所有要参与的笔记库安全第一这不是客套话关闭 Obsidian Sync、iCloud 同步等任何会往同一个库写数据的服务——两个同步工具同时开等于两辆车抢一条车道想好加密口令和 Setup URI 口令并把它们分开存放。第 1 步把邮局开起来如果你有一台能联网的电脑或服务器跑一条命令就能部署 CouchDBdocker run --name couchdb-for-obsidian -d \ -e COUCHDB_USERadmin \ -e COUCHDB_PASSWORDyour_secure_password \ -p 5984:5984 \ couchdb:latest大白话翻译这条命令相当于领一个开箱即用的文件柜回家。-d表示放在后台运行两个-e是给柜子设置管理员账号和密码-p 5984:5984表示柜子开在 5984 号窗口等你取件。跑完你的 CouchDB 就上线了。记得给服务器配上 HTTPS尤其手机端要求必须走可信的加密连接。第 2 步拿一把万能钥匙服务器就绪后项目会帮你生成一把加密的 Setup URI长这样obsidian://setuplivesync?settings...。它是一串包含连接信息和凭据的加密字符串可以安全地在设备间传递。记住钥匙和开锁口令要分开存比如 URI 放密码管理器口令记在另一个地方。这就像银行卡和密码不能放同一个口袋。第 3 步配置第一台设备打开 Obsidian → 社区插件 → 搜索安装 Self-hosted LiveSync → 点击欢迎通知进入向导 → 选择第一次设置→ 粘贴 Setup URI → 输入口令 → 测试连接。连上之后会要求重启并初始化服务器还会弹出一个覆盖确认——只有在你有备份、且确定要让这台设备成为数据源头时才点确认。第 4 步第二台设备入场第一台设备同步正常后在命令面板里运行Self-hosted LiveSync: Copy settings as a new Setup URI生成一把专属于第二台设备的新钥匙别直接用第 2 步那把官方明确建议从工作正常的设备上重新生成。然后在新设备上粘贴、输入口令、选择重启并拉取数据一会儿功夫整个笔记库就搬过来了。第 5 步验证同步真的通了两台设备都开着在任意一端新建一条测试笔记然后看看另一端是否出现。双向都通了恭喜你的私人同步网络正式营业。你会栽的跟头我已替你踩过FAQ 快问快答Q状态栏一直转圈进度条不动了A大概率是网络不稳定、服务器配置有误或者两台设备同时改了同一个文件。先ping一下你的服务器地址确认网络再看插件日志命令面板搜 Show log第一条报错信息比最后的总结更有用。Q报 CORS 错误什么意思A想象你去朋友家朋友说可以进来但小区保安死活不放行。CORS 就是那个保安。解法有三个在插件设置里打开Use Request API to avoid CORS problem相当于给保安出示通行证或者去服务器上把 CORS 配好最省事的是用一键部署方案它会自动把 CORS 配好。Q加密密码忘了怎么办A……嗯如果没做过未加密备份那真的只能下次一定。所以请把加密口令存进密码管理器并定期导出一份不加密的备份当作逃生通道。Q两台设备同时改了同一个文件会打架吗A会但插件处理得很文明简单的冲突比如各改各的段落会自动合并复杂的冲突会弹窗让你选保留哪个版本而不是默默覆盖。就像两个人同时改购物清单一个加了牛奶、一个删了牛奶——最后总得有人拍板。QObsidian 打不开/启动失败了A先别慌别急着重置服务器。在笔记库根目录手动新建一个redflag.md文件再启动这是官方支持的安全阀能让你在插件正式启动前介入。详细的恢复流程见 docs/recovery.md。Q换了个服务器之前的配置全作废了A不用。只要笔记库还在用新服务器的 Setup URI 重新走一遍向导即可本地数据不会丢。三个藏起来的进阶玩法现在就能解锁玩法一连设置一起同步LiveSync 不仅能同步笔记还能同步你的 Obsidian 配置、代码片段、主题甚至插件。新设备装好 Obsidian 后粘贴一把钥匙几秒钟恢复成你熟悉的模样像手机换机一键迁移。开启路径先把普通笔记同步跑通再打开隐藏文件同步Hidden File Sync或配置同步Customisation Sync。玩法二彻底摆脱服务器——P2P 直连在P2P 同步里填入组 ID 和口令两台设备通过信号中继互相发现、直接建立加密通道交换数据。注意同步时至少有一台设备在线而且参与设备要使用同一组中继、组 ID 和口令。适合局域网内临时共享、或者对零服务器有执念的朋友。玩法三只同步你想同步的不是所有文件都需要塞进同步网络。你可以用选择器指定只同步某些文件夹、排除临时文件、限制文件大小甚至设置不同的同步频率实时/定时/手动。你的笔记库规则由你定。进阶彩蛋第二台设备做初始复制时如果觉得全量拉取太慢官方有一份 Fast Setup 指南教你用更聪明的姿势起步详见 docs/tips/fast-setup.md。想深挖这些文档按需取用官方中文总览README_cn.mdCouchDB 快速上手docs/quick_setup.md自建 CouchDB 服务器docs/setup_own_server.md对象存储配置docs/setup_object_storage.mdP2P 同步设置docs/setup_p2p.md疑难排障总入口docs/troubleshooting.md想从源码折腾克隆https://gitcode.com/gh_mirrors/ob/obsidian-livesync执行npm install和npm run build即可自己构建插件。最后说一句Obsidian LiveSync 给你的核心利益只有一条你的笔记从头到尾都只属于你自己。数据住自己的房子、钥匙攥在自己手里、同步规则自己定还全程实时——这大概就是数据自主最舒服的姿势了。现在就去动手吧备份 → 开一个 CouchDB → 安装插件 → 生成 Setup URI → 第二台设备扫码入场。四十分钟后你会在另一台设备上看到那篇刚刚写下的笔记然后发现——原来同步这种事也可以这么安静。【免费下载链接】obsidian-livesync项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考