Obsidian self host livesync从0开始
oumasa
2025年11月29日 13:56

文章用markdown写的,我实在懒得再一张张贴图了,请复制如下所有文字到markdown编辑器查看。

1,从官网下载Obsidian https://obsidian.md/download 并安装,安装好之后如果是英文,点击设置图标->General->language可以选择中文,然后点左边的relunch重启。

![Pasted image 20251129122659](https://sky.nasnas.site/i/2025/11/29/692a884b48708.webp)

2,安装好后选择新建仓库,选好位置,和名字然后创建

![Pasted image 20251129115218](https://sky.nasnas.site/i/2025/11/29/692a884cc1fce.webp)

3,创建完成后,点击设置按钮->第三方插件->关闭安全模式,然后在社区插件市场右边点击浏览,如果能打开的话直接搜索livesync后安装

![Pasted image 20251129115422](https://sky.nasnas.site/i/2025/11/29/692a884e99a62.webp)

![Pasted image 20251129115434](https://sky.nasnas.site/i/2025/11/29/692a885089ecc.webp)

4,如果打不开社区插件市场,关闭Obsidian,然后从github[Releases · vrtmrz/obsidian-livesync](https://github.com/vrtmrz/obsidian-livesync/releases)下载livesync插件,如果下载困难,可以从这里下载,第二地址,这个下载的版本是0.5.25。下载后压缩包解压后放到仓库.obsidian新建一个plugins目录里面,具体目录信息如下

![Pasted image 20251129120411](https://sky.nasnas.site/i/2025/11/29/692a8851f1085.webp)

5,文件放置完毕后打开Obsidian,再点第三方插件可以看到self-hosted livesync,点击开启后弹出一个窗,意思可以显示自己设定的系统语言,点击ok。下一步点击 No, Please teke me back. 因为我们还没有配置couchdb服务器。

![Pasted image 20251129120537](https://sky.nasnas.site/i/2025/11/29/692a8853cb4f8.webp)

![Pasted image 20251129120626](https://sky.nasnas.site/i/2025/11/29/692a88557fdfb.webp)

6,接下来我们创建couchdb服务器。couchdb采用docker的方式运行在服务器上,服务器需要支持公网访问,并且需要https域名访问。

7,首先服务器创建个目录用来保存数据库和配置,比如/home/docker/目录下 mkdir couchdb创建couchdb目录,然后再couchdb目录下创建data和etc目录。然后在etc目录下创建local.ini文件,内容如下:

```

[couchdb]

single_node=true

max_document_size = 50000000

[chttpd]

require_valid_user = true

max_http_request_size = 4294967296

[chttpd_auth]

require_valid_user = true

authentication_redirect = /_utils/session.html

[httpd]

WWW-Authenticate = Basic realm="couchdb"

enable_cors = true

[cors]

origins = app://obsidian.md,capacitor://localhost,http://localhost

credentials = true

headers = accept, authorization, content-type, origin, referer

methods = GET, PUT, POST, HEAD, DELETE

max_age = 3600

```

8,目录和local.ini文件创建好之后,如下命令创建couchdb docker,其中COUCHDB_USER和COUCHDB_PASSWORD对应用户名密码自己设置

```

 docker run --name couchdb \

 -d --restart always \

 -e COUCHDB_USER=admin \

 -e COUCHDB_PASSWORD=mycouch123 \

 -v /home/docker/couchdb/data:/opt/couchdb/data \

 -v /home/docker/couchdb/etc/local.ini:/opt/couchdb/etc/local.ini \

 -p 5984:5984 \

 couchdb

```

9,couchdb创建成功后可以在服务器上curl http://127.0.0.1:5984 一下,返回如下信息代表couchdb装好了

{"error":"unauthorized","reason":"Authentication required."}

10,接着配置反代,可以用nginx caddy什么的,我喜欢用lucky https://lucky666.cn/docs/intro ,lucky web服务创建一个couch的服务

![Pasted image 20251129124509](https://sky.nasnas.site/i/2025/11/29/692a885718554.webp)

11,然后访问`https://couch.ddd.xxx.com/_utils`域名换成自己的,用第8步设置的用户名和密码登录,登陆后是couchdb的主界面,couchdb就创建完成了。

![Pasted image 20251129124752](https://sky.nasnas.site/i/2025/11/29/692a88591a8b6.webp)

12,接下来去配置ob的livesync,打开ob第三方插件self-hosted live sync。然后点击 Rerun Wizard运行向导,整个配置向导没人翻译,都是英文。

![Pasted image 20251129125915](https://sky.nasnas.site/i/2025/11/29/692a885adfa7d.webp)

13,选择Enter the server information manually, 手动输入服务器信息,后点击I know my server details...

![Pasted image 20251129130002](https://sky.nasnas.site/i/2025/11/29/692a885ccbfca.webp)

14,然后设置加密选项,第一个是端到端加密,建议选择,自己设置个密码,千万不要忘了啊;第二个是文件名加密,也可以选上。然后下一步。

![Pasted image 20251129130141](https://sky.nasnas.site/i/2025/11/29/692a885ea3b92.webp)

15,选择CouchDb后下一步进入couchdb设置。

![Pasted image 20251129130223](https://sky.nasnas.site/i/2025/11/29/692a88600cea3.webp)

16,这里是设置couchdb服务器信息,包含地址,用户名,密码。

![Pasted image 20251129130310](https://sky.nasnas.site/i/2025/11/29/692a886182df2.webp)

17,服务器信息设置完后,点击Detect and fix couchdb issues. 如果由错误,点击后面的fix按钮修复。

![Pasted image 20251129130535](https://sky.nasnas.site/i/2025/11/29/692a8862ec3aa.webp)

修复完成再点击Detect and fix按钮,显示All checks passed successfully. 然后点击Test Settings and Continue

![Pasted image 20251129130645](https://sky.nasnas.site/i/2025/11/29/692a88646185e.webp)

然后会弹出警告框,意思是重启后会从服务器拉取所有数据,本地所有数据会被覆盖。点击Restart and Fetch Data重启。

![Pasted image 20251129130844](https://sky.nasnas.site/i/2025/11/29/692a8865f34a5.webp)

18,Ob重启后会弹出一个警告框,意思是如何处理本地和服务器的冲突,请根据自己情况选择,

第一个选项,本地和服务器一致,

第二个选项本地是空的,或者只包含服务器没有的文件

第三个选项本地和服务器有冲突

我选择第二个,然后下面问本地是否做好备份了。这个如果是本地有文件,强烈建议先把OB文件夹复制一份,以免被覆盖。

选择完毕,点击Reset and Resume sync. 开始同步。

19,同步后可能会跳出来一个 Fetch remote configuration failed。应该是因为我的远程是空的,没有配置,选择Skip。

![Pasted image 20251129132301](https://sky.nasnas.site/i/2025/11/29/692a886703e20.webp)

然后会有一些提示的东西,按照说明点击预选的选项就可以了。

![Pasted image 20251129132329](https://sky.nasnas.site/i/2025/11/29/692a886852493.webp)

![Pasted image 20251129132333](https://sky.nasnas.site/i/2025/11/29/692a8869cb23e.webp)

![Pasted image 20251129132400](https://sky.nasnas.site/i/2025/11/29/692a886b567db.webp)

![Pasted image 20251129132404](https://sky.nasnas.site/i/2025/11/29/692a886d36463.webp)

![Pasted image 20251129132409](https://sky.nasnas.site/i/2025/11/29/692a886ecec66.webp)

最后重启后又是一些提示信息,重点说明,一个个月底勾选后继续

![Pasted image 20251129132444](https://sky.nasnas.site/i/2025/11/29/692a8870a00f4.webp)

OB重启后,提示信息

![Pasted image 20251129132505](https://sky.nasnas.site/i/2025/11/29/692a8871ab288.webp)

20,至此,livesync基本就完成了,还剩最后一步,点开livesync的设置,同步方式选择livesycn就ok了。

![Pasted image 20251129133441](https://sky.nasnas.site/i/2025/11/29/692a88734d716.webp)

21,我们随便创建一个文件,然后设置第二台设备。第二台设备类似,也是装好OB后,安装livesync插件,然后配置livesync,因为第一台已经配置好,第二台只需要复制第一台的配置就可以,复制有两个方式,一个是用URI,一个是扫码。配置后提示类似。配置好之后别忘了设置同步模式livesync.

![Pasted image 20251129133643](https://sky.nasnas.site/i/2025/11/29/692a8874d8b2c.webp)

22,两台都配置好之后,就可以测试效果了。