不花一分钱,用群晖搭建Obsidian私有云同步(含Android避坑指南)

type

Post

status

Published

date

Feb 26, 2026

slug

obsidian-sync-cloudflare

summary

为什么我选择了这套方案？

在说具体步骤之前，先聊聊为什么最后选了“群晖 NAS + Alist + Cloudflare Tunnel”这个组合。

群晖自带 WebDAV 为什么不行？

很多人第一反应是用群晖自带的 WebDAV Server，我也试过。

结果呢？

连上去之后，Obsidian 显示“空文件夹”。明明文件就在那儿，就是读不出来。

查了半天才知道，是群晖底层的 ACL 权限和 http 用户组权限在打架。我反正是权限、账号啥的都设置对了都搞不定，卡了好久。

太麻烦了。

后来问了问gemini，试了下用 Docker 跑一个 Alist，直接绕过群晖的权限系统，问题瞬间解决。而且 Alist 自带网页管理界面，出了问题一眼就能看出来，比命令行友好太多。

为什么要用 Cloudflare Tunnel?

因为我家宽带没有公网 IP。

以前折腾过 DDNS + 端口转发，但三天两头掉线，还得担心安全问题。

Cloudflare Tunnel 就不一样了，它是从 NAS 主动往外连的，不需要在路由器上开任何端口。而且自动给你套上 HTTPS，连 SSL 证书都不用管。

最关键的是，免费。

数据在自己手里，这点最重要

说到底，笔记是很私密的东西。

工作计划、读书笔记、日记、灵感……这些东西放在别人的服务器上，总觉得不踏实。

用自己的 NAS，数据完全掌控在自己手里，想怎么折腾就怎么折腾，这种感觉才安心。

第一步：在群晖上跑起 Alist

Alist 是个轻量级的文件列表程序，支持 WebDAV 协议，正好适合我们的需求。

1. 用 Docker 一键部署

SSH 登录群晖，切换到 root 用户，然后复制下面这段命令：

注意： /volume1/obsidian 是你笔记存放的位置，根据实际情况改。

敲回车，等个几秒钟，容器就跑起来了。

2. 拿到初始密码

运行这条命令：

在输出的一堆日志里，找到这样一行：

把密码复制下来。

3. 登录 Alist 改密码

浏览器打开 http://你的群晖 IP:5244，用 admin 和刚才的密码登录。

进去之后，点左上角的头像，选“个人资料”，把密码改成一个好记的。

千万别忘了这个密码，后面要用。

4. 把笔记文件夹挂载进去

在 Alist 后台，点左边的“存储” → “添加”:

驱动：选“本机存储”

挂载路径：填/notes（这个路径等会儿要用）

根文件夹路径：填/ob_data（对应 Docker 里映射的路径）

点“添加”，状态显示“正常”就 OK 了。

现在 Alist 已经能读取你的笔记文件了，可以在网页上看到所有的 Markdown 文件。

第二步：用 Cloudflare 打通外网访问

Alist 跑起来了，但现在只能在家里的局域网访问。出门在外怎么办？

这就要用到 Cloudflare Tunnel 了。

1. 在群晖上跑 Cloudflared 客户端

打开群晖的 Container Manager（就是 Docker 管理界面），下载 cloudflare/cloudflared: latest 镜像。

创建容器的时候，在“执行命令”那一栏填：

Token 哪里来？

去 Cloudflare Zero Trust 控制台，创建一个 Tunnel，会给你一个专属 Token。

网络模式选 host，勾上“自动重新启动”，然后启动容器。

2. 绑定域名

回到 Cloudflare Zero Trust 控制台，进入“Networks” → “Tunnels”。

确认隧道状态是 Healthy（绿色的），然后点“Public Hostname”添加规则：

Subdomain: 填个前缀，比如 ob

Domain: 选你托管在 Cloudflare 的域名

Service: 选 HTTP，填 192.168.x.x:5244（你的群晖内网 IP）

保存之后，用手机流量访问 https://ob.你的域名.com，能看到 Alist 登录页，就说明穿透成功了！

这一步很关键，一定要测试一下。

第三步：电脑端配置 Obsidian

现在服务端已经搞定了，该配置客户端了。

1. 安装 Remotely Save 插件

打开 Obsidian，进入“设置” → “第三方插件” → “浏览”。

搜索 Remotely Save，安装并启用。

2. 填配置信息

在插件设置里：

服务类型：选 WebDAV

服务器地址：填 https://ob.你的域名.com/dav/notes

注意这个地址！

/dav 是 Alist 的 WebDAV 协议路径，必须加。

/notes 是我们之前在 Alist 里设置的挂载路径。

用户名： admin

密码：你在 Alist 里改的那个密码

填完之后，点“检查”，提示成功就 OK 了。

3. 开启自动同步

为了省心，建议开启这两个选项：

启动后运行：每次打开 Obsidian 自动同步

每隔 N 分钟自动运行：我设的是 10 分钟

这样基本就不用手动点同步了。

第四步：Android 手机初始化（重点！）

Android 端是最容易出问题的地方，很多人卡在这一步。

问题在哪儿？

Obsidian 移动端有个“先有鸡还是先有蛋”的设定：

你得先打开一个仓库，才能进设置装插件。

但没有插件，你又没法把远端的笔记拉下来。

怎么破？

答案是：先建一个空仓库，用来“装”远端同步下来的文件。

1. 创建空仓库

打开 Android 上的 Obsidian，选“创建新仓库”。

仓库名称一定要和电脑上的一样！

比如电脑上叫 obsidian，手机上也叫 obsidian。

位置选默认的 Documents 就行，点创建。

2. 装插件

进入设置 → 第三方插件 → 关闭安全模式。

搜索 Remotely Save，安装并启用。

3. 填配置

和电脑端一样，填 WebDAV 配置：

服务器地址：https://ob.你的域名.com/dav/notes

用户名：admin

密码：你的 Alist 密码

点“检查”，通过就行。

4. 第一次同步

回到主界面，从右边缘往左滑，呼出侧边栏。

点 Remotely Save 的同步图标（两个圆圈箭头）。

这时候手机会发现本地是空的，远端有一堆笔记，于是开始全量下载。

盯着屏幕，等它同步完。

5. 重启 Obsidian（别忘了这步！）

同步完之后，一定要把 Obsidian 彻底关掉，然后重新打开。

为什么？

因为 Remotely Save 不光同步了。md 文件，还把。obsidian 配置文件夹也同步下来了。这个文件夹里装着你的主题、插件、快捷键设置……

重启之后，手机端的界面会变得和电脑上一模一样，包括主题颜色、字体大小、其他插件，全都同步过来了。

这种感觉，爽！

第五步：解决 Android 同步报错（血泪教训）

如果你在 Android 端同步时遇到 FILE_NOTCREATED 错误，别慌，我也遇到过。

问题出在哪儿？

看报错信息，通常是某几个特定文件创建失败。

仔细看文件名，你会发现它们都有一个共同点：包含英文的双引号"或冒号：。

比如：

这一回，我们不谈“少吃多动”。md

用“system”来定义.md

Cot 链式思考：使用 think.md

为什么 Mac 能用，Android 不行？

因为 Mac 和 Linux 对文件名很宽容，允许你用"和：。

但 Android 和 Windows 不行！

它们的文件系统禁止使用这 9 个字符：

当 Remotely Save 试图把这些文件下载到 Android 手机时，系统直接拒绝，插件只能报错。

怎么解决？

回到电脑上，把这些文件重命名：

英文双引号" → 改成中文双引号""

英文冒号： → 改成中文冒号：或短横线

改完之后，电脑端同步一次，把干净的文件名推送到 NAS。

然后手机端再同步，就不会报错了。

文件太多怎么办？

如果有几十上百个文件要改，手动改太累了。

用这个脚本批量修复：

在 Mac 或 Linux 终端里运行，Windows 用 Git Bash.

脚本会自动找出所有包含：或"的 Markdown 文件，删掉双引号，把冒号换成短横线。

跑完之后，Obsidian 里同步一次，手机端就能正常下载了。

测试一下，确认同步成功

所有设备都配置好之后，做个简单测试：

在电脑上新建一个笔记，随便写几个字，比如同步测试.md

点手动同步按钮

打开浏览器，访问 Alist 后台或群晖 File Station

看看能不能立刻看到这个新文件

如果能看到，恭喜你，整条链路打通了！

然后在手机上同步一次，看看能不能看到这个笔记。

如果也能看到，那就彻底成功了。

写在最后

这套方案现在用得挺顺手的，Mac 写工作笔记，iPhone 记灵感，Android 手机看读书笔记，完全无缝切换。

数据在自己手里，不用担心隐私泄露，不用担心服务商跑路。

如果你也想搭建自己的 Obsidian 同步方案，希望这篇文章能帮到你。