ComfyPilotComfyPilot
文档 / 安装 / 从 Legacy Desktop 迁移

从 Legacy Desktop 迁移

了解如何将您的 Legacy Desktop 安装迁移到 Comfy Desktop

安装 migrate 更新于 2026-11-09

查看官方原文

从 Legacy Desktop 迁移

了解如何将您的 Legacy Desktop 安装迁移到 Comfy Desktop
[!NOTE] 本页介绍从 Legacy Desktop（旧版单实例桌面应用）迁移到 Comfy Desktop。如果您是首次使用，可以跳过此页。
[card] 正在寻找其他安装方式？ 如果您已经有 ComfyUI 安装（portable、手动 git clone 等）并想将其添加到 Comfy Desktop，请参见实例管理中的“追踪已有安装”。

如果您已经安装了 Legacy Desktop，Comfy Desktop 可以检测到它并进行迁移，在 Chooser 视图中创建一个新的 Standalone 安装。

迁移内容

Legacy Desktop 是单实例应用。Comfy Desktop 是多实例管理器。迁移时：

  • 工作流和设置：就地复用，新实例沿用同一份用户数据。
  • 自定义节点：保留在您现有的 custom_nodes 文件夹中。迁移后的实例以 Legacy Desktop 数据文件夹作为基础目录运行，因此加载的是同一批节点，它们的依赖包也留在被复用的 Python 环境里。
  • 模型：您原有的模型文件夹会被加入共享模型目录，所有实例都能直接读取原位置的文件。
  • 输入文件和输出：就地复用现有目录中的文件。
  • Python 环境：先检查再复用您现有的环境。Comfy Desktop 会确认它能导入 torch，然后把 ComfyUI 自身的依赖安装进去，不会替换您现有的 PyTorch 包。
  • ComfyUI 版本：ComfyUI 源码会被暂存到新的托管目录，之后由 Comfy Desktop 管理更新。

迁移会就地复用您的 Legacy Desktop 数据文件夹和 Python 环境，而不是复制它们，因此您得到的是一个正在使用的环境，而不是第二份副本。如果需要保留一份完整的旧版副本，请在迁移前自行备份。

迁移会备份什么

在改动任何内容之前，Comfy Desktop 会把 Legacy Desktop 的设置文件复制到旧版配置文件夹下按时间命名的目录中：

  • macOS：~/Library/Application Support/ComfyUI/legacy-backup/<timestamp>/
  • Windows：%APPDATA%\ComfyUI\legacy-backup\<timestamp>\

只有实际存在的文件会被复制：

  • config.json：Legacy Desktop 应用设置，包括它使用的数据文件夹。
  • comfy.settings.json：存放在旧版用户文件夹中的 ComfyUI 前端设置。
  • extra_models_config.yaml：您在 Legacy Desktop 中配置的额外模型路径。
  • window.json：保存的窗口大小和位置。

这份备份只包含设置。模型、工作流、自定义节点、输入文件和输出都不会被复制进去，因为迁移后的实例会继续在原位置使用它们。迁移还会把旧版环境的快照（包含其自定义节点和已安装的依赖包）写入旧版数据文件夹下的 .snapshots/。

如果某个文件无法复制，迁移会在日志中记录并继续，因此备份失败不会中断迁移。

迁移运行时会发生什么

迁移会显示独立的进度界面，依次经过以下步骤：

  1. 备份旧版状态
  2. 检查文件夹访问权限（仅 macOS）
  3. 验证 Python 环境
  4. 捕获快照
  5. 分配安装文件夹
  6. 暂存 ComfyUI 源码
  7. 安装需求
  8. 迁移设置
  9. 注册安装

某些步骤会停下来等待您回答：

  • 需要文件夹访问权限（macOS）：macOS 阻止了对 Legacy Desktop 文件夹的访问。请在系统设置 → 隐私与安全性中为 Comfy Desktop 授予完全磁盘访问权限，然后重新开始迁移。
  • Python 环境似乎已损坏：旧版环境无法导入 torch。选择仍然接管以继续使用该环境，或选择取消停止迁移。
  • ComfyUI 源码不可用：无法获取新实例所需的 ComfyUI 源码。选择重试，或选择取消并改为从仪表板创建新实例。

进度界面会把所有步骤的输出保存在查看日志面板中，某一步失败时该面板会自动展开。可以用其中的复制按钮复制文本，同样的输出也会写入 Desktop 应用日志。依赖安装失败只会作为警告记录，不会中断迁移。

迁移后的变化

迁移完成后，您的新 Standalone 安装与其他 Comfy Desktop 安装一样工作：

  • 启动 — 在 Chooser 视图中点击新安装卡片的播放按钮即可启动 ComfyUI。
  • 端口 — 旧版配置中的端口以及其他自定义启动参数会一并继承。
  • 管理 — 使用 Manage 面板更新、创建快照和配置安装。
  • 更新 — Standalone 安装可以通过 Manage 面板独立更新。与 Legacy Desktop 不同，您不再需要为每次更新下载新构建版本。
  • 多实例 — 您可以拥有多个并行的 Standalone 安装，每个都有自己的 ComfyUI 版本和配置。
  • 共享存储 — 模型默认在所有 Standalone 安装之间共享。输入和输出目录固定到被采用的 Legacy 工作区，因此您现有的文件位置不变。

迁移后的实例不会自行更新 ComfyUI。需要新的 ComfyUI 版本时，使用 Manage 面板的更新选项卡。

我的旧链接还能用吗？

Legacy Desktop 默认在端口 8000 上运行。新安装会继承端口设置，因此 http://localhost:8000 应该仍然可用。如果您配置过自定义 CLI 参数（例如 --port 8188），这些参数也会一并继承。

如果您使用了 URL 缩短器、书签或引用 Legacy Desktop 应用的其他地址的外部集成，您可能需要检查新安装的 Startup Args 选项卡并相应更新。

分步迁移

1. 安装 Comfy Desktop

从官方下载页面下载并安装 Comfy Desktop。

2. 启动 Comfy Desktop

首次打开 Comfy Desktop 时，首次运行设置会自动检测系统中的 Legacy Desktop 安装。选择本地后，设置中会显示迁移现有实例并默认选中，继续后即可迁移您现有的环境。

首次运行设置中选择本地，并勾选迁移现有实例

3. 确认迁移

点击继续，然后在确认对话框中选择开始迁移。Comfy Desktop 将：

  1. 就地复用您的工作流、设置、自定义节点、输入文件和输出
  2. 复用您的 Python 环境，并把 ComfyUI 源码暂存到新的托管目录，以便更新正常工作
  3. 将模型文件夹添加为共享目录，并把 ComfyUI 的依赖安装到被复用的环境中

完成后，新的 Standalone 安装卡片会出现在 Chooser 视图中。

4. 验证

启动新安装并确认：

  • 您的工作流可用
  • 自定义节点已安装
  • 模型可访问
  • 您的服务器在继承的 URL 上运行（默认为 http://localhost:8000）

从 Chooser 中迁移

如果您已经完成首次运行设置，或 Legacy Desktop 安装已出现在 Chooser 中，可以直接从实例卡片发起迁移：

  1. 找到 Legacy Desktop 实例卡片，卡片上带有迁移胶囊按钮。

Chooser 中带有 Migrate 胶囊按钮的 Legacy Desktop 实例卡片

  1. 点击该胶囊按钮，或打开卡片的 ⋮ 菜单并选择迁移到独立版。

实例卡片菜单中的 Migrate to Standalone

  1. 确认弹窗中的改动后，点击开始迁移。

Migrate Legacy Desktop to Standalone 确认弹窗，右下角为 Start Migration 按钮

Legacy Desktop 安装会被就地接管，出现在 Chooser 中的实例就是您现有环境在 Comfy Desktop 下的托管版本。已跟踪的 Git 和 portable 实例则不同，迁移会新建一个 Standalone 安装，原跟踪安装保持原样。

待更新状态优先：这类卡片会显示更新胶囊按钮，而不是迁移。

故障排查

Legacy Desktop 未自动检测到

Legacy Desktop 源仅用于迁移，不会出现在新建实例选择器中，因此无法手动添加。如果 Comfy Desktop 没有检测到您的 Legacy Desktop 安装：

  1. 将该安装作为已跟踪实例添加。参见 追踪已有安装。
  2. 实例出现在 Chooser 后，通过卡片上的迁移胶囊按钮或 ⋮ 菜单中的迁移到独立版进行迁移。

迁移失败

  • 查看日志：在迁移界面选择查看日志，或打开 Desktop 应用日志（app.log）：macOS 位于 ~/Library/Logs/Comfy Desktop，Windows 位于 %APPDATA%\Comfy Desktop\logs。
  • 检查 Legacy 安装是否完整：迁移会从现有文件夹读取模型、工作流和自定义节点，文件夹被移动或删除会导致迁移中断。
  • 重试：网络问题可能让源码暂存步骤失败，第二次尝试可能会成功。

迁移中途停止

在任一提示中选择取消会停止本次迁移，某一步直接失败也会如此（依赖安装的警告不算）。停止的迁移不会向 Chooser 添加实例，请从卡片上的迁移胶囊按钮重新发起。您的 Legacy Desktop 文件夹不会被删除。

迁移后模型丢失

模型是加入共享模型目录，而不是复制。如果模型没有显示：

  1. 打开 桌面设置 → 存储
  2. 确认旧模型文件夹以及 Legacy Desktop extra_models_config.yaml 中列出的额外模型路径都已加入共享目录。如果有缺失，选择 + 添加共享目录 并选中它。
  3. 在迁移后实例的 Manage 面板中打开存储标签页，确认包含共享目录已开启。