Obsidian 极速全端同步方案 Livesync 部署指南

目录

• 简要教程
• 详细教程
  • 第一步：部署“私人数据中转站”—— CouchDB
  • 第二步：设置 CORS 全县
  • 第三步：配置 Obsidian Livesync 插件
  • 第四步：一键同步到你的手机和其他设备

简要教程

1. 效果：秒级同步，字符级别同步，非常丝滑
2. 使用部署平台部署 ConchDB （Docker 常规部署）（这里链接一下 Gemini 的回答）
   1. 可使用的平台：Zeabur（每月 5 美元赠金，这个项目大概一个月消耗 1 - 2 美元）、Northflank
   2. 平台必须要支持持久化存储，否则不能用。
   3. 关键配置：
      1. 镜像地址：docker.io/library/couchdb:latest
      2. 环境变量：
         • COUCHDB_USER: 设置管理员用户名，例如 admin。
         • COUCHDB_PASSWORD: 设置一个非常强壮的管理员密码。请务必使用密码管理器生成并保存好。
      3. 端口号：5984，类型 HTTP
      4. Volume Path：/opt/couchdb/data
3. 登陆 ConchDB 激活 CORS，允许所有域名
4. 安装 LiveSync 插件，选择“远程配置”选项卡，填入域名和账号、密码，“同步设置”中选择 Livesync 预设，其他设置问一下 AI 按需选择就可以了，大概就已经能用了。
5. 设置同步到手机和其他设备：把配置生成为 URI 发给其他设备，其他设备粘贴在笔记中点击打开，即可一键导入配置，非常简单

详细教程

详细教程主要由 Gemini 2.5 Pro AI 生成，但已经经过修改和验证

第一步：部署“私人数据中转站”—— CouchDB

Livesync 的核心是需要一个 CouchDB 数据库作为同步中介。别被“数据库”吓到，借助现代化的部署平台，整个过程就像点几下鼠标一样简单。

1. 选择平台：
我们推荐使用提供 Docker 部署和持久化存储的 PaaS 平台。它们通常有免费额度，对本项目来说绰绰有余：

• Zeabur: 每月有 5 美元赠金，本项目每月仅消耗 1-2 美元，几乎免费。
• Northflank / Koyeb / Render: 类似平台，提供免费或低成本的容器服务。

核心要求：平台必须支持持久化存储 (Persistent Storage / Volumes)，否则你的数据会在服务重启后丢失！

2. 关键配置：
在平台新建服务时，请选择从 Docker 镜像部署，并填写以下关键信息：

• 镜像地址: couchdb:latest 或 docker.io/library/couchdb:latest
• 环境变量:
  • COUCHDB_USER: 你的管理员用户名 (例如 admin)
  • COUCHDB_PASSWORD: 一个超强密码 (请使用密码管理器生成并妥善保管！)
• 端口 (Port): 5984，协议类型 HTTP
• 持久化存储 (Volume):
  • 路径 (Path/Mount Path): /opt/couchdb/data (这是 CouchDB 存放数据的固定路径，必须准确填写)
  • 大小 (Size): Zeabur 平台会自动分配，不需要设置，Northflank 最大可设置 6 GB

部署完成后，平台会给你一个公开的 URL，例如 https://my-obsidian-db.zeabur.app，把它复制下来。

第二步：设置 CORS 全县

出于安全，CouchDB 默认拒绝来自外部的访问。我们需要手动为 Obsidian “开门”。

1. 访问你的 CouchDB 管理面板，地址是你的 URL + /_utils/，例如：https://my-obsidian-db.zeabur.app/_utils/
2. 使用你刚才设置的 COUCHDB_USER 和 COUCHDB_PASSWORD 登录。
3. 在左侧菜单点击齿轮图标 (⚙️) 进入 Configuration，然后切换到 CORS 选项卡。
4. 点击 Enable CORS，并确保配置如下：
   • Origins: * (星号，代表允许所有来源，一劳永逸解决跨平台问题)

第三步：配置 Obsidian Livesync 插件

现在，回到 Obsidian，让魔法发生。

1. 在社区插件市场搜索并安装 Livesync。
2. 打开插件设置，在“远程配置”选项卡中，填写你的数据库信息：
   • URI: https://my-obsidian-db.zeabur.app (刚才复制的平台 URL)
   • 用户名/密码: 你在环境变量中设置的 admin 和超强密码。
   • 数据库名: 给你的仓库起个名字， 例如 my-vault，会自动创建一个以此命名的数据库
3. 切换到“同步设置”选项卡，在“预设”中选择 Livesync。这会自动帮你开启大部分推荐配置，如同步插件、主题和核心设置。
4. 至于其他高级设置，如 Property Encryption (属性加密)，强烈建议开启以获得极致隐私。如果你不确定某个选项的含义，可以咨询 AI 或查阅官方文档。

配置完成后，插件将开始初始化。根据提示选择 “从此设备重建两者 (Rebuild both from this device)”，将你当前设备的文件作为“标准答案”上传到云端。

第四步：一键同步到你的手机和其他设备

Livesync 提供了极其优雅的多设备配置方案。

1. 在已经配置好的主力设备上，进入 Livesync 设置，找到 Export setup URI (导出配置 URI) 选项。给这个 URI 设置一个密码，保护配置中的密码和其他敏感信息。
2. 复制生成的 obsidian:// 链接。
3. 将这个链接发送到你的其他设备（例如通过微信、邮件或备忘录）。
4. 在目标设备上，确保已安装 Obsidian 和 Livesync 插件。然后，在任何笔记中粘贴这个链接，并直接点击它。
5. Livesync 会自动识别并弹窗询问是否导入配置。确认后，所有配置将一键完成！
6. 在新设备上，它可能会提示同步数据库需要重建。此时选择 “从远程获取 (Fetch from remote)”，它就会自动从你的云端数据库拉取所有数据。

至此，你已成功搭建了属于自己的、安全高速的 Obsidian 实时同步系统。