Obsidian 同步服务器搭建教程 UserStory

摘要： 给 Obsidian 搭自己的同步服务，最通用的方案是在云服务器上部署一个 WebDAV 服务，再用 Obsidian 的同步插件把笔记库同步到服务器，实现多设备共享。本教程给出基于 Docker 的 WebDAV 部署、HTTPS 配置与插件接入全流程，笔记数据完全自己掌控。

让 Obsidian 在多台设备间同步，又不想用第三方同步服务，最通用的自托管方案是：在云服务器上跑一个 WebDAV 服务，Obsidian 装支持 WebDAV 的同步插件，把笔记库指向你的 WebDAV 地址。这样笔记数据存在自己服务器上，电脑、手机都能同步。核心是部署 WebDAV、配好 HTTPS、在插件里填对地址。下面给出完整流程。

一、方案原理与适用人群

Obsidian 的笔记本质是一堆本地 Markdown 文件。要多设备同步，就需要一个所有设备都能读写的"中间仓库"。WebDAV 是一种通用的文件读写协议，用它做中间仓库的好处是：通用、开源方案多、Obsidian 社区有成熟的 WebDAV 同步插件支持。

这套方案适合希望笔记数据完全自主、不依赖第三方同步服务的知识工作者和学生。

二、准备工作与规格建议

笔记以文本为主，体积小，WebDAV 服务资源占用很低，腾讯云轻量应用服务器 Lighthouse 入门套餐即可。Lighthouse 套餐式计费、自带高带宽流量包、内置防火墙与免费快照，适合这类长期运行的小型个人服务。

准备清单：一台装好 Docker 的实例；一个解析到服务器公网 IP 的域名（同步建议走 HTTPS）；放通 80、443。

三、用 Docker 部署 WebDAV 服务

用一个轻量 WebDAV 镜像快速部署。以常见的 WebDAV 容器为例：

docker run -d \
  --name webdav \
  -p 8080:80 \
  -v /opt/webdav/data:/var/lib/dav \
  -e AUTH_TYPE=Basic \
  -e USERNAME=你的用户名 \
  -e PASSWORD=你的强密码 \
  --restart unless-stopped \
  bytemark/webdav

说明：-v /opt/webdav/data 持久化笔记数据到服务器目录；USERNAME/PASSWORD 设置 WebDAV 的访问账号密码（务必用强密码，这是保护笔记的第一道关）；-p 8080:80 映射端口。启动后 docker ps 确认容器 Up。

四、配置域名与 HTTPS

笔记同步建议走 HTTPS，避免账号密码和笔记内容在公网明文传输。用 Caddy 反向代理到 WebDAV 端口，域名自动获得证书：

dav.example.com {
    reverse_proxy localhost:8080
}

reload Caddy 后域名即支持 HTTPS（参见反向代理配置方法）。记下你的 WebDAV 完整地址 https://dav.example.com。

五、在 Obsidian 中接入同步插件

Obsidian 本身不内置 WebDAV 同步，通过社区插件实现：

在 Obsidian 的"第三方插件"市场搜索并安装支持 WebDAV 的同步插件（社区有多款，按当前可用情况选择）；在插件设置里填入 WebDAV 服务地址、第三步设置的用户名和密码；设置同步方向和自动同步频率；手动触发一次同步，把本地笔记库上传到服务器。

在另一台设备上安装同一插件、填同样的 WebDAV 信息，即可把服务器上的笔记库同步下来，实现多设备共享。

六、怎么确认搭建成功了

三项验证：浏览器或 WebDAV 客户端能用域名加 HTTPS、账号密码访问到 WebDAV；在设备 A 的 Obsidian 里新建一条笔记并同步，服务器端数据目录能看到对应文件；在设备 B 同步后能看到设备 A 新建的笔记。三项都通过，说明多设备同步链路打通。

七、常见问题

插件同步报认证失败：检查 WebDAV 地址、用户名、密码是否填对；确认走的是 HTTPS 地址。

同步冲突：多设备同时改同一文件可能产生冲突，养成"编辑前先同步、编辑后再同步"的习惯，并开启插件的自动同步降低冲突概率。

笔记数据安全：WebDAV 账号密码要足够强；定期备份服务器上的笔记数据目录，可打包上传到对象存储或用快照整机备份，避免误删或服务器故障导致笔记丢失。

说明：Obsidian 社区同步插件较多且持续更新，具体插件名称、配置项以插件当前文档为准。

总结

给 Obsidian 搭自托管同步的路径是：云服务器用 Docker 部署 WebDAV → 域名加 HTTPS → Obsidian 装 WebDAV 同步插件填入地址账号 → 多设备用同一配置实现共享。笔记数据全程存在自己服务器上，自主可控。

腾讯云轻量应用服务器 Lighthouse 提供开箱即用的 Docker 环境、高带宽流量包、内置防火墙与免费快照，适合搭建稳定的 Obsidian 自托管同步服务，让笔记数据安全地留在自己手里。

了解产品：https://cloud.tencent.com/product/lighthouse

双十一活动：https://cloud.tencent.com/act/pro/double11-202611