Obsidian LiveSync插件自托管同步完整指南5分钟搞定多设备笔记同步【免费下载链接】obsidian-livesync项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync一句话定位Obsidian LiveSync插件 是一款开源免费的自托管同步插件让你像用官方云同步一样省心但笔记仓库由你自己保管数据从头到尾握在自己手里。周五晚上十点你瘫在沙发上刷手机。白天在办公室电脑上随手写的那条下周实验要带的试剂清单此刻安安静静躺在手机里。你根本没手动传过——它自己就来了。不止清单还有昨天记的读书摘抄、上个月整理的客户话术全都在两台设备上整整齐齐保持一致。这就是 Obsidian LiveSync插件 的日常。它给你的笔记库配了一个只属于你自己的总仓库所有设备自动往这个仓库存取笔记。CouchDB、S3对象存储、甚至一台旧电脑都能当仓库数据不经过任何第三方公司同步却快得像变魔术。没有它的一天 vs 有它的一天先把时间拨回还没装这个插件的时候。没有它的那天早上在办公室电脑改完方案下午回家想继续发现文件还留在公司。你打开网盘手动传一遍晚上在笔记本上改完又得传回去。今天传明天忘版本开始打架——桌面上陆续长出方案_最终版方案_最终版2方案_真最终版。手机就更别想了出门想看个笔记只能祈祷自己记得带U盘。有它的那天在哪台设备上改完其他设备过几秒就跟着更新。手机、平板、公司电脑、家里的旧笔记本全都是同一版笔记。你根本不会再去想同步这件事因为它安静得像不存在。两个版本的核心差别不是快了一点而是彻底不用管了。这正是 Obsidian LiveSync插件 存在的意义把同步这种琐事从你的脑子里删掉。它到底怎么做到的三个比喻讲透没接触过同步原理也不用怕。我们干脆把整套系统想象成一家带分店的咖啡店。第一件事为什么需要一间总仓库你手上有好几家分店电脑、手机、平板每家的柜台就是本地笔记库。问题是分店之间没法直接串货——手机不可能24小时在线等着收货。所以你需要一间随时开门的总仓库也就是 CouchDB 服务器或 S3 兼容的对象存储。分店A的店员把新货送进仓库分店B的店员再来取走。谁不在线都没关系货先寄存在仓库里等它开门自取。全流程用文字画出来是这样你在电脑上写下笔记 │ ① 加密封箱可选但强烈推荐 ▼ 总仓库CouchDB / 对象存储 │ ② 手机来取货并拆箱 ▼ 手机上出现同样的笔记第二件事加密 封箱上锁钥匙只有你有笔记离开设备的那一刻可以顺便被封进一个只有你能打开的箱子——这叫端到端加密相当于把信装进只有你和收信人拿得到钥匙的保险箱。仓库管理员服务器看到的只是一堆看不出内容的箱子就算服务器被入侵也读不出半个字。更讲究一点还能开路径混淆连箱子外面的标签都变成乱码文件名也一起保密。第三件事Setup URI 开店钥匙包新设备怎么接入不需要手动填几十项配置。第一台设备配置好后可以生成一串Setup URI——它像一个把钥匙、门禁卡、保险箱密码全打包好的钥匙包。第二台设备只要粘贴这串东西、输入密码就自动变成了你的另一家分店。5分钟跑起来从零到两台设备开始同步下面四条路顺利的话五分钟搞定。第1步先把总仓库开起来最简单的方式是用 Docker 启动一个 CouchDB。每条命令我都翻译成人话docker run --name my-sync-warehouse -d \ -e COUCHDB_USERadmin \ -e COUCHDB_PASSWORD换成你自己的强密码 \ -p 5984:5984 \ couchdb:latestdocker run --name my-sync-warehouse开一个新容器起名叫 my-sync-warehouse给仓库挂牌子-e COUCHDB_USERadmin设置管理员账号叫 admin-e COUCHDB_PASSWORD...设置管理员密码记得换成自己的强密码-p 5984:5984把容器的 5984 端口暴露出来让插件能找到它couchdb:latest使用官方最新的 CouchDB 镜像。启动后在浏览器打开http://你的服务器IP:5984/_utils你会看到 CouchDB 的管理界面这就是你的总仓库Obsidian LiveSync插件 的数据都会存放在这里如果你不想碰命令行可以用 Fly.io 一键部署或者直接用已有的 AWS S3、阿里云 OSS、腾讯云 COS 这类对象存储当仓库后面会讲到怎么填。第2步把插件装进 Obsidian先拿到插件代码git clone https://gitcode.com/gh_mirrors/ob/obsidian-livesync.git这条命令把插件源码从开源仓库下载到本地这串地址就是该项目的官方仓库。cd obsidian-livesync npm install npm run buildcd obsidian-livesync进入刚才下载的插件目录npm install安装构建所需的依赖npm run build把源码编译成 Obsidian 能加载的插件文件。然后打开 Obsidian设置 → 第三方插件 → 关闭安全模式 → 浏览 → 从文件夹安装插件选中刚才的目录启用即可。第3步跟着向导填写仓库信息打开插件的Setup wizard设置向导第一次使用直接选放弃现有配置并进行设置点 Next。在 Obsidian LiveSync插件 里填写仓库地址、账号、密码和数据库名填完点 Test 测试然后把第1步的地址http://你的服务器IP:5984、用户名、密码、数据库名填进去点Test看连接是否成功点Check database configuration向导会自动检查并修复数据库配置出现的修复按钮全部点掉直到变成绿色勾勾选端到端加密顺手打开路径混淆。如果用的是对象存储填写的是 Endpoint、Access Key、Bucket 这类信息逻辑一模一样S3 兼容的对象存储同样能当总仓库填好密钥测试连接即可第4步把钥匙包复制到第二台设备向导最后一步点Apply等它显示All done!。此时插件会弹出Copy setup URI让你设一个密码然后把 Setup URI 复制到剪贴板。这张图里的笔记就是通过 Setup URI 从一台设备旅行到另一台设备的在第二台设备上装好插件从命令面板运行Open setup URI粘贴这串内容并输入密码选择作为后续设备设置。几秒钟后两台设备就开始同步了。易错提醒Setup URI 相当于钥匙包请存进密码管理器别贴在笔记里——那等于把钥匙放在保险箱门口。真实世界的三种用法总有一个像你用法一张博士的实验笔记本张博士做生物研究实验室电脑、办公室平板、手机三处跑。以前实验数据全攒在实验室电脑里回家想整理就抓瞎。现在她把仓库部署在实验室服务器上三台设备全开实时同步。白天记的实验参数晚上躺床上就能在手机上整理成报告初稿。好处数据不出实验室成果随手可取。用法二创业团队的共享文档库小王团队五个人产品文档、会议记录、客户资料全靠网盘传改着改着就撞车。他们改用阿里云 OSS 当仓库每人用自己的密钥登录开启冲突自动合并。好处版本终于不打架了谁改了什么一目了然。用法三李小姐的隐私保险柜李小姐对隐私极其敏感坚决不让笔记经过第三方。她在家里一台旧电脑上部署仓库端到端加密加路径混淆全开出门在外也敢用公共Wi-Fi同步。好处就算服务器被整个搬走也没人能读懂她的箱子。三张桌子摆开比一比自托管 vs 官方订阅 vs 手动搬自托管Obsidian LiveSync插件官方云同步手动拷贝/网盘数据在谁手里你自己的服务器或存储厂商手里你自己手里钱包感受免费或极低成本按月/按年订阅网盘会员也要钱同步体验实时、自动、无感实时、自动手动操作全靠自觉上手难度中等这篇指南就是教这个低低一句话官方同步像住酒店——省心但房间不是你的自托管像买自己的房——要自己打理但门锁钥匙全归你。进阶玩法把同步玩出花玩法一P2P 直连同步——分店之间直接递货是什么不经过总仓库两台设备通过 WebRTC 直连传输像两家分店隔着窗户直接递货。能干嘛没有服务器也能临时同步局域网内共享笔记对延迟敏感的场景更顺滑。怎么开启插件设置里启用 P2P 同步配置好中继服务器后建立连接右侧会出现 P2P 状态面板随时能看到连接状态和对等设备。Obsidian LiveSync插件 的 P2P 状态面板可以看到连接状态和已发现的设备玩法二Setup URI 一键搬家——连设置一起迁是什么Setup URI 不仅能同步笔记还能带上 Obsidian 设置、插件配置、主题和代码片段。能干嘛新设备装好 Obsidian粘贴一串 Setup URI半小时恢复你熟悉的整个工作环境像手机换机迁移。怎么开启配置向导最后一步会自动弹出 Copy setup URI存好备用新设备用 Open setup URI 导入即可。玩法三路径混淆——箱子上连标签都是乱码是什么在端到端加密的基础上把文件名和目录名也一起加密。能干嘛你的笔记标题对服务器完全不可见隐私再上一层楼。怎么开启向导的加密步骤里勾选 Path Obfuscation 就行。新手最容易踩的四个坑坑一状态栏一直转圈进度条不动症状图标亮着同步就是不走。原因网络连不上服务器或者服务器根本没起来比如 Docker 容器没在跑。解法先 ping 服务器地址看通不通再用docker ps确认容器状态最后打开插件日志看具体报错。坑二控制台飘红CORS 报错症状连不上数据库控制台全是 CORS 错误。幽默比喻朋友说欢迎来我家但小区保安死活不放行。解法在插件设置里开启 Use Request API to avoid CORS problem或者去服务器正确配置跨域。用 Fly.io 一键部署的话它已经帮你配好了。坑三加密密码忘了笔记读不出来症状同步正常但内容全乱码。幽默比喻箱子完好无损可惜钥匙丢了。解法把密码短语存进密码管理器别用记在某个笔记里这种绕圈子的办法条件允许的话定期导出一份未加密备份。坑四两台设备同时改了一个文件症状同一条笔记在电脑和手机上分别改过两边不一致。幽默比喻像两个人同时改一张菜单一个加了珍珠奶茶一个删了珍珠奶茶。解法简单冲突改的是不同段落会自动合并复杂冲突会弹出解决对话框让你选保留哪一版。动手自测清单照着打勾就行部署前所有设备安装了相同版本的 Obsidian服务器端口已开放CouchDB 默认 5984网络能 ping 通服务器现有笔记已备份安全第一配置时Test 连接成功Check database configuration 里所有修复项都变成了绿色勾已开启端到端加密已开启路径混淆可选Setup URI 已存进密码管理器使用中第一台设备改一条笔记第二台几秒内出现同样内容每月看一眼数据库健康状态留意插件更新最后说几句同步不该是你每天惦记的负担也不该是数据拱手交人的理由。Obsidian LiveSync插件 把选择权完整交还给你仓库放在哪、加密到哪一层、哪些设备接入全由你说了算。它就像那家永远有人值守的分店默默把每台设备上的笔记对齐而你只需要专注写下去。现在就可以动手把上面第1步的 Docker 命令复制进终端先开起你的第一间总仓库再回 Obsidian 走一遍设置向导。五分钟后你会看到今天随手记的那条笔记正安静地出现在另一台设备上——那种感觉真的很不错。【免费下载链接】obsidian-livesync项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Obsidian LiveSync插件自托管同步完整指南：5分钟搞定多设备笔记同步
Obsidian LiveSync插件自托管同步完整指南5分钟搞定多设备笔记同步【免费下载链接】obsidian-livesync项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync一句话定位Obsidian LiveSync插件 是一款开源免费的自托管同步插件让你像用官方云同步一样省心但笔记仓库由你自己保管数据从头到尾握在自己手里。周五晚上十点你瘫在沙发上刷手机。白天在办公室电脑上随手写的那条下周实验要带的试剂清单此刻安安静静躺在手机里。你根本没手动传过——它自己就来了。不止清单还有昨天记的读书摘抄、上个月整理的客户话术全都在两台设备上整整齐齐保持一致。这就是 Obsidian LiveSync插件 的日常。它给你的笔记库配了一个只属于你自己的总仓库所有设备自动往这个仓库存取笔记。CouchDB、S3对象存储、甚至一台旧电脑都能当仓库数据不经过任何第三方公司同步却快得像变魔术。没有它的一天 vs 有它的一天先把时间拨回还没装这个插件的时候。没有它的那天早上在办公室电脑改完方案下午回家想继续发现文件还留在公司。你打开网盘手动传一遍晚上在笔记本上改完又得传回去。今天传明天忘版本开始打架——桌面上陆续长出方案_最终版方案_最终版2方案_真最终版。手机就更别想了出门想看个笔记只能祈祷自己记得带U盘。有它的那天在哪台设备上改完其他设备过几秒就跟着更新。手机、平板、公司电脑、家里的旧笔记本全都是同一版笔记。你根本不会再去想同步这件事因为它安静得像不存在。两个版本的核心差别不是快了一点而是彻底不用管了。这正是 Obsidian LiveSync插件 存在的意义把同步这种琐事从你的脑子里删掉。它到底怎么做到的三个比喻讲透没接触过同步原理也不用怕。我们干脆把整套系统想象成一家带分店的咖啡店。第一件事为什么需要一间总仓库你手上有好几家分店电脑、手机、平板每家的柜台就是本地笔记库。问题是分店之间没法直接串货——手机不可能24小时在线等着收货。所以你需要一间随时开门的总仓库也就是 CouchDB 服务器或 S3 兼容的对象存储。分店A的店员把新货送进仓库分店B的店员再来取走。谁不在线都没关系货先寄存在仓库里等它开门自取。全流程用文字画出来是这样你在电脑上写下笔记 │ ① 加密封箱可选但强烈推荐 ▼ 总仓库CouchDB / 对象存储 │ ② 手机来取货并拆箱 ▼ 手机上出现同样的笔记第二件事加密 封箱上锁钥匙只有你有笔记离开设备的那一刻可以顺便被封进一个只有你能打开的箱子——这叫端到端加密相当于把信装进只有你和收信人拿得到钥匙的保险箱。仓库管理员服务器看到的只是一堆看不出内容的箱子就算服务器被入侵也读不出半个字。更讲究一点还能开路径混淆连箱子外面的标签都变成乱码文件名也一起保密。第三件事Setup URI 开店钥匙包新设备怎么接入不需要手动填几十项配置。第一台设备配置好后可以生成一串Setup URI——它像一个把钥匙、门禁卡、保险箱密码全打包好的钥匙包。第二台设备只要粘贴这串东西、输入密码就自动变成了你的另一家分店。5分钟跑起来从零到两台设备开始同步下面四条路顺利的话五分钟搞定。第1步先把总仓库开起来最简单的方式是用 Docker 启动一个 CouchDB。每条命令我都翻译成人话docker run --name my-sync-warehouse -d \ -e COUCHDB_USERadmin \ -e COUCHDB_PASSWORD换成你自己的强密码 \ -p 5984:5984 \ couchdb:latestdocker run --name my-sync-warehouse开一个新容器起名叫 my-sync-warehouse给仓库挂牌子-e COUCHDB_USERadmin设置管理员账号叫 admin-e COUCHDB_PASSWORD...设置管理员密码记得换成自己的强密码-p 5984:5984把容器的 5984 端口暴露出来让插件能找到它couchdb:latest使用官方最新的 CouchDB 镜像。启动后在浏览器打开http://你的服务器IP:5984/_utils你会看到 CouchDB 的管理界面这就是你的总仓库Obsidian LiveSync插件 的数据都会存放在这里如果你不想碰命令行可以用 Fly.io 一键部署或者直接用已有的 AWS S3、阿里云 OSS、腾讯云 COS 这类对象存储当仓库后面会讲到怎么填。第2步把插件装进 Obsidian先拿到插件代码git clone https://gitcode.com/gh_mirrors/ob/obsidian-livesync.git这条命令把插件源码从开源仓库下载到本地这串地址就是该项目的官方仓库。cd obsidian-livesync npm install npm run buildcd obsidian-livesync进入刚才下载的插件目录npm install安装构建所需的依赖npm run build把源码编译成 Obsidian 能加载的插件文件。然后打开 Obsidian设置 → 第三方插件 → 关闭安全模式 → 浏览 → 从文件夹安装插件选中刚才的目录启用即可。第3步跟着向导填写仓库信息打开插件的Setup wizard设置向导第一次使用直接选放弃现有配置并进行设置点 Next。在 Obsidian LiveSync插件 里填写仓库地址、账号、密码和数据库名填完点 Test 测试然后把第1步的地址http://你的服务器IP:5984、用户名、密码、数据库名填进去点Test看连接是否成功点Check database configuration向导会自动检查并修复数据库配置出现的修复按钮全部点掉直到变成绿色勾勾选端到端加密顺手打开路径混淆。如果用的是对象存储填写的是 Endpoint、Access Key、Bucket 这类信息逻辑一模一样S3 兼容的对象存储同样能当总仓库填好密钥测试连接即可第4步把钥匙包复制到第二台设备向导最后一步点Apply等它显示All done!。此时插件会弹出Copy setup URI让你设一个密码然后把 Setup URI 复制到剪贴板。这张图里的笔记就是通过 Setup URI 从一台设备旅行到另一台设备的在第二台设备上装好插件从命令面板运行Open setup URI粘贴这串内容并输入密码选择作为后续设备设置。几秒钟后两台设备就开始同步了。易错提醒Setup URI 相当于钥匙包请存进密码管理器别贴在笔记里——那等于把钥匙放在保险箱门口。真实世界的三种用法总有一个像你用法一张博士的实验笔记本张博士做生物研究实验室电脑、办公室平板、手机三处跑。以前实验数据全攒在实验室电脑里回家想整理就抓瞎。现在她把仓库部署在实验室服务器上三台设备全开实时同步。白天记的实验参数晚上躺床上就能在手机上整理成报告初稿。好处数据不出实验室成果随手可取。用法二创业团队的共享文档库小王团队五个人产品文档、会议记录、客户资料全靠网盘传改着改着就撞车。他们改用阿里云 OSS 当仓库每人用自己的密钥登录开启冲突自动合并。好处版本终于不打架了谁改了什么一目了然。用法三李小姐的隐私保险柜李小姐对隐私极其敏感坚决不让笔记经过第三方。她在家里一台旧电脑上部署仓库端到端加密加路径混淆全开出门在外也敢用公共Wi-Fi同步。好处就算服务器被整个搬走也没人能读懂她的箱子。三张桌子摆开比一比自托管 vs 官方订阅 vs 手动搬自托管Obsidian LiveSync插件官方云同步手动拷贝/网盘数据在谁手里你自己的服务器或存储厂商手里你自己手里钱包感受免费或极低成本按月/按年订阅网盘会员也要钱同步体验实时、自动、无感实时、自动手动操作全靠自觉上手难度中等这篇指南就是教这个低低一句话官方同步像住酒店——省心但房间不是你的自托管像买自己的房——要自己打理但门锁钥匙全归你。进阶玩法把同步玩出花玩法一P2P 直连同步——分店之间直接递货是什么不经过总仓库两台设备通过 WebRTC 直连传输像两家分店隔着窗户直接递货。能干嘛没有服务器也能临时同步局域网内共享笔记对延迟敏感的场景更顺滑。怎么开启插件设置里启用 P2P 同步配置好中继服务器后建立连接右侧会出现 P2P 状态面板随时能看到连接状态和对等设备。Obsidian LiveSync插件 的 P2P 状态面板可以看到连接状态和已发现的设备玩法二Setup URI 一键搬家——连设置一起迁是什么Setup URI 不仅能同步笔记还能带上 Obsidian 设置、插件配置、主题和代码片段。能干嘛新设备装好 Obsidian粘贴一串 Setup URI半小时恢复你熟悉的整个工作环境像手机换机迁移。怎么开启配置向导最后一步会自动弹出 Copy setup URI存好备用新设备用 Open setup URI 导入即可。玩法三路径混淆——箱子上连标签都是乱码是什么在端到端加密的基础上把文件名和目录名也一起加密。能干嘛你的笔记标题对服务器完全不可见隐私再上一层楼。怎么开启向导的加密步骤里勾选 Path Obfuscation 就行。新手最容易踩的四个坑坑一状态栏一直转圈进度条不动症状图标亮着同步就是不走。原因网络连不上服务器或者服务器根本没起来比如 Docker 容器没在跑。解法先 ping 服务器地址看通不通再用docker ps确认容器状态最后打开插件日志看具体报错。坑二控制台飘红CORS 报错症状连不上数据库控制台全是 CORS 错误。幽默比喻朋友说欢迎来我家但小区保安死活不放行。解法在插件设置里开启 Use Request API to avoid CORS problem或者去服务器正确配置跨域。用 Fly.io 一键部署的话它已经帮你配好了。坑三加密密码忘了笔记读不出来症状同步正常但内容全乱码。幽默比喻箱子完好无损可惜钥匙丢了。解法把密码短语存进密码管理器别用记在某个笔记里这种绕圈子的办法条件允许的话定期导出一份未加密备份。坑四两台设备同时改了一个文件症状同一条笔记在电脑和手机上分别改过两边不一致。幽默比喻像两个人同时改一张菜单一个加了珍珠奶茶一个删了珍珠奶茶。解法简单冲突改的是不同段落会自动合并复杂冲突会弹出解决对话框让你选保留哪一版。动手自测清单照着打勾就行部署前所有设备安装了相同版本的 Obsidian服务器端口已开放CouchDB 默认 5984网络能 ping 通服务器现有笔记已备份安全第一配置时Test 连接成功Check database configuration 里所有修复项都变成了绿色勾已开启端到端加密已开启路径混淆可选Setup URI 已存进密码管理器使用中第一台设备改一条笔记第二台几秒内出现同样内容每月看一眼数据库健康状态留意插件更新最后说几句同步不该是你每天惦记的负担也不该是数据拱手交人的理由。Obsidian LiveSync插件 把选择权完整交还给你仓库放在哪、加密到哪一层、哪些设备接入全由你说了算。它就像那家永远有人值守的分店默默把每台设备上的笔记对齐而你只需要专注写下去。现在就可以动手把上面第1步的 Docker 命令复制进终端先开起你的第一间总仓库再回 Obsidian 走一遍设置向导。五分钟后你会看到今天随手记的那条笔记正安静地出现在另一台设备上——那种感觉真的很不错。【免费下载链接】obsidian-livesync项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考