群晖 NAS + OpenClaw + Obsidian 同步配置指南¶

使用 Syncthing 实现实时、安全、自动同步

一、群晖 NAS 端配置¶

1. 安装 Syncthing¶

方法一：套件中心（推荐）¶

打开群晖 套件中心
搜索 Syncthing
点击安装
安装完成后打开

方法二：手动安装¶

下载：https://syncthing.net/downloads/
选择 Linux amd64 版本

通过 SSH 安装到群晖：

# SSH 登录群晖
ssh admin@your-nas-ip

# 创建目录
sudo mkdir -p /usr/local/syncthing
cd /usr/local/syncthing

# 下载并解压
sudo wget https://github.com/syncthing/syncthing/releases/download/v1.27.0/syncthing-linux-amd64-v1.27.0.tar.gz
sudo tar -xzf syncthing-linux-amd64-v1.27.0.tar.gz
sudo mv syncthing-linux-amd64-v1.27.0/* .

# 设置权限
sudo chown -R root:root .
sudo chmod +x syncthing

2. 配置 Syncthing¶

⚠️ 重要：不要使用 /volume1/homes/ 目录！

群晖的 homes 目录是用户主目录，权限受限。必须使用共享文件夹。

打开 Syncthing 管理界面
地址：http://your-nas-ip:8384
默认账号：admin
首次登录需设置密码

创建 Obsidian 文件夹

文件夹路径：/volume1/ObsidianVault/openclaw-workspace  ← 使用共享文件夹！
文件夹标签：OpenClaw Obsidian Vault
共享权限：确保 Syncthing 运行用户有读写权限

获取设备 ID
点击右上角菜单 → 操作 → 显示 ID
记录设备 ID（后续 OpenClaw 端需要）

配置用户权限

# 设置文件夹权限
sudo chown -R admin:users /volume1/ObsidianVault/openclaw-workspace
sudo chmod -R 755 /volume1/ObsidianVault/openclaw-workspace

3. 设置群晖自启动¶

创建启动脚本：

# 编辑启动脚本
sudo vi /usr/local/etc/rc.syncthing.sh

# 添加内容：
#!/bin/bash
case "$1" in
  start)
    /usr/local/syncthing/syncthing -no-browser -home=/volume1/@appstore/syncthing &
    ;;
  stop)
    killall syncthing
    ;;
esac

# 设置权限
sudo chmod +x /usr/local/etc/rc.syncthing.sh

# 添加到自启动
sudo ln -s /usr/local/etc/rc.syncthing.sh /usr/local/etc/rc.local/

二、OpenClaw 端配置¶

1. 安装 Syncthing¶

# 检查系统
cat /etc/os-release

# Debian/Ubuntu 安装
curl -s https://syncthing.net/install-key.sh | sudo bash
sudo apt-get install syncthing

# 或者手动安装
wget https://github.com/syncthing/syncthing/releases/download/v1.27.0/syncthing-linux-amd64-v1.27.0.tar.gz
tar -xzf syncthing-linux-amd64-v1.27.0.tar.gz
cd syncthing-linux-amd64-v1.27.0
sudo cp syncthing /usr/local/bin/

2. 配置 OpenClaw 工作空间同步¶

# 创建 systemd 服务（推荐）
sudo vi /etc/systemd/system/syncthing@.service

# 添加内容：
[Unit]
Description=Syncthing - Open Source File Synchronization
After=network.target

[Service]
User=%i
Group=%i
Type=notify
Environment=STNODEFAULTFOLDER=1
Environment=STNORESTART=1
Environment=STNOUPGRADE=1
ExecStart=/usr/bin/syncthing -no-browser -no-restart -logflags=0
Restart=on-failure
RestartSec=5
SyslogIdentifier=syncthing-%i

[Install]
WantedBy=multi-user.target

# 启动服务（替换为你的用户名）
sudo systemctl daemon-reload
sudo systemctl enable syncthing@root
sudo systemctl start syncthing@root

3. 配置 OpenClaw 工作空间路径¶

# 修改 OpenClaw 配置，将工作空间指向同步目录
# 方案一：直接使用 Syncthing 同步目录
ln -s /root/.openclaw/workspace /volume1/ObsidianVault/openclaw-workspace

# 方案二：修改 OpenClaw 配置
vi ~/.openclaw/config.json
{
  "workspace": {
    "path": "/volume1/ObsidianVault/openclaw-workspace"
  }
}

4. OpenClaw 端 Syncthing 配置¶

打开管理界面
地址：http://localhost:8384
或 http://your-server-ip:8384
添加群晖设备
点击 "添加远程设备"
输入群晖的设备 ID
设备名称：Synology-NAS
地址：tcp://your-nas-ip:22000
共享文件夹
文件夹 ID：obsidian-vault
文件夹路径：/root/.openclaw/workspace
同步模式：Send & Receive（双向同步）
文件版本控制：Simple File Versioning（保留 30 天）
接受群晖的共享请求
群晖会收到共享请求
在群晖 Syncthing 界面点击 "添加"
文件夹路径：/volume1/ObsidianVault/openclaw-workspace

三、Obsidian 客户端配置¶

1. 电脑端 Obsidian¶

Windows/Mac¶

打开 Obsidian
点击 "Open folder as vault"
选择同步目录：
Windows: \\NAS-IP\ObsidianVault\openclaw-workspace
Mac: /Volumes/ObsidianVault/openclaw-workspace

Linux¶

# 挂载 NAS 共享（可选）
sudo mount -t cifs //NAS-IP/ObsidianVault /mnt/obsidian -o username=admin

2. 手机端 Obsidian¶

iOS¶

安装 Syncthing App（Möbius Sync）
添加 NAS 设备
同步 Obsidian 文件夹到本地
Obsidian 打开本地文件夹

Android¶

安装 Syncthing App
或安装 Syncthing-Fork（功能更强）
配置同步
Obsidian 打开同步目录

四、高级配置¶

1. 冲突处理策略¶

在 Syncthing 中配置：

管理界面 → 设置 → 同步
- 冲突解决：修改时间最新的优先
- 文件版本控制：启用（保留 30 天）
- 拉取顺序：最小优先（减少冲突）

2. 忽略文件配置¶

创建 .stignore 文件在同步目录根目录：

# OpenClaw 临时文件
*.tmp
*.cache
.log/

# Obsidian 配置（如不需要同步）
.obsidian/plugins/*/data.json
.obsidian/workspace.json

# 系统文件
.DS_Store
Thumbs.db
@eaDir/

3. 网络优化¶

# 群晖端优化（大文件传输）
sudo vi /volume1/@appstore/syncthing/etc/config.xml

# 添加/修改：
<options>
  <maxSendKbps>0</maxSendKbps>  <!-- 不限速 -->
  <maxRecvKbps>0</maxRecvKbps>
  <progressUpdateIntervalS>5</progressUpdateIntervalS>
</options>

4. 安全加固¶

# 启用 HTTPS
syncthing generate --home=/path/to/config

# 配置防火墙
# 群晖：控制面板 → 安全性 → 防火墙
# 允许端口：8384 (Web), 22000 (同步), 21027 (发现)

# 修改默认端口（可选）
# config.xml 中修改：
<gui>
  <address>127.0.0.1:8384</address>  <!-- 仅本地访问 -->
  <tls>true</tls>
</gui>

五、验证与测试¶

1. 同步测试¶

# 在 OpenClaw 端创建测试文件
echo "# Test Sync" > /root/.openclaw/workspace/test-sync.md

# 等待 30 秒

# 在群晖端检查
ls -la /volume1/ObsidianVault/openclaw-workspace/test-sync.md
cat /volume1/ObsidianVault/openclaw-workspace/test-sync.md

# 应该看到同步的文件

2. 状态检查¶

# Syncthing 状态
syncthing cli db status

# 查看日志
journalctl -u syncthing@root -f

# 或通过 Web 界面查看
# http://localhost:8384

3. OpenClaw 测试¶

# 在群晖创建笔记
echo "# New Note from NAS" > /volume1/ObsidianVault/openclaw-workspace/test-from-nas.md

# 等待同步

# OpenClaw 读取
cat /root/.openclaw/workspace/test-from-nas.md

# 应该能看到新笔记

六、故障排查¶

常见问题¶

问题	解决方案
同步慢	检查网络连接、关闭限速、优化 MTU
冲突频繁	避免同时编辑、启用文件版本控制
连接失败	检查防火墙、确认设备 ID 正确
权限错误	`sudo chown -R user:group /path`
磁盘空间不足	清理旧版本、扩容磁盘

日志查看¶

# Syncthing 日志
tail -f /var/log/syncthing.log

# 或系统日志
journalctl -u syncthing@root -f

# Syncthing 自带日志
# Web 界面 → 操作 → 显示日志

七、自动化脚本¶

备份脚本（群晖端）¶

#!/bin/bash
# /volume1/@scripts/backup-obsidian.sh

DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="/volume1/Backup/Obsidian"
SOURCE_DIR="/volume1/ObsidianVault"

# 创建备份
tar -czf $BACKUP_DIR/obsidian_$DATE.tar.gz $SOURCE_DIR

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

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

添加 Cron 定时任务¶

# 编辑 crontab
crontab -e

# 每天凌晨 3 点备份
0 3 * * * /volume1/@scripts/backup-obsidian.sh >> /var/log/obsidian-backup.log 2>&1

八、性能优化建议¶

1. SSD 缓存（群晖）¶

如果群晖支持 SSD 缓存：

存储管理器 → SSD 缓存 → 添加缓存
选择 ObsidianVault 共享文件夹
模式：读写缓存

2. 网络优化¶

使用有线连接（非 WiFi）
启用 Jumbo Frame（如网络设备支持）
优先使用局域网 IP 同步

3. Syncthing 优化¶

<!-- config.xml -->
<options>
  <scanProgressIntervalS>60</scanProgressIntervalS>
  <pullerPauseMs>100</pullerPauseMs>
  <maxFolderConcurrency>4</maxFolderConcurrency>
</options>

九、替代方案对比¶

方案 B：WebDAV（群晖原生）¶

# 群晖端
1. 套件中心 → 安装 WebDAV Server
2. 启用 WebDAV (端口 5005/5006)
3. 创建共享文件夹 ObsidianVault

# OpenClaw 端
# 挂载为本地目录
sudo apt-get install davfs2
sudo mount -t davfs https://nas-ip:5006/obsidian /mnt/obsidian

优点：群晖原生支持缺点：需手动挂载、冲突处理弱

方案 C：Git 同步¶

# 群晖安装 Git Server
# OpenClaw 端配置 Git 仓库
cd /root/.openclaw/workspace
git init
git remote add origin ssh://user@nas-ip/volume1/git/obsidian.git
git push -u origin master

# 配置自动推送
git config --global alias.autopush '!git add -A && git commit -m "Auto-sync" && git push'

优点：版本控制、可追溯缺点：学习曲线、冲突需手动处理

十、最终建议¶

安全建议¶

启用 HTTPS 访问 Syncthing
修改默认端口
配置防火墙规则
定期备份到外部存储
启用双因素认证（群晖）

监控建议¶

配置 Syncthing 邮件通知
群晖日志中心监控同步状态
定期检查磁盘空间
设置磁盘空间警告（80% 阈值）

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

群晖 NAS + OpenClaw + Obsidian 同步配置指南¶

一、群晖 NAS 端配置¶

1. 安装 Syncthing¶

方法一：套件中心（推荐）¶

方法二：手动安装¶

2. 配置 Syncthing¶

3. 设置群晖自启动¶

二、OpenClaw 端配置¶

1. 安装 Syncthing¶

2. 配置 OpenClaw 工作空间同步¶

3. 配置 OpenClaw 工作空间路径¶

4. OpenClaw 端 Syncthing 配置¶

三、Obsidian 客户端配置¶

1. 电脑端 Obsidian¶

Windows/Mac¶

Linux¶

2. 手机端 Obsidian¶

iOS¶

Android¶

四、高级配置¶

1. 冲突处理策略¶

2. 忽略文件配置¶

3. 网络优化¶

4. 安全加固¶

五、验证与测试¶

1. 同步测试¶

2. 状态检查¶

3. OpenClaw 测试¶

六、故障排查¶

常见问题¶

日志查看¶

七、自动化脚本¶

备份脚本（群晖端）¶

添加 Cron 定时任务¶

八、性能优化建议¶

1. SSD 缓存（群晖）¶

2. 网络优化¶

3. Syncthing 优化¶

九、替代方案对比¶

方案 B：WebDAV（群晖原生）¶

方案 C：Git 同步¶

十、最终建议¶

推荐配置¶

安全建议¶

监控建议¶