WebDAV 配置指南 - 群晖 Obsidian 同步¶

使用 WebDAV 将 OpenClaw 工作空间挂载到群晖 NAS

一、群晖端配置¶

1. 安装 WebDAV Server¶

打开「套件中心」
搜索 WebDAV Server
点击安装
启动应用

2. 配置 WebDAV¶

控制面板 → WebDAV Server

☑ 启用 WebDAV 协议
   HTTP 端口：5005
☑ 启用 HTTPS 协议（推荐）
   HTTPS 端口：5006

3. 创建共享文件夹¶

控制面板 → 共享文件夹 → 新增

名称：ObsidianVault
描述：OpenClaw Obsidian 同步仓库

权限设置： | 用户 | 权限 | |------|------| | admin | 读写 ✓ | | Chaochingchien | 读写 ✓ | | 其他用户 | 禁止 |

二、OpenClaw 端配置¶

1. 安装 davfs2¶

sudo apt-get update
sudo apt-get install davfs2

安装过程中会提示配置，选择「是」。

2. 创建挂载点¶

sudo mkdir -p /mnt/obsidian

3. 配置认证凭据¶

编辑 secrets 文件：

sudo vi /etc/davfs2/secrets

添加以下内容：

# 格式：WebDAV URL  用户名  密码
https://你的NAS-IP:5006/ObsidianVault  Chaochingchien  你的密码

设置安全权限：

sudo chmod 600 /etc/davfs2/secrets

4. 挂载 WebDAV¶

# 手动挂载
sudo mount -t davfs https://你的NAS-IP:5006/ObsidianVault /mnt/obsidian

# 验证
ls -la /mnt/obsidian/

5. 创建 OpenClaw 工作空间目录¶

# 在 WebDAV 挂载点创建工作目录
mkdir -p /mnt/obsidian/openclaw-workspace

# 验证
ls -la /mnt/obsidian/openclaw-workspace/

6. 链接到 OpenClaw¶

# 备份原有工作空间（如果有重要数据）
sudo mv /root/.openclaw/workspace /root/.openclaw/workspace.backup

# 创建符号链接
sudo ln -s /mnt/obsidian/openclaw-workspace /root/.openclaw/workspace

# 验证链接
ls -la /root/.openclaw/
# 应该看到：workspace -> /mnt/obsidian/openclaw-workspace

三、开机自动挂载¶

方法一：使用 fstab（推荐）¶

# 编辑 fstab
sudo vi /etc/fstab

# 添加这行：
https://你的NAS-IP:5006/ObsidianVault  /mnt/obsidian  davfs  _netdev,auto,user  0  0

参数说明： - _netdev - 等待网络启动后再挂载 - auto - 开机自动挂载 - user - 允许普通用户挂载

方法二：使用 systemd（更可靠）¶

# 创建 systemd 服务
sudo vi /etc/systemd/system/obsidian-webdav.service

[Unit]
Description=Mount Obsidian WebDAV
After=network-online.target
Wants=network-online.target

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/bin/mount -t davfs https://你的NAS-IP:5006/ObsidianVault /mnt/obsidian
ExecStop=/bin/umount /mnt/obsidian

[Install]
WantedBy=multi-user.target

# 启用服务
sudo systemctl daemon-reload
sudo systemctl enable obsidian-webdav.service
sudo systemctl start obsidian-webdav.service

# 检查状态
systemctl status obsidian-webdav.service

四、测试验证¶

1. 测试挂载¶

# 查看挂载状态
mount | grep obsidian
df -h | grep obsidian

# 应该看到：
# https://192.168.x.x:5006/ObsidianVault on /mnt/obsidian type davfs (rw,...)

2. 测试读写¶

# 创建测试文件
echo "# WebDAV Test" > /mnt/obsidian/openclaw-workspace/test-webdav.md

# 在群晖端验证
# 打开群晖 File Station → ObsidianVault → 应该看到 test-webdav.md

3. 测试 OpenClaw¶

# OpenClaw 应该能正常读写
echo "# OpenClaw Test" > /root/.openclaw/workspace/test-openclaw.md

# 验证
cat /root/.openclaw/workspace/test-openclaw.md
cat /mnt/obsidian/openclaw-workspace/test-openclaw.md

# 两个路径应该看到相同内容

五、故障排查¶

常见问题¶

问题	解决方案
挂载失败：Connection refused	检查 WebDAV 服务是否启动、防火墙端口
认证失败	检查用户名密码、secrets 文件格式
权限拒绝	检查群晖共享文件夹权限
开机挂载失败	添加 _netdev 参数、使用 systemd

查看日志¶

# 系统日志
journalctl -xe | grep davfs

# 挂载日志
dmesg | tail -50

测试连接¶

# 测试 WebDAV 连接
curl -k -u Chaochingchien https://你的NAS-IP:5006/ObsidianVault/

# 应该返回文件夹列表

六、性能优化¶

1. 调整缓存大小¶

# 编辑 davfs2 配置
sudo vi /etc/davfs2/davfs2.conf

# 调整以下参数：
file_cache_size 100000
conn_cache_size 5
keep_loaded_max 10000

2. 启用压缩（如果群晖支持）¶

# 挂载时添加选项
sudo mount -t davfs -o use_compression https://你的NAS-IP:5006/ObsidianVault /mnt/obsidian

3. 网络优化¶

# 确保使用有线网络（非 WiFi）
# 如果是千兆局域网，速度应该很快

七、Obsidian 配置¶

1. 电脑端 Obsidian¶

1. 打开 Obsidian

2. Open folder as vault

3. 选择路径：
   - Windows: \\你的NAS-IP\ObsidianVault\openclaw-workspace
   - Mac: 先挂载 SMB，然后选择挂载点
   - Linux: /mnt/obsidian/openclaw-workspace

2. 手机端 Obsidian¶

Android:

1. 安装 FolderSync 或 WebDAV 客户端
2. 配置 WebDAV 连接到群晖
3. 同步到本地文件夹
4. Obsidian 打开本地文件夹

iOS:

1. 使用 文件 App 连接 WebDAV 服务器
2. 地址：https://你的NAS-IP:5006/ObsidianVault
3. 用户名/密码登录
4. Obsidian 可以访问 iCloud Drive 中的同步文件

八、备份策略¶

群晖端自动备份¶

1. 群晖 Hyper Backup（套件中心安装）

2. 创建备份任务：
   - 源：ObsidianVault
   - 目标：外部硬盘/另一台 NAS/云存储
   - 计划：每天凌晨 3 点
   - 版本：保留 30 天

本地备份脚本¶

#!/bin/bash
# /root/scripts/backup-obsidian.sh

DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="/root/backups/obsidian"

mkdir -p $BACKUP_DIR

# 备份 WebDAV 内容
tar -czf $BACKUP_DIR/obsidian_$DATE.tar.gz /mnt/obsidian/openclaw-workspace/

# 保留最近 7 天备份
find $BACKUP_DIR -name "obsidian_*.tar.gz" -mtime +7 -delete

echo "Backup completed: obsidian_$DATE.tar.gz"

# 添加定时任务（每天凌晨 2 点）
crontab -e
0 2 * * * /root/scripts/backup-obsidian.sh

九、安全建议¶

1. 启用 HTTPS¶

群晖 WebDAV Server → 启用 HTTPS
证书：Let's Encrypt（免费）

2. 配置防火墙¶

群晖控制面板 → 安全性 → 防火墙

允许：
- 5006 (WebDAV HTTPS) - 仅信任 IP
- 22 (SSH) - 仅信任 IP

3. 使用强密码¶

# 定期修改群晖用户密码
# 更新 /etc/davfs2/secrets 中的密码

4. 限制访问 IP¶

群晖 WebDAV Server → 允许来自以下 IP 的连接
添加信任的 IP 地址

十、快速命令参考¶

# 挂载
sudo mount -t davfs https://NAS-IP:5006/ObsidianVault /mnt/obsidian

# 卸载
sudo umount /mnt/obsidian

# 检查挂载状态
mount | grep obsidian
df -h | grep obsidian

# 测试连接
curl -k -u 用户名 https://NAS-IP:5006/ObsidianVault/

# 查看日志
journalctl -xe | grep davfs

配置完成时间：2026-03-09
适用：群晖 DSM 7.x + OpenClaw + WebDAV