如何快速搭建 Obsidian LiveSync：实现多设备实时协作的完整指南

Obsidian LiveSync 是一款强大的 Obsidian 插件，它让你能够在多台设备间实时同步笔记，无需依赖第三方云服务。通过自托管服务器，你可以完全掌控数据安全，轻松实现团队协作或个人多设备无缝切换。本文将带你一步步完成从环境搭建到日常使用的全过程，让知识管理效率提升 10 倍！

为什么选择 Obsidian LiveSync？

✅ 核心优势解析

• 实时双向同步：修改立即生效，多设备间无延迟协作
• 端到端加密：采用 256-bit AES-GCM 加密算法，数据安全有保障
• 自托管灵活部署：支持多种服务器方案，完全掌控数据存储
• 低带宽优化：智能分块技术减少流量消耗，节省网络成本

Obsidian LiveSync 采用 PouchDB 与 CouchDB 技术架构，实现高效数据同步

🚀 适用场景

• 团队知识库：多人实时协作编辑项目文档
• 跨设备工作流：电脑/平板/手机无缝切换工作状态
• 远程学习小组：共享笔记资源，共同标注重点内容
• 个人知识管理：多设备备份重要笔记，防止数据丢失

准备工作：3 分钟环境检查

开始前请确保你的设备满足以下条件：

• 安装 Obsidian v1.0 以上版本
• 拥有基本的命令行操作能力
• 准备一台云服务器或本地服务器（推荐 1GB 内存以上）
• 网络环境支持 HTTPS 连接（移动端必需）

快速搭建指南：3 种部署方案任选

方案 1️⃣：使用 Fly.io 一键部署（推荐新手）

Fly.io 提供简单的部署流程和免费额度，非常适合个人用户：

1. 访问项目仓库克隆代码：

git clone https://gitcode.com/gh_mirrors/ob/obsidian-livesync
cd obsidian-livesync

2. 运行自动化部署脚本：

cd utils/flyio
chmod +x deploy-server.sh
./deploy-server.sh

3. 根据提示完成配置，系统会自动生成访问链接和凭证：

-- YOUR CONFIGURATION --
URL     : https://your-instance.fly.dev
username: auto-generated-username
password: auto-generated-password
region  : your-region

Obsidian LiveSync 快速设置向导界面

方案 2️⃣：本地服务器搭建（适合技术爱好者）

如果你已有服务器，可通过 Docker 快速部署：

1. 创建数据目录并设置环境变量：

mkdir couchdb-data couchdb-etc
export username=your-username
export password=your-password

2. 启动 CouchDB 容器：

docker run --name couchdb-livesync -d \
  -e COUCHDB_USER=${username} \
  -e COUCHDB_PASSWORD=${password} \
  -v ${PWD}/couchdb-data:/opt/couchdb/data \
  -v ${PWD}/couchdb-etc:/opt/couchdb/etc/local.d \
  -p 5984:5984 couchdb

3. 运行初始化脚本配置数据库：

curl -s https://raw.githubusercontent.com/vrtmrz/obsidian-livesync/main/utils/couchdb/couchdb-init.sh | bash

方案 3️⃣：Cloudant 托管服务（适合企业用户）

IBM Cloudant 提供托管的 CouchDB 服务，适合需要高可用性的团队：

1. 在 IBM Cloud 控制台创建 Cloudant 实例，选择"Lite"免费计划
2. 配置 CORS 允许所有域名访问（生产环境可设置特定域名）
3. 创建数据库并生成 API 凭证

Cloudant 远程数据库设置界面，可直接在 Obsidian 插件中配置

Obsidian 插件配置：5 步完成设置

第 1 步：安装插件

1. 打开 Obsidian → 设置 → 第三方插件
2. 关闭"安全模式"
3. 搜索"Self-hosted LiveSync"并安装

第 2 步：导入配置 URI

1. 打开命令面板（Ctrl+P 或 Cmd+P）
2. 输入"Use the copied setup URI"
3. 粘贴部署时生成的 URI 链接
4. 输入设置 URI 的密码（非加密密码）

Obsidian LiveSync 配置导入界面，支持一键导入服务器设置

第 3 步：启用端到端加密（强烈推荐）

1. 在插件设置中找到"Privacy & Encryption"
2. 勾选"End-to-End Encryption"
3. 设置加密密码（请牢记此密码！）
4. 可选：启用"Path Obfuscation"隐藏文件路径

第 4 步：配置同步规则

1. 选择同步模式：实时同步(LiveSync)或定期同步(Periodic)
2. 设置文件过滤规则（默认同步所有 markdown 文件）
3. 配置冲突解决策略（建议使用" newer file"）

Obsidian LiveSync 提供多种同步策略，满足不同使用场景

第 5 步：测试连接

1. 点击"Test Database Connection"
2. 确认显示"Connection successful"
3. 重启 Obsidian 完成设置

高级技巧：让协作更高效

📁 文件同步精细化管理

通过正则表达式设置文件过滤规则：

• 同步指定文件夹：^docs/.*
• 排除临时文件：.*\.tmp$
• 设置最大文件大小：在设置中配置"Maximum file size"

配置文件位于：src/modules/core/ModuleTargetFilter.ts

🔄 冲突解决最佳实践

当多人同时编辑同一文件时：

1. 系统会自动检测冲突并提示
2. 可选择保留"本地版本"或"远程版本"
3. 复杂冲突可通过"Compare & Merge"手动解决

Obsidian LiveSync 冲突解决对话框，支持可视化比对差异

🛠️ 性能优化设置

对于大型知识库（1000+ 文件）：

• 增大缓存大小：设置"Memory cache size"为 2000
• 调整分块大小：在高级设置中增加"Enhance chunk size"
• 启用批量更新：设置"Batch database update"减少写入频率

常见问题解答

❓ 同步速度慢怎么办？

• 检查网络连接，推荐使用 5GHz Wi-Fi 或有线网络
• 调整"Batch size"参数，建议设为 100-200
• 清理冗余数据：在维护面板运行"Perform cleanup"

❓ 如何迁移到新服务器？

1. 在新服务器部署 CouchDB
2. 导出旧服务器数据：使用"Copy current settings as a new setup URI"
3. 在新服务器导入设置 URI
4. 运行"Fetch from remote"完成数据迁移

❓ 移动端无法连接服务器？

• 确保服务器配置 HTTPS（移动端必须）
• 检查防火墙设置，开放 443 端口
• 尝试切换"Use Custom HTTP Handler"选项

总结：开启高效协作之旅

Obsidian LiveSync 打破了传统笔记软件的设备壁垒，让知识流动更加自由。通过本文介绍的方法，你可以在 30 分钟内搭建起安全可靠的同步系统，无论是个人使用还是团队协作都能游刃有余。

立即尝试 Obsidian LiveSync，体验实时协作带来的效率提升！如有任何问题，欢迎查阅官方文档 docs/ 或提交 Issue 获取帮助。

安全提示：请定期备份你的加密密码和服务器配置，建议使用密码管理器妥善保管。所有同步数据默认存储在本地，确保即使服务器出现问题也不会丢失重要笔记。