
Obsidian LiveSync 免费自托管同步完全指南一台服务器让多设备笔记实时联动【免费下载链接】obsidian-livesync项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesyncObsidian LiveSync 是一款开源的笔记同步插件它用一台自托管服务器或对象存储把你的 Obsidian 笔记库实时同步到电脑、平板、手机等所有设备数据始终握在你自己手里不用再付订阅费、也不用把隐私交给别人。这篇文章不讲枯燥术语而用馆长搭私人图书馆的故事带你从零走完架服务器→装插件→接入第二台设备的全过程读完就能自己动手。一、先坦白你的笔记是不是也在各过各的回想一下你的日常在办公室电脑上改完的方案回家打开笔记本发现还是昨天那版地铁上用手机记了两条灵感晚上想整理翻遍手机没找到它被同步到哪儿了更别提那些躺在网盘里、永远不知道是不是最新的旧文件。你也许试过这些办法手动拷贝——U盘忘了带或者拷了旧的覆盖了新的网盘同步——慢还把自己的笔记交给别人保管每次只在一台设备上写——直接放弃了便利。这三条路都不痛快。真正想要的是在任意一台设备上改一笔其他设备几秒钟后自动更新且过程不经过任何厂商的服务器。这正是 Obsidian LiveSync 要解决的问题。它是一个装在 Obsidian 里的插件负责把你所有设备上的笔记库对齐而你只需要提供一台很便宜的服务器当作中转站。二、把同步想成一座私人图书馆一切就通了先回答一个基础问题同步到底在底层做了什么你可以把自己想象成一座私人图书馆的馆长。你的电脑、平板、手机是散布在城市三个方向的阅览室你希望三间阅览室的书架永远一模一样。问题来了怎么才能做到选项一雇三个人每天把书抄三份挨个送一遍。这是手动拷贝费人力、容易漏。选项二租一间中央总书库立下规矩——任何阅览室只要动过书就由搬运工把改动送到总书库登记再由总书库把新改动分发到其余阅览室。这是同步而 Obsidian LiveSync 就是你的搬运工团队。上面这张图就是这座图书馆的蓝图两边是书架你的笔记库 Vault各配一本本地登记簿PouchDB 本地数据库中间的 CouchDB 是总书库。箭头表示搬运路线——改动先记入本地登记簿再送进总书库最后派发到其他阅览室的登记簿书就更新了。顺手做一张对比表看看三条路各自的分量维度LiveSync 自托管官方订阅同步手动拷贝数据归属完全在自己手里厂商掌握在自己手里费用一台便宜服务器几乎免费按月订阅免费但耗时实时性秒级更新秒级更新靠记性隐私可选端到端加密厂商可读相对安全但极不便上手难度中等跟着本文走没问题低低三、总书库可以建在两种地方任你挑那么问题来了总书库建在哪儿两种主流选择看你手头有什么。选择 ACouchDB——专门为文档同步设计的档案柜。它天然就是干同步这行的插件对它的支持也最成熟新手首选。用 Docker 一条命令就能立起来docker run --name couchdb-livesync -d \ -e COUCHDB_USERadmin \ -e COUCHDB_PASSWORD换成你的强密码 \ -p 5984:5984 \ couchdb:latest跑起来之后你的总书库就开门营业了。如果嫌命令行麻烦也可以去 Fly.io 走一键部署就像在应用商店装个 App点几下完事。选择 B对象存储——适合已经有云账号的你。如果你手上已经有 AWS S3、阿里云 OSS、腾讯云 COS或者自己用 MinIO 搭过存储那就不用额外开服务器直接把桶子当总书库用。配置界面长这样填上端点地址、Access Key、Secret Key、区域和桶名点一下Test Connection确认通不通就完成了。是不是有点像填快递单把仓库地址和取件密码告诉系统就行。四、跟着馆长小林两天搭好整座图书馆光讲概念没劲咱们跟着一个真实的人走一遍。小林是个研究生手上有三台设备实验室电脑、宿舍平板、出门随身带的手机。他受够了在实验室写论文、回宿舍发现没同步的日子决定亲手搭自己的图书馆。第一天的上午先立起总书库小林照着上文的选择 A在实验室一台闲置小服务器上敲了那条 Docker 命令然后用浏览器打开管理面板新建一个空数据库。面板上能看到数据库列表——刚开始空空如也不要慌这很正常总书库就这么落成了。从下单到开门用了不到十分钟。第一天的下午给每间阅览室配上馆长助理总书库有了还得在每个设备上装搬运工也就是 Obsidian LiveSync 插件。获取代码并构建git clone https://gitcode.com/gh_mirrors/ob/obsidian-livesync.git cd obsidian-livesync npm install npm run build然后在 Obsidian 里设置 → 社区插件 → 浏览选择从文件夹安装插件指向刚构建好的目录启用即可。接着打开插件的快速设置向导把总书库的地址、账号、密码填进去——就是你刚才那台 CouchDB 的信息填完点一下Test Database Connection通了之后别忘了顺手打开两个开关端到端加密和路径混淆。这一步强烈推荐原因后面细说。第二天的早晨第二台设备 10 秒接入宿舍的平板怎么办不用再配一遍服务器更不用手动设置。小林在第一台设备上生成了一串 Setup URI——你可以把它理解为一把总钥匙总书库地址、账号、加密密码全被锁在这串密文里。把这串钥匙粘到平板的 Obsidian LiveSync 里输入当初设定的密码短语解锁完成。没过一会儿平板上的笔记库就和小林的电脑完全对齐了。他在实验室改的一段实验记录回到宿舍打开平板已经躺在那里等他了两天三台设备全部打通。而且全程没有第三方经手你的笔记内容。五、为什么它改完就到三个小原理讲给你听看到这里你可能会好奇它到底是怎么做到改完立刻出现在另一台设备的拆开看其实就是三件小事。第一件有个变化观察员盯着你的书架。插件会持续观察笔记库的变化只要文件一动立刻打包送走不用你手动点上传。而且它很聪明只搬运变化的部分增量同步而不是把整本书重新抄一遍——这也是为什么几十万字的知识库也能做到秒级同步。第二件书是锁进书箱才上路的。你开启端到端加密后笔记在离开设备前就被加密了搬运途中和存放在总书库里时都只是一只只打不开的锁箱。路径混淆更绝——连书脊上的书名都换成了编号服务器管理员就算凑近看也只知道这是编号 7 号箱不知道里面装的是你的日记还是账单。第三件两个管理员同时改同一本书会打起来吗会但可以解决。如果两人改的是不同段落系统会自动合并像两人各写各的章节互不干扰如果改的是同一段它就会弹出一个对话框把两个版本并排摆给你看让你拍板留下哪版。六、三种真实人生三套不同搭法案例一科研党的实验记录与文献笔记张博士每天在实验室电脑上记录数据在平板看文献在手机随手记灵感。她的搭法实验室服务器部署 CouchDB三台设备全部接入开端到端加密。效果是实验数据改完即时同步文献笔记随时可查灵感再也没丢过——现在连写错一个数据几分钟内三台设备都改过来了。案例二小团队的共享知识库王哥的创业团队有五个人要共享产品文档、同步会议记录、维护客户信息。他们的搭法直接用团队已有的阿里云 OSS 当总书库每人一台设备独立加密设成每小时自动同步一次遇到冲突自动合并。效果文档版本不再混乱改完大家立刻看到同一版。案例三隐私敏感者的绝对自控李小姐的底线是笔记绝不经过任何第三方。她的搭法在家里的 NAS 上跑 CouchDB开启端到端加密加路径混淆同步模式设成按需手动触发另外定期做本地备份。效果就算有人入侵服务器看到的也只是一堆打不开的编号箱子。七、进阶玩法从能同步到更顺手基础通了还有三个让体验再上台阶的玩法。玩法一P2P 直连分馆之间直接传书。如果两台设备在同一个局域网或者你想临时共享一份笔记可以走实验性的 P2P 同步——不经过总书库两间阅览室直接对传。面板长这样能实时看到连接状态和对端设备玩法二自定义同步规则。不是所有文件都值得同步。你可以只同步特定文件夹、排除临时文件和缓存、跳过图片视频这类大文件还可以设定同步频率实时每小时每天。相当于给搬运工划了条路线这层楼的书才搬仓库里的杂物不用管。玩法三让配置也一起搬家。这是很多人忽略的福利——LiveSync 不光同步笔记还能同步 Obsidian 的设置、社区插件配置、代码片段和主题。新设备装好 Obsidian 后直接一键恢复全部配置跟手机换机迁移一个体验。八、避坑小剧场图书馆里最常见的四起事故搭好的图书馆也不是永远风平浪静。这四起事故几乎每个馆长都会遇到。事故一搬运车卡在半路进度条不动了症状状态栏图标一直在转但数据不更新。常见原因有三个网络忽好忽坏搬运车迷路了、服务器配置填错总书库换了门锁、文件冲突两个管理员同时改了一本书。解法先ping一下服务器地址确认通不通再打开命令面板搜Show log看日志对照上文逐项排查。事故二小区保安拦门CORS 错误症状浏览器控制台报 CORS 跨域错误。你可以这么理解——总书库说欢迎你进来但小区保安浏览器的跨域策略把门拦住了。解法有三个选一个在插件设置里开启Use Request API to avoid CORS problem或者去 CouchDB 的 CORS 设置里允许你的域名访问再或者直接用 Fly.io 部署它默认就把 CORS 配好了最省心。事故三总钥匙和书箱钥匙一起丢了症状换了新设备Setup URI 找不到了加密密码也想不起来数据彻底解不开。预防比抢救重要把 Setup URI 和密码短语存进密码管理器而不是笔记里顺便设置密码提示再定期导出一份未加密备份。至于已经丢了的……下次一定记住密码管理器它不香吗事故四两本书打架同步冲突症状同一份文件在两台设备被同时改过同步时提示冲突。简单场景改的是不同段落系统会悄悄合并不用你操心复杂场景会弹出对话框把两个版本并排摆出来你选定留哪个。别慌这恰恰说明系统没有偷偷覆盖你的内容它把选择权留给了你。九、出发前、布置中、使用后三张勾选单给你三张现成的清单照着打勾就不会漏。出发前动手之前先确认各台设备都装了同一版本的 Obsidian服务器端口已放行CouchDB 默认 5984现有笔记已做过一次备份网络环境稳定能访问到服务器布置中配置过程的检查服务器上已创建好数据库插件里Test Database Connection测试通过已开启端到端加密和路径混淆Setup URI 已生成并保存到密码管理器密码短语足够长、足够怪使用后日常维护习惯隔几天瞄一眼状态栏的同步状态每月验证一次数据库健康有新版本时及时更新插件加密密码和 Setup URI 备份到两个不同地方十、现在轮到你当馆长了回头看看Obsidian LiveSync 做的事其实就一句让你的笔记只属于你同时又能出现在你所有的设备上。选存储、定加密、调频率每一个开关都握在你手里——这正是它和花钱把数据交出去最大的不同。想清楚的话现在就可以动手了先跑起那台 CouchDB再装上插件填好连接信息最后在第二台设备上粘贴 Setup URI。三件事加起来用不了一集电视剧的时间。 等你的笔记开始在你所有屏幕之间瞬移的那一刻你会回来谢这座图书馆的。【免费下载链接】obsidian-livesync项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-livesync创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考