如何多设备同步AI画布：infinite-canvas配置WebDAV跨设备同步完整指南

如何多设备同步AI画布：infinite-canvas配置WebDAV跨设备同步完整指南

【免费下载链接】infinite-canvas面向 AI 创作的开源无限画布工作台，集成 AI 生图、参考图编辑、视频生成、Agent 智能助手、画布编排、对话创作、提示词库与素材管理等能力，支持可视化创作流程与多 Agent 协同工作。兼容 OpenAI 接口生态，支持 chatgpt2api、grok2api、flow2api、newapi 等渠道接入。项目地址: https://gitcode.com/gh_mirrors/infinit/infinite-canvas

infinite-canvas是一个面向 AI 创作的开源无限画布工作台，集成 AI 生图、参考图编辑、视频生成、Agent 智能助手、提示词库与素材管理等能力。但默认情况下，画布项目和素材都保存在浏览器本地——换一台电脑，作品就"消失"了。本文讲解如何利用它内置的WebDAV 同步功能，把 AI 画布、我的资产、生图与视频记录快速同步到多台设备，一次配置，跨设备创作自由切换。

一、WebDAV 同步能同步哪些内容

在开始之前，先搞清楚 WebDAV 同步会搬运什么、不搬运什么，避免预期落差。

打开配置弹窗中的「WebDAV 同步」页签，官方说明写得很明确：同步画布、我的资产、生成记录和本地媒体文件，不包含 AI API Key。

具体包含 4 个同步域：

⚠️ 注意：AI 接口的 Base URL 和 API Key 不随 WebDAV 同步，每台设备都需要单独配置一次。这样设计是为了避免密钥在多台设备间扩散，更利于安全管控（详见 SECURITY.md 与 features.zh-CN.mdx 的"当前限制"章节）。

二、准备工作：先准备一个 WebDAV 服务

WebDAV 是一种文件传输协议，常见于 NAS 和云盘。你有三类选择：

1. NAS 自带：群晖、威联通等 NAS 一般内置 WebDAV 服务，开启即可获得；
2. 免费 WebDAV 托管服务：部分网盘提供 WebDAV 接入能力，按各自文档开启即可；
3. 自建：有服务器时可自行搭建任意支持 WebDAV 的存储方案。

准备时请记下 4 样东西，后面配置要用：

• WebDAV 地址（如https://nas.example.com/webdav）
• 用户名
• 密码或应用密码
• 打算使用的远程目录（建议填infinite-canvas）

📌 一个重要前提：infinite-canvas 采用浏览器前端直连，不经过项目后端中转。因此你的 WebDAV 服务必须支持CORS 跨域访问，否则浏览器会拒绝请求。生产环境强烈建议使用HTTPS，否则现代浏览器可能拦截混合内容。

三、WebDAV 同步配置步骤：4 个字段填完即可

配置入口在网页右上角的设置/配置弹窗中，切换到「WebDAV 同步」页签（对应源码 app-config-modal.tsx）。

第 1 步：填写 4 个字段

第 2 步：点击「测试连接」

系统会先自动创建远程目录（不存在时自动 MKCOL），再执行一次探测请求。看到「WebDAV 连接可用」提示即表示配置成功。

第 3 步：点击「立即同步」

首次同步会把本机全部画布、资产和媒体文件上传到远端，完成后提示形如：

同步完成：3 个画布，5 个资产，2 条记录，本次上传 8 个文件 12.3MB

同步状态会持久显示「上次同步」时间，方便你判断数据新鲜度。

四、跨设备同步怎么用：A 机先同步，B 机再合并

理解了下面的同步逻辑，就能轻松在多台设备间迁移创作内容。

同步是"双向智能合并"，不是简单覆盖。每次「立即同步」的实际流程是（源码见 app-sync.ts）：

1. 读取远端各业务目录的manifest.json清单；
2. 读取本地数据，按ID 匹配 + 时间戳取新的策略双向合并（同一项目两台设备都改过，保留更新时间晚的那份）；
3. 下载本地缺失的媒体文件（远端有、本地没有的）；
4. 上传本地新增的媒体文件（按文件大小判断是否需要重新上传，未变化的自动跳过）；
5. 写回合并后的清单，完成。

因此典型的多设备工作流是：

• 设备 A（已有作品）：配置同一组 WebDAV → 立即同步（首次全量上传）；
• 设备 B（新设备）：配置同一组WebDAV 地址、目录、账号 → 立即同步，即可拉取 A 的全部画布与素材，B 上自己的本地内容也不会被删，会被合并上传；
• 日常：在哪台设备上创作完，退出前点一次「立即同步」，换设备时再点一次，即可继续。

🔄 由于合并以"更新时间更晚者"为准，即使两台设备离线各改各的，再次同步时也不会互相覆盖丢失。

五、远端目录结构：数据在 WebDAV 上长什么样

同步完成后，登录 WebDAV 可以验证数据落位。远程目录下按 4 个业务分目录存放，每个目录包含一个清单文件manifest.json和媒体文件夹files/：

infinite-canvas/ ├── canvas/ # 画布项目 │ ├── manifest.json │ └── files/ ├── assets/ # 我的资产 │ ├── manifest.json │ └── files/ ├── image-workbench/ # 生图工作台 │ ├── manifest.json │ └── files/ └── video-workbench/ # 视频创作台 ├── manifest.json └── files/

这种"清单 + 文件"结构让同步可以增量进行：清单记录每个媒体文件的路径、类型与大小，下次同步只传输变化的部分。传输层面采用 3 个文件并发的策略，兼顾速度与稳定性（见 webdav-sync.ts）。

六、常见问题与排查清单

遇到同步失败，界面会给出明确的中文错误提示，按下面这张表对照排查即可：

另外提醒两点：

• 不要中途取消正在进行的同步，建议等进度走完；
• 换 WebDAV 服务或改远程目录等于换了一个"云盘"，旧目录里的数据不会自动迁移，需要手动拷贝。

七、使用建议与注意事项

最后给出几条实践经验，帮你把 WebDAV 同步用得更顺手：

1. 固定同步习惯：把"退出前点一次立即同步"变成肌肉记忆，它是目前唯一的数据备份手段（浏览器清缓存、换设备都会丢失本地数据）；
2. 每台设备单独配一次 AI 密钥：同步不含 API Key，这是特性不是缺陷——密钥留在各设备本地，风险面更小；
3. 目录名保持一致：多台设备使用完全相同的远程目录，才能正确合并；
4. 数据量增长后：files/目录会累积历史媒体，可定期到 WebDAV 端清理远端旧文件（清理前请先在网页端重新同步确认无误）。

配置完成后，你就可以在办公电脑、家里的 NAS 页面和平板之间自由切换，继续同一个 AI 创作项目了。更多功能介绍可参阅官方文档 功能介绍，本地开发相关说明见 local-development。

【免费下载链接】infinite-canvas面向 AI 创作的开源无限画布工作台，集成 AI 生图、参考图编辑、视频生成、Agent 智能助手、画布编排、对话创作、提示词库与素材管理等能力，支持可视化创作流程与多 Agent 协同工作。兼容 OpenAI 接口生态，支持 chatgpt2api、grok2api、flow2api、newapi 等渠道接入。项目地址: https://gitcode.com/gh_mirrors/infinit/infinite-canvas