> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 从 Legacy Desktop 迁移

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

<Info>
  本页介绍从 **Legacy Desktop**（旧版单实例桌面应用）迁移到 Comfy Desktop。如果您是首次使用，可以跳过此页。
</Info>

<CardGroup cols={1}>
  <Card title="正在寻找其他安装方式？" icon="compass" href="/zh/installation/desktop/usage/instance-management#tracking-an-existing-installation">
    如果您已经有 ComfyUI 安装（portable、手动 git clone 等）并想将其添加到 Comfy Desktop，请参见**实例管理中的“追踪已有安装”**。
  </Card>
</CardGroup>

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

## 迁移内容

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

* **工作流和设置** — 复制到新的 Standalone 安装
* **自定义节点** — 扫描后在新环境中重新安装
* **模型** — 您原有的模型文件夹被添加为共享目录（文件保留在原位置）
* **输入文件和输出** — 复制到新安装的共享目录
* **Python 环境** — 创建全新的 Python 环境（Legacy 自带的 Python 不会被重复使用）
* **ComfyUI 版本** — 新 Standalone 中安装最新版本

Legacy Desktop 安装本身在迁移过程中**不会被修改**。它保留在您的系统中作为备份。

## 迁移后的变化

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

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

## 我的旧链接还能用吗？

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

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

## 分步迁移

<Steps>
  <Step title="安装 Comfy Desktop">
    从[官方下载页面](https://comfy.org/download)下载并安装 Comfy Desktop。
  </Step>

  <Step title="启动 Comfy Desktop">
    首次打开 Comfy Desktop 时，它会自动检测您系统中的 Legacy Desktop 安装并显示迁移提示。
  </Step>

  <Step title="确认迁移">
    点击 **Migrate Now** 继续。Comfy Desktop 将：

    1. 扫描现有安装（自定义节点、模型、工作流）
    2. 创建新的 Standalone 安装，包含全新的 Python 环境和最新 ComfyUI
    3. 复制用户数据（工作流、设置等）
    4. 复制输入文件和输出
    5. 将模型文件夹添加为共享目录
    6. 在新环境中安装自定义节点

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

  <Step title="验证">
    启动新安装并确认：

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

## 故障排查

### Legacy Desktop 未自动检测到

如果未出现迁移提示，您可以手动迁移：

1. 在 Chooser 视图中点击 **+** 卡片
2. 选择 **Legacy Desktop**
3. 选择您的 Legacy Desktop 安装并按照提示操作

如果您的现有安装完全未被 Chooser 检测到，您也可以通过 Manage 面板直接添加。有关说明，请参阅 [**追踪已有安装**](/zh/installation/desktop/usage/instance-management#tracking-an-existing-installation)。

### 迁移失败

* **查看日志**：在 Manage 面板的 Console 选项卡中查看错误详情
* **确保 Legacy 安装完整**：迁移需要从现有安装读取数据
* **重试**：网络问题可能在二次尝试后解决

### 迁移后模型丢失

模型是作为共享目录路径添加的（不是复制）。如果模型未显示：

1. 打开已迁移安装的 **Manage** 面板
2. 进入 **Settings → Model directories**
3. 检查旧模型文件夹是否已列出。如果未列出，请手动添加。