ComfyUI-Launcher 零基础入门指南：从安装到高效管理工作流

ComfyUI-Launcher 是一款专为简化 ComfyUI 使用流程设计的启动器工具，它解决了传统 ComfyUI 配置复杂、环境依赖冲突、工作流管理混乱等痛点，让用户能够实现“零配置”快速启动各类工作流项目。无论是新手开发者还是资深用户，都能通过这个工具显著提升工作效率，专注于创意实现而非环境搭建。

3分钟快速启动：从安装到运行第一个项目

准备工作：克隆项目代码

首先需要将项目代码下载到本地。打开终端，输入以下命令：

git clone https://gitcode.com/gh_mirrors/co/ComfyUI-Launcher

这个命令会将项目仓库完整复制到你的电脑中，确保网络连接稳定，等待下载完成。

安装依赖：配置运行环境

进入项目目录并安装必要的依赖包：

cd ComfyUI-Launcher
pip install -r requirements.txt

这里使用 pip（Python 包管理工具）安装 requirements.txt 文件中列出的所有依赖。建议使用虚拟环境（独立的 Python 运行环境，避免依赖冲突）来隔离项目环境，防止与其他 Python 项目产生冲突。

启动应用：运行启动脚本

执行启动脚本启动 ComfyUI-Launcher：

python launcher.py

启动成功后，系统会自动打开浏览器，展示 ComfyUI-Launcher 的主界面。如果浏览器没有自动打开，可以手动访问终端中显示的本地地址（通常是 http://localhost:端口号）。

场景化应用：满足不同使用需求的操作指南

场景一：新建工作流项目

当你需要从零开始创建一个新的 ComfyUI 项目时，可以使用“新建工作流”功能。在主界面点击“Create workflow”按钮，进入新建工作流页面，这里提供了多种预设模板，如图片生成、视频动画、图像放大等。

图：ComfyUI-Launcher 新建工作流界面，展示了多种预设模板选项

选择合适的模板后，点击“Create”按钮，会弹出创建项目对话框。在这里可以设置项目名称，还可以勾选“Use a static port”选项并指定端口号，方便在 Docker 或远程服务器环境中使用。

图：创建项目对话框，显示端口设置选项

场景二：导入现有工作流

如果你有已有的 ComfyUI 工作流文件（.json 格式），可以通过“Import workflow”功能快速导入并运行。在主界面点击“Import workflow”按钮，进入导入页面，你可以将工作流文件拖拽到指定区域，或点击区域选择文件。

图：导入工作流界面，显示文件拖拽区域和导入进度

选择文件后，系统会自动解析并安装工作流所需的依赖和模型。导入完成后，项目会出现在工作流列表中，点击“Launch”按钮即可运行。

场景三：管理多个工作流项目

ComfyUI-Launcher 提供了直观的工作流管理界面，你可以在主页面看到所有已创建或导入的项目。每个项目卡片显示项目名称和 ID，你可以通过“Launch”按钮启动项目，或通过“Delete”按钮删除不需要的项目。

图：工作流项目管理界面，展示已创建的项目列表

这种集中管理方式使得切换不同项目变得非常方便，特别适合需要同时处理多个任务的用户。

进阶技巧：提升使用效率的实用方法

使用静态端口配置多环境

在创建或导入项目时，勾选“Use a static port”并设置固定端口号，可以实现在同一台机器上运行多个 ComfyUI 实例，避免端口冲突。这对于开发测试不同版本的工作流或为不同用户提供服务非常有用。

图：导入项目时的端口配置界面

定期更新保持功能最新

ComfyUI-Launcher 处于持续开发中，定期更新可以获得新功能和问题修复。通过以下命令可以更新项目代码：

git pull origin main

更新后建议重新安装依赖，确保兼容性：

pip install -r requirements.txt --upgrade

探索高级配置选项

对于有一定经验的用户，可以通过修改项目中的配置文件来自定义更多功能。配置文件位于项目目录下的 server/config.json，你可以根据需求调整端口、日志级别、模型存储路径等参数。详细的配置说明可参考项目中的相关文档。

常见问题速查：解决使用中的困惑

Q: 启动时提示端口被占用怎么办？

A: 这是因为当前端口已被其他程序占用。可以在创建或导入项目时勾选“Use a static port”并设置一个未被占用的端口号，如 4001、4002 等。

Q: 导入工作流后启动失败，提示缺少模型？

A: ComfyUI-Launcher 会自动下载工作流所需的模型，但有时可能因为网络问题导致下载失败。可以检查网络连接，或手动下载模型并放置到指定的模型目录（通常在项目的 models 文件夹下）。

Q: 如何卸载 ComfyUI-Launcher？

A: 只需删除项目文件夹即可完全卸载。如果使用了虚拟环境，建议同时删除虚拟环境目录，以释放磁盘空间。

Q: 能否在远程服务器上运行 ComfyUI-Launcher？

A: 可以。在远程服务器上按照正常步骤安装和启动后，需要确保服务器的端口（如 4001）已开放，并通过服务器的 IP 地址和端口访问。如果使用 Docker，需要正确配置端口映射。

Q: 工作流运行过程中出现错误怎么办？

A: 首先查看终端中的错误信息，通常会提示具体的问题原因。常见问题包括依赖版本不兼容、模型文件损坏等。可以尝试更新依赖或重新下载模型来解决。

通过本指南，你已经掌握了 ComfyUI-Launcher 的基本使用方法和进阶技巧。无论是创建新工作流、导入现有项目，还是管理多个任务，这款工具都能帮助你简化流程，提高效率。随着使用的深入，你可以探索更多高级功能，充分发挥 ComfyUI 的强大能力。