Docker 部署 CouchDB，实现 Obsidian 文档自动同步

2026-04-15 / 柒橙

本文最后更新于 90 天前，其中的信息可能已经有所发展或是发生改变。

obsidian 是个很好用的笔记软件，也有官方的文件同步服务，但是需要花费4$每月，如果设备是Apple的话可以使用 iCloud 服务来同步，Android 和 Window s就需要使用社区插件了

打开obsidian的设置，第三方插件，关闭安全模式，社区插件市场，在里面搜索 Self-hosted LiveSync，点击安装，启用后会有一些配置，稍后部署了CouchDB 再进行配置

CouchDB 部署（基于 Docker）

在使用 Self-hosted LiveSync 之前，我们需要先部署一个 CouchDB 服务，用来存储 Obsidian 的同步数据。这里推荐使用 Docker 部署，简单且方便维护。

首先，新建一个 docker-compose.yml 文件：

services:
  couchdb:
    image: couchdb:3
    container_name: couchdb
    restart: unless-stopped
    ports:
      - "5984:5984"
    environment:
      - COUCHDB_USER=admin
      - COUCHDB_PASSWORD=your_password_here
    volumes:
      - ./data:/opt/couchdb/data

其中需要注意：

COUCHDB_USER 和 COUCHDB_PASSWORD 是登录用的账号密码，建议自行修改为更安全的内容
./data 用于持久化数据库数据，避免容器删除后数据丢失

启动服务：

docker-compose up -d

启动完成后，可以通过浏览器访问：

http://你的服务器IP:5984

如果看到 CouchDB 的欢迎界面，说明服务已经正常运行。

初始化 CouchDB

访问这个网址进入CouchDB Fauxton 管理界面

http://你的服务器IP:5984/_utils/

首次访问时，需要进行简单初始化：

选择 “Setup”
选择 “Single Node（单节点）”
填入刚才在 docker-compose 中设置的用户名和密码
绑定地址建议选择 0.0.0.0（允许外部访问）
完成初始化

创建数据库

进入 CouchDB 后，需要手动创建一个数据库供 Obsidian 使用：

打开 Web UI（Fauxton）
点击 “Create Database”
输入数据库名称，例如：obsidian
确认创建

配置 CORS（关键步骤）

为了让 Obsidian 能正常连接 CouchDB，需要开启 CORS：
进入 Fauxton：

左侧点击 “Configuration”
找到 cors 相关配置，设置如下：
选择Enable CORS
在新增的下方选项中选择 All domains ( * )

现在你的CouchDB应该可以正常链接了

配置 Self-hosted LiveSync

接下来可以尝试配置插件，现在第三方插件里面启用 Self-hosted LiveSync

弹窗 Translation is available 选择 OK
如果你是第一次配置同步，而不是将该设备加入同步，选择第一个
选择第二个选项手动输入服务器地址
End-To-End 端到端加密功能，推荐开启在 End-to-EndEncryption 输入自己的加密密码，下一步即可
选择 CouchDB 作为存储数据库
在 URL 处填写CouchDB的服务器地址，Username和Password 填写 Docker 部署 CouchDB 的COUCHDB_USER 和 COUCHDB_PASSWORD，Database Name 填写我们在 CouchDB 创建的数据库名字
可以点击 Detect and Fix CouchDB Issues 里面会有一些修复选项
使用 Test Settings and Continue 测试连通性
点击 Restart and Initialise Server 重启 Obsidian 生效设置
如果你当前仓库有文档，最好现在本地备份一份，以免出现问题，确认完毕可以勾选三个i understand 和下方的 i have create a backup of my vault
Skip and Proceed
Do you want to send all chunks before replication? 是
接下来到插件设置预设选择 LiveSync 应用