cherry studio 中文文档 下载 App

Cherry Studio WebDAV 跨设备备份,桌面移动软同步 + 云端存档

为什么需要跨设备备份

Cherry Studio 的数据默认全部存在本机:对话历史、助手配置、知识库索引、笔记、绘画收藏、MCP 工具设置、Agent 配置……如果只在一台设备上用,数据不会丢;但一旦换设备、重装系统、或者需要桌面↔移动跨端接力,问题就来了——怎么让两边数据不打架?

WebDAV 备份是 Cherry Studio 提供的解决方案——支持 WebDAV 协议的云存储(坚果云、夸克网盘、iCloud Drive 等)或者 S3 兼容存储(阿里云 OSS、MinIO 等)都可以用。

支持的备份方式

方式说明适合场景
WebDAV轻量协议,几乎所有云盘都支持坚果云、夸克网盘、iCloud Drive 等
S3 兼容存储对象存储协议,需要对象存储服务阿里云 OSS、AWS S3、MinIO 自建
本地目录直接备份到另一个本地路径(比如外接硬盘)不需要云端,只做本地备份

怎么配置 WebDAV 备份

设置 → 数据设置 → 备份与恢复 → 添加备份目标 → 选 WebDAV。需要填:

字段说明示例
WebDAV 服务器地址WebDAV 协议 URL坚果云:https://dav.jianguoyun.com/dav/
用户名你的云盘账号用户名坚果云登录邮箱
密码部分平台需要专用密码或授权码坚果云需要生成应用专用密码
备份目录在 WebDAV 服务器上 Cherry Studio 数据存放的子路径/cherry-studio-backup/

配置好后测试一下连接——Cherry Studio 会尝试列出备份目录,如果成功就保存配置。

备份与恢复的时机

时机操作
手动备份设置里点「立即备份」——把当前数据快照推到 WebDAV
定时自动备份设置里勾上自动备份 + 选频率(每天 / 每 N 小时)
手动恢复新设备首次启动时,或想回到某个备份点时,从 WebDAV 拉下来覆盖本地

⚠️ 恢复操作会覆盖当前本地数据。恢复前 Cherry Studio 会弹窗二次确认,不会静默覆盖。

桌面 ↔ 移动软同步

Cherry Studio 没有实时双向同步——因为实时同步在 AI 客户端上容易造成数据冲突(两边同时改同一个助手的配置怎么办?)。推荐的做法是软同步:

  1. 桌面端:每天下班前手动备份一次到 WebDAV
  2. 移动端:早上打开时先恢复一次 WebDAV 备份,同步桌面端最新配置
  3. 移动端改动:在移动端做的配置改动,晚上手动备份一次,第二天桌面端恢复时就能看到

虽然不是实时同步,但成本低、不容易冲突、数据可控。

哪些数据会被备份

数据类型是否默认备份说明
助手配置✅名称、系统提示词、模型绑定
Agent 配置✅人格、挂载的知识库、权限模式
模型服务商✅服务商列表和 API Key(加密存储)
对话历史⚠️默认不备份(体积大),需要手动开启
知识库索引❌不备份(索引可以重新建)
知识库数据源⚠️默认不备份(数据源在本地文件系统)
笔记✅Markdown 文件内容
绘画收藏⚠️默认不备份(图片体积大)
MCP 工具配置✅挂载的 Server 列表和配置
设置✅主题、快捷键、默认模型等

安全提示

API Key 在备份文件里是加密存储的——即使 WebDAV 服务器泄露,别人也看不到明文 Key。但备份文件本身建议用自己的云盘账户,不要存在公共或共享的 WebDAV 空间里。