Obsidian 笔记同步服务 | 告别付费同步服务！#

还在为 Obsidian 同步服务付费而心疼吗？今天教你免费搭建自己的笔记同步服务！

为什么要自建笔记同步服务？#

省钱大法：完全免费，没有同步费用
隐私保护：笔记数据完全掌握在自己手中
实时同步：多设备实时同步，像官方服务一样
无限制：没有设备数量限制，没有笔记数量限制

准备工作：fnOS 系统环境#

在 fnOS 系统中，我们已经内置了容器化环境，无需手动安装 Docker 和 Docker Compose。fnOS 提供了图形化的应用管理界面，让部署过程更加简单直观。

fnOS 系统优势#

开箱即用：系统已预装容器环境，无需额外配置
图形化管理：通过 Web 界面轻松管理应用
自动更新：应用自动更新，保持最新版本
资源监控：实时查看系统资源使用情况

访问 fnOS 管理界面#

1. 在浏览器中访问 fnOS 管理界面：http:// 你的 fnOS 设备 IP
2. 使用管理员账户登录
3. 在左侧菜单中找到”应用商店”或”应用管理”

第一步：在 fnOS 中安装 CouchDB 数据库#

1. 在 fnOS 主界面，点击左侧”应用商店”
2. 在搜索框中输入”CouchDB”
3. 找到 CouchDB 应用，点击”安装”
4. 配置 CouchDB 参数：

• 应用名称：保持默认或自定义
• 版本：选择最新稳定版
• CPU 限制：根据服务器配置设置（建议至少 1 核）
• 内存限制：建议至少 512MB
• 端口：保持默认 5984
• 管理员用户名：设置管理员用户名（建议使用英文字母和数字）
• 管理员密码：设置强密码（至少 12 位，包含大小写字母、数字和特殊字符）
• 同步用户名：设置用于 Obsidian 同步的用户名
• 同步密码：设置用于 Obsidian 同步的密码

5. 点击”确认安装”
6. 等待安装完成（通常需要 2-5 分钟）

第二步：验证 CouchDB 安装#

1. 在 fnOS 的”应用管理”页面查看 CouchDB 应用的状态
2. 确保应用显示为”运行中”
3. 记录 CouchDB 的访问地址和端口信息

第三步：安装和配置 LiveSync 插件#

在主设备上配置：#

1. 打开 Obsidian
2. 点击左下角设置图标
3. 🔓 选择”第三方插件”
4. 关闭”安全模式”
5. 点击”浏览社区插件”
6. 搜索”Self-hosted LiveSync”
7. 点击”安装”，然后点击”启用”

配置 LiveSync：#

1. 在插件列表中找到”Self-hosted LiveSync”，点击”选项”
2. 在”同步设置”中：

• 勾选”启用同步”

3. 在”远程数据库设置”中：
   • 数据库类型：选择”CouchDB”
   • CouchDB URI：填写http:// 你的同步用户名:你的同步密码 @ 你的 fnOS 设备 IP:5984
   • 数据库名称：设置一个数据库名（如：obsidian_sync）
   • 用户名：填写你在 fnOS 中设置的同步用户名
   • 密码：填写你在 fnOS 中设置的同步密码
4. 点击”测试连接”
5. 连接成功后，点击”保存设置”
6. 在”同步设置”中点击”立即同步”或”同步设备”

第四步：启用端到端加密（重要安全步骤）#

1. 在 LiveSync 设置中，找到”端到端加密”部分
2. 勾选”启用端到端加密”
3. 设置加密密码（建议使用强密码，不同于 CouchDB 密码）
4. 点击”应用加密密码”
5. 记录加密密码，所有设备必须使用相同密码

第五步：在其他设备上配置#

1. 在其他设备上安装 Obsidian
2. 安装并启用 LiveSync 插件
3. 重复步骤 5 的配置，使用相同的：

• CouchDB URI
• 数据库名称
• 用户名和密码

4. 在端到端加密部分，输入相同的加密密码
5. 点击”同步”，等待笔记下载

使用技巧#

冲突解决#

1. 🔥 当多设备同时修改同一笔记时，可能出现冲突
2. LiveSync 会创建冲突副本，文件名包含”conflict”
3. 打开冲突文件，手动合并修改
4. 删除不需要的冲突版本

同步历史#

1. 在 LiveSync 设置中查看”同步历史”
2. 可以查看每次同步的详细信息
3. 🔙 如有问题，可以回滚到之前的版本

选择性同步#

1. 在 LiveSync 设置中，点击”排除项”
2. 添加不需要同步的文件或文件夹
3. 支持通配符匹配（如：*.tmp）

高级配置#

使用域名和 HTTPS#

1. 在 1Panel 中安装 Nginx
2. 配置反向代理：

1
server {
2
    listen 80;
3
    server_name your-domain.com;
4

5
    location / {
6
        proxy_pass http://localhost:5984;
7
        proxy_set_header Host $host;
8
        proxy_set_header X-Real-IP $remote_addr;
9
    }
10
}

3. 配置 SSL 证书（可使用 Let’s Encrypt 免费证书）
4. 更新 LiveSync 中的 URI 为 HTTPS 地址

数据备份#

1. 在 fnOS 管理界面中，点击”备份”菜单
2. 创建新的备份计划：

• 备份类型：选择”应用数据”
• 选择应用：CouchDB
• 备份路径：选择或自定义备份存储位置
• 备份频率：建议设置为每日或每周
• 保留数量：根据需求设置保留的备份文件数量

3. 点击”创建”完成备份计划设置
4. 系统将自动按照设置的时间执行备份任务

性能优化#

2. 增加 CouchDB 内存限制：

   • 在 fnOS 的”应用管理”页面找到 CouchDB
   • 点击”设置”，调整资源限制
   • 建议将内存限制增加到 1GB 或更多

3. ** 定期清理同步日志 **：

   • 在 LiveSync 设置中，勾选”自动清理旧日志”
   • 设置保留天数（建议 30 天）

故障排除#

同步失败#

1. 检查网络连接
2. 验证 CouchDB 服务是否运行：

   PRTCL // BASH

   1
   docker ps | grep couchdb

   COPY

3. 检查 LiveSync 中的连接信息是否正确
4. 查看 1Panel 中的 CouchDB 容器日志

加密问题#

1. 确保所有设备使用相同的加密密码
2. 如果忘记加密密码，需要：

• 在所有设备禁用加密
• 重新设置加密密码
• 重新同步

性能问题#

1. 减少同步频率（在 LiveSync 设置中调整）
2. 排除大文件或不需要同步的文件
3. 升级服务器配置（CPU 和内存）

服务管理#

查看 CouchDB 状态#

1. 在 fnOS 中，进入”应用管理”
2. 找到 CouchDB，查看运行状态
3. 点击应用可以查看详细信息、资源使用情况和日志

重启服务#

1. 在 fnOS 的”应用管理”页面找到 CouchDB 应用
2. 点击”重启”按钮
3. 等待服务恢复

更新 CouchDB#

1. 在 fnOS 的”应用管理”页面找到 CouchDB 应用
2. 点击”更新”按钮，fnOS 会自动下载最新版本并更新
3. 更新过程中应用会短暂重启，完成后自动恢复运行

总结#

恭喜你！现在你拥有了自己的笔记同步服务！再也不用：

• 支付 Obsidian 同步服务费用
• 担心笔记数据泄露
• 受限于设备数量限制
• 担心同步速度和稳定性

快去体验吧！如果遇到问题，欢迎在评论区交流~

关于我#

全平台同名”汪多多是只猫”，专注分享实用开源工具，让你的数字生活更自由！

关注我，发现更多自建服务的乐趣与技巧！

#Obsidian #笔记同步 #LiveSync #fnOS #自建服务