搜索

Docker 部署 Obsidian LiveSync 实时同步服务指南

2026年06月26日 6 阅读 0 评论 7709 字

Docker 部署 Obsidian LiveSync 实时同步服务指南

__2026年1月5日 __3条评论 __459次阅读 __0人点赞 __Tao_Qi

使用 Docker 自托管部署 Obsidian LiveSync 服务，获得端到端加密的多设备实时同步服务支持的详细指南。
原文链接：https://blog.dejavu.moe/posts/selfhosting-obsidian-livesync-service-guide/

序

Obsidian LiveSync 是一款面向 Obsidian 用户的同步解决方案，无需依靠官方付费同步服务就能获得不错的实时同步体验，支持自动冲突处理、端到端加密，使我们完全掌控自己的数据和基础设施。

它支持使用自托管数据库 (Apache CouchDB) 、对象存储 (S3、B2、R2 等) 或 WebRTC P2P（实验性）来同步数据。对于对象存储和 P2P 同步，只需在插件里配置即可，无需服务端支持。

Apache CouchDB 是一个使用 JSON 作为存储格式，JavaScript 作为查询语言的 NoSQL 数据库，很适合作为 Obsidian 的存储。下面的自托管部署 LiveSync 服务，本质上就是部署一个单节点运行的 CouchDB 数据库。

部署 LiveSync 服务

先决条件

已安装 Docker CE
已安装 Docker Compose
Nginx 或其他用于反向代理服务器
SSL/TLS 证书提供 HTTPS 访问（必需的）

开始部署

准备一个文件夹，用于 LiveSync 容器数据持久化
[code]

mkdir obsidian-livesync && cd $
# 准备 Docker 绑定卷
mkdir -p {data,local.d}
sudo chown -R 1000:1000 {data,local.d}

[/code]

新建一个 compose.yml 模板
[code]

vim compose.yml

[/code]

写入内容
[code]

services:
  couchdb:
    image: couchdb:3.5
    container_name: obsidian-livesync
    user: 1000:1000
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai
      - COUCHDB_USER=           # 设置用户名
      - COUCHDB_PASSWORD=  # 设置一个强密码
    volumes:
      - ./data:/opt/couchdb/data
      - ./local.d:/opt/couchdb/etc/local.d
    ports:
     - '127.0.0.1:5984:5984'

[/code]

启动服务
[code]

sudo docker compose up -d

[/code]

初始化数据库

使用官方脚本对数据库进行初始化，注意替换用户名和密码
[code]

curl -s https://raw.githubusercontent.com/vrtmrz/obsidian-livesync/main/utils/couchdb/couchdb-init.sh | hostname=http://127.0.0.1:5984 username= password= bash

[/code]

建议初始化后重启下容器
[code]

sudo docker compose down && sudo docker compose up -d

[/code]

OK，现在 CouchDB 数据库已经准备就绪。

反向代理

我使用 Nginx 设置反向代理访问，下面是一个示例配置文件：
[code]

server {
    listen 80;
    listen [::]:80;
    server_name ob-livesync.your.domain;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    http2 on;
    server_name ob-livesync.your.domain;

    ssl_certificate /path/to/cert/ob-livesync.your.domain.pem;
    ssl_certificate_key /path/to/cert/ob-livesync.your.domain.key;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ecdh_curve X25519:P-256:P-384;
    ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-CHACHA20-POLY1305:ECDHE AES128:RSA AES128:ECDHE AES256:RSA AES256';
    ssl_prefer_server_ciphers off;

    ssl_session_timeout 1d;
    ssl_session_cache shared:MozSSL:10m;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

    access_log /var/log/nginx/ob-livesync.your.domain.access.log;
    error_log /var/log/nginx/ob-livesync.your.domain.error.log;

    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header Referrer-Policy "no-referrer-when-downgrade" always;
    add_header Content-Security-Policy "default-src 'self' http: https: data: blob: 'unsafe-inline'" always;

    client_max_body_size 4G;

    proxy_read_timeout 3600s;
    proxy_send_timeout 3600s;

    location / {
        proxy_pass http://127.0.0.1:5984;
        proxy_http_version 1.1;

        proxy_set_header Host $http_host;
        proxy_set_header X-Forwarded-For $realip_remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;

        proxy_redirect off;
    }
}

[/code]

检查 Nginx 配置
[code]