本文介绍Obsidian的免费实时同步方案Self-hosted LiveSync，通过自建CouchDB数据库和Tailscale内网穿透，实现多设备双向实时同步。适合笔记库较大或使用AI工具频繁读写的用户，数据完全自托管，无需付费，支持iPhone和电脑端。部署需Docker基础，配置一次后可长期稳定使用。
Tags:
本文字数 4585，阅读大约需 9 分钟
先来看个效果 👇
电脑上改一行 Obsidian 笔记，手机上几乎同时就出现了变化。
不是延迟几秒、十几秒那种，是真的「实时」，而且完全免费。
这是我花了一天折腾出来的效果。过程步骤有点繁琐，但结果确实值得。
如果你也在用 Obsidian，也被同步问题头疼过，那下面的内容应该对你有帮助。
一切的起因
说实话，我用 iCloud 同步 Obsidian 已经很久了。
苹果设备之间自动同步，不用配置，装好就能用。
Obsidian 官方甚至直接把 iCloud 作为内置的同步方案之一，打开 App 就能看到它。
所以我一直图省事，就这么用着。
笔记不多的时候，确实没出过问题。
直到最近，我在用 Claude Code 对笔记做一些读写操作时，发现它频繁出错。
一些非常简单的操作，比如修改一个文件、写入一段内容，它都需要大量时间去思考和完成，而且完成质量很差。
我当时挺纳闷的。
然后我注意到，Claude Code 的报错信息里反复出现一个关键词：「iCloud 锁」。
？？
iCloud 还会锁文件？
顺着这个线索，我开始去了解 iCloud 的同步机制。
说来有点惭愧，用了这么久 iCloud，我对它的了解居然就像一个黑盒。知道它能同步照片、视频、文件，但完全不清楚它背后的同步机制是什么。
这一了解，才发现了一些关于 iCloud 的热知识。
iCloud 的同步机制，是为「少量大文件、低频修改」的场景设计的。
照片库、Pages 文档、Keynote 演示文稿，这些是它的舒适区。文件不多，体积大，改得不频繁，很少出现两端同时编辑同一个文件的情况。
在这种场景下，iCloud 用起来确实丝滑。
但 Obsidian 的使用模式，恰好踩在了 iCloud 的几个痛处上：
没有文件锁。 两台设备可以同时编辑同一个文件，互不知情。冲突了怎么办？后写入的版本直接覆盖先写入的。系统不会通知你，静默替你做了决定。
同步不是实时的。 系统会把短时间内的多次变更攒起来，批量处理。你在 Mac 上保存了一个文件，切到 iPhone 打开，看到的可能还是旧版本。
文件可能被「驱逐」。 开了「优化 Mac 储存空间」之后，iCloud 会把一些文件的内容从本地清走，只留一个 .icloud 占位符。
文件在 Finder 里看着完全正常，名字、大小、修改时间都在，但打开后是空的。
回想起来，我确实遇到过一些「灵异事件」。
有篇笔记我明明写过，后来查找时发现内容是空的。当时我很纳闷，以为是自己不小心删了。
最近，我又在笔记库里找到了三篇类似的情况。文件本身存在，但打开后内容全是空白。
好在之前我装了 Obsidian 的一个文件编辑历史插件——Edit History，能看到文件每一次的修改记录，支持随时回滚。
靠这个插件，那些丢失的内容才找了回来。
这里真的再次强烈推荐这个插件。 有了它，不用担心哪一次修改出问题，因为随时可以回到之前的任何一个版本。相当于给自己的笔记再加了一层保险。
那 iCloud 是不是就完全不能用了？
其实也不是。
如果你的笔记数量不多，而且只是自己日常手动读写，iCloud 同步大概率不会出问题。
但如果你的笔记库比较大，或者像我一样会用 AI Agent 去频繁地读写和修改笔记，那就不太建议继续用 iCloud 了。
Agent 的读写频率和并发量远超手动操作。叠加 iCloud 的同步延迟和缺乏文件锁的特性，就容易出现文件被锁、写入冲突，甚至像我遇到的「幽灵笔记」。
我的笔记数量只会越来越多，用 Agent 操作笔记也早已是日常工作流。
继续用 iCloud，后面一定还会频繁出问题。
所以，当下第一件事：把笔记库从 iCloud 迁出来。
从 iCloud 搬家
我以为迁移就是把文件从一个文件夹拖到另一个文件夹。
结果并不是。
iCloud 同步目录里的文件不像普通本地文件，直接移动会触发各种阻拦。我试过在 Finder 里拖，试过终端执行 mv 命令，试过压缩打包，都以失败告终。
我的库有 1 个多 G，八千多个文件。里面除了笔记，还有各种插件配置、缓存、附件。直接操作根本搞不定。
最终解决这个问题的，是 rsync 命令。
rsync 是一个擅长处理大量文件的同步工具，可以只复制有差异的部分，跳过不需要的缓存目录。用它把 iCloud 里的 vault 复制到本地，非常适合海量小文件的场景。
但即便用了 rsync，文件太多，也花了几十分钟。
如果你也有类似的迁移需求，操作前一定做好备份。 把整个笔记库搞丢了就真的得不偿失。
迁完之后，笔记的读写修改再也不受 iCloud 的影响了。顺畅得多。
但新的问题来了。
文件搬出来了，同步也没了。
如果我还需要在 Mac 和 iPhone 之间同步笔记，怎么办？
那么多同步方案，选哪个？
今天市面上 Obsidian 的同步方案非常多。
除了官方的 Obsidian Sync，还有坚果云、OneDrive、Google Drive 等网盘服务商提供的同步插件。可选的方案是真不少。
为了后面不再因为同步反复折腾，这一次我想认真挑一个最合适的。
在动手之前，我先做了一次比较详细的调研，把当前主流方案的优缺点做了一个横向对比。
调研的维度主要包括：是否实时同步、iOS 支不支持、费用多少、冲突处理能力、需不需要自己运维。
排了一圈下来，有几个发现让我印象深刻 👇
iOS 是最硬的分水岭。
这是这次调研最大的感触。很多在桌面上完全可行的方案，到了 iPhone 就走不通了。
原因是 iOS 的沙盒限制。
iPhone 上的 Obsidian 只能读 iCloud 容器或它自己的沙盒目录，根本看不到别的 App 缓存的文件夹。
所以「把 vault 放进某个网盘的本地同步文件夹」这种桌面上常用的招，在 iPhone 上完全行不通。
如果你和我一样，需要在 iPhone 上用 Obsidian，那可选范围一下就窄了很多。
几个主流方案简单聊一下：
坚果云 是国内体验比较好的现成方案。2025 年起官方上架了 Obsidian 插件，一键登录，配置门槛很低。但免费版每月上传限额 1GB，而且有请求频控（600 次 / 30 分钟），库大了容易触顶。它本质是定时同步，不是实时。
Obsidian Sync 官方 最省心最稳，零配置零运维，冲突处理是所有方案里最强的。但要付费，Standard 档 8/月。国内访问速度一般。
Syncthing 是一款优秀的工具，但 iOS 上需要付费第三方 App Möbius Sync（$4.99），而且 iOS 后台同步受限严重，可能一天才触发一两次同步。
Remotely Save 的主仓库自 2024 年 11 月起基本停更了，200 多个 open issue 无人处理。不建议长期依赖。
obsidian-git 桌面端好用，版本历史最强。但官方文档明确写着移动端「very unstable，不推荐」。
综合下来，我选了 Self-hosted LiveSync。
为什么是它？
它能做到真正的实时双向同步。 不是定时轮询，不是手动触发，是改了就同步。多端体验最接近官方 Obsidian Sync。
iOS 原生支持，不需要第三方 App。 同步逻辑直接跑在 Obsidian 插件内部，不受 iOS 后台限制的困扰。这是它相比 Syncthing 和 git 方案的最大优势。
免费，数据完全在自己手里。 除了需要一台当服务器的机器，没有其他费用。笔记不会上传到任何第三方服务器。
LiveSync 的工作原理是什么？
部署安装之前，先了解清楚其架构原理还是有很必要的。
Self-hosted LiveSync 是 Obsidian 社区的一个开源同步插件，GitHub 上的项目叫 vrtmrz/obsidian-livesync，维护非常活跃，一直在持续迭代。
Github 地址：https://github.com/vrtmrz/obsidian-livesync
它的工作原理用一句话就能讲清楚：
在你的每台设备上，Obsidian 通过这个插件连接到一个共享的 CouchDB 数据库。任何一端的笔记变动，都会实时推送到数据库，其他设备也会实时拉取。
你只需要自己搭一个 CouchDB。不需要买域名，不需要配 Nginx，不需要懂运维。
下面手把手走一遍整个搭建过程。
当然，如果你步骤比较繁琐麻烦，你也可以选择氪金💰，使用现成能提供的 CouchDB 服务，比如 fly.io。
手把手搭建 LiveSync
整个过程看起来步骤多，但思路其实就三件事：
装数据库、打通网络、配插件。
一件一件来，不复杂。
你需要准备什么
• 一台能常开的闲置电脑。我用的是一台闲置的 Mac mini，如果你没有，VPS 也行 • 这台机器上装好 Docker • 所有需要同步的设备装好 Obsidian • 所有设备装好 Tailscale（免费，负责把你的设备组进一个虚拟内网，还能自动签发 HTTPS 证书）
总成本：0 元。 CouchDB、Docker、Tailscale 个人版、LiveSync 插件，全部免费。
第一步：部署 CouchDB
CouchDB 是一个开源数据库，LiveSync 用它来存储和同步笔记数据。用 Docker 来跑，几条命令的事。
创建项目目录
打开终端，建一个放配置和数据的目录：
mkdir -p ~/obsidian-livesync && cd ~/obsidian-livesync
mkdir couchdb-data couchdb-etc创建 Docker Compose 文件
在目录下新建 docker-compose.yml，可以直接执行以下命令：
cat > docker-compose.yml << 'EOF'
services:
couchdb:
image: couchdb:latest
container_name: obsidian-livesync
environment:
- COUCHDB_USER=obsidian
- COUCHDB_PASSWORD=⚠️<这里需要改成你设置的密码>
volumes:
- ./couchdb-data:/opt/couchdb/data
- ./couchdb-etc:/opt/couchdb/etc/local.d
ports:
- "127.0.0.1:5984:5984"
restart: unless-stopped
EOF这块需要注意一下 👆
127.0.0.1:5984:5984 把 CouchDB 只绑在本机回环地址上。
如果写成 5984:5984，它会暴露给整个局域网甚至公网。绑到 127.0.0.1 之后，只有本机能直接连，外部访问全部交给后面的 Tailscale 来代理。
两个 volume 把数据目录和配置目录挂了出来，这样即使容器重建也不会丢数据。
完成以上步骤，目录结构应该是这样的👇
启动并验证
docker compose up -d
curl http://127.0.0.1:5984/看到类似这样的返回，说明 CouchDB 跑起来了：
{"couchdb":"Welcome","version":"3.x.x", ...}如果提示数据目录权限错误，别慌。CouchDB 在容器里以 UID 5984 运行，给它授权一次再重启就好：
sudo chown -R 5984:5984 ~/obsidian-livesync/couchdb-data ~/obsidian-livesync/couchdb-etc
docker compose restart初始化 CouchDB
CouchDB 的默认配置没法直接给 LiveSync 用，需要配好跨域、鉴权和请求体上限。
好在插件作者提供了一个初始化脚本，一条命令搞定：
curl -s https://raw.githubusercontent.com/vrtmrz/obsidian-livesync/main/utils/couchdb/couchdb-init.sh \
| hostname=http://localhost:5984 username=obsidian password=⚠️<这里需要改成上面设置的密码> bash跑完会看到：
Configuring CouchDB by REST APIs Done!这个脚本帮你做了三件事：
• 关掉匿名访问。 不然任何知道地址的人都能读写你的笔记 • 配好 CORS 白名单。 Obsidian 发请求带的来源比较特殊（桌面端是 app://obsidian.md，iOS 端是capacitor://localhost），默认会被拒绝，脚本把它们加进了白名单• 把请求体上限调到 4GB。 默认只有 64MB，大库或者带附件的笔记会被拒
到这里，数据库就准备好了 ✅
第二步：用 Tailscale 打通网络
为什么需要这一步？
因为 Obsidian 手机端要求服务器必须是 HTTPS，而且证书得是受信任的。
直接用 http://192.168.x.x:5984 这种局域网地址，iPhone 上的 Obsidian 会拒绝连接。
Tailscale 能帮你解决这个问题。它会给你的每台设备分配一个 *.ts.net 的域名，并自动签发受信任的 Let's Encrypt 证书。
不用买域名，不用装 Nginx，不用搞证书续签。
给所有设备装 Tailscale
Mac mini（当服务器的那台）、你的电脑、手机，都装上 Tailscale，登录同一个账号。装好之后，它们就自动组成了一个互通的虚拟内网。
Tailscale 现在是默认启用 HTTPS Certificates & Magic DNS，因此，无需额外操作，但需要知道，这两项配置需要打开。
同一页面能看到你的 Mac mini 的地址，类似 <机器名>.<你的tailnet>.ts.net，记下来，后面要用。
在 Mac mini 上开启 serve
tailscale serve --bg --https=443 http://127.0.0.1:5984这条命令的意思是：让 Tailscale 在 443 端口提供 HTTPS 服务，把收到的请求转发给本机的 CouchDB。
查看状态确认一下：
tailscale serve status你会看到类似这样的输出：
https://<机器名>.<你的tailnet>.ts.net (tailnet only)
|-- / proxy http://127.0.0.1:5984验证 HTTPS 是否通了
在另一台装了 Tailscale 的设备上试一下：
curl https://<机器名>.<你的tailnet>.ts.net/因为前面开了鉴权，你会看到：
{"error":"unauthorized","reason":"Authentication required."}这恰好说明 HTTPS 链路和鉴权都正常了 👍
带上账号密码再试一次：
curl https://<机器名>.<你的tailnet>.ts.net/_session \
-u obsidian:<⚠️前面设置的密码>返回 {"ok":true,...} 就彻底 OK 了 🎉
网络打通了 ✅
第三步：配置 Obsidian 插件
最后一步，把 Obsidian 和数据库连起来。
配置电脑端
在 Obsidian 第三方插件市场搜索 Self-hosted LiveSync，安装并启用。
找到远程配置标签页，添加一个远程数据库。
远程类型选 CouchDB。
填入服务器地址 https://<机器名>.<你的tailnet>.ts.net、用户名、密码、数据库名（这个随意，自己取的）。
点 Test 测连接，再点 Check and Fix，把出现的 Fix 按钮逐个点掉，直到全变成对勾。
如果能看到这个输出，就说明 CouchDB 连接是没有问题的。
同步模式选 LiveSync，点击应用。
这一步会把你整个库推送到服务器。
库大的话需要等几分钟。
推送完成后，插件会自动弹出一个 Setup URI。
这是一串加密字符串，把服务器地址、账号密码、加密口令和推荐设置全打包在了一起。配新设备时粘一下就好，不用每台手填。
配置移动端
因为我用的是苹果，所以这里以苹果的移动端的配置作为示例。
首先需要确认手机上 Tailscale 处于连接状态。
在手机上新建一个空白的 Obsidian vault。
关掉插件的安全模式，安装并启用 Self-hosted LiveSync 插件。
在电脑上打开 LiveSync 插件设置，点「使用 QR 码」。
打开手机上的相机，扫描上面的二维码。
连接成功后，按照指引开始同步即可，可参考下面的选择👇
等同步跑完，你就能在手机上看到所有笔记了。
🎉 从现在开始，任何一端的修改都会实时同步到另一端。
写在最后
说实话，上面这些步骤确实有些折腾。
尤其对不熟悉命令行的朋友来说，看到 Docker、CouchDB 这些词可能就有点犯怵了。
但好消息是，这只是一次性的。
配好之后，日常使用和以前完全一样。打开 Obsidian，写笔记，自动同步。跟之前用 iCloud 一样无感，只不过这次不会再丢笔记了。
同步速度极快，变更了几乎秒同步。
不花钱，全套方案零费用。
数据完全在自己手里，不经过任何第三方服务器。
开头那个实时同步的效果，就是这套方案跑起来之后的日常。每次在电脑上写完笔记，拿起手机就能看到，这种感觉确实很爽 🤣
如果你也被 Obsidian 的同步问题折腾过，不妨试试看 🤔
以上，就是本文全部内容，如果觉得这篇文章对你有启发，点赞、比心、分享三连就是对我最大的支持，谢谢～
• 用 Gemini 解锁 YouTube 新用法，信息获取效率提升 10 倍
• 有了 NotebookLM 后，还需要 Obsidian 吗？
• 我试了 NotebookLM 学习法后，彻底抛弃传统学习方式
• 我用 NotebookLM 解锁 PPT 的 5 种玩法，实现了 PPT 自由
• 全网都在抄 Karpathy 的知识库，但大多数人只学到了皮毛
没有评论:
发表评论