ComfyUI Launcher (测试版)

运行任何 ComfyUI 工作流，无需设置。

需要帮助？加入我们的 Discord！

随处运行：

• 本地
• RunPod
• Huggingface Spaces

功能特性

• 自动安装自定义节点、缺失的模型文件等
• 此工具导出的工作流任何人都可以无需设置地运行
• 同时处理多个 ComfyUI 工作流
• 每个工作流都在其独立的隔离环境中运行
• 防止在更新自定义节点、ComfyUI 等时您的工作流突然损坏

演示

运行 workflow json 文件，无需设置

https://github.com/ComfyWorkflows/ComfyUI-Launcher/assets/33400216/aa17680d-eee5-4e6d-abc4-9f7551f9a4ad

要求

Windows (Windows 子系统 for Linux - WSL) 和 Linux:

• Docker（支持 GPU）或 Python 3

macOS:

• Python 3

快速开始

选项 1：Docker (Linux & Windows)

Linux

docker run \
--gpus all \ # remove this line if you don't have a GPU or if you're on MacOS
--rm \
--name comfyui_launcher \
-p 4000-4100:4000-4100 \
-v $(pwd)/comfyui_launcher_models:/app/server/models \
-v $(pwd)/comfyui_launcher_projects:/app/server/projects \
-it thecooltechguy/comfyui_launcher

Windows

docker run ^
--gpus all ^ # remove this line if you don't have a GPU
--rm ^
--name comfyui_launcher ^
-p 4000-4100:4000-4100 ^
-v %cd%/comfyui_launcher_models:/app/server/models ^
-v %cd%/comfyui_launcher_projects:/app/server/projects ^
-it thecooltechguy/comfyui_launcher

在浏览器中打开 http://localhost:4000

选项 2：手动设置 (macOS, Linux, and Windows)

适用于 Windows (WSL - Windows 子系统 for Linux)、Linux 和 macOS

安装 (一次性设置)

git clone https://github.com/ComfyWorkflows/comfyui-launcher
cd comfyui-launcher/

启动 ComfyUI Launcher

./run.sh

在浏览器中打开 http://localhost:4000

如果您在安装过程中遇到问题，请在我们的 discord 上的 bugs 论坛发帖。

更新

选项 1：Docker

docker pull thecooltechguy/comfyui_launcher

选项 2：手动设置

git pull

使用

使用反向代理 (高级)

如果您在反向代理后面运行 ComfyUI Launcher，或者在只能暴露单个端口以访问 Launcher 及其工作流项目的环境中，您可以使用 PROXY_MODE=true 运行 Launcher（仅适用于 Docker）。

docker run \
--gpus all \ # remove this line if you don't have a GPU or if you're on MacOS
--rm \
--name comfyui_launcher \
-p 4000:80 \
-v $(pwd)/comfyui_launcher_models:/app/server/models \
-v $(pwd)/comfyui_launcher_projects:/app/server/projects \
-e PROXY_MODE=true \
-it thecooltechguy/comfyui_launcher

一旦容器运行，您只需将 80 端口暴露给外部世界即可。这将允许您通过单个端口访问 Launcher 及其工作流项目。

目前，PROXY_MODE=true 仅适用于 Docker，因为容器内使用了 NGINX。 如果您手动运行 Launcher，则需要自己设置反向代理（参见 nginx.conf 文件作为示例）。

使用现有的 ComfyUI 模型文件夹

启动 ComfyUI Launcher 时，您可以将 MODELS_DIR 环境变量设置为现有 ComfyUI 模型文件夹的路径。这将允许您使用已下载的模型。默认情况下，它们存储在 ./server/models。

使用不同的文件夹存储您的 Launcher 项目

启动 ComfyUI Launcher 时，您可以将 PROJECTS_DIR 环境变量设置为用于存储项目的文件夹路径。默认情况下，它们存储在 ./server/projects。

捐赠

如果您觉得我们的工作对您有用，我们非常感谢您的任何捐赠！谢谢！

即将推出

• 原生 Windows 支持（无需 WSL）
• 更好的本地工作流管理方式
• 使用云 GPU 运行工作流
• 将项目备份到云端
• 在云端运行 ComfyUI Launcher

致谢

• ComfyUI Manager (https://github.com/ltdrdata/ComfyUI-Manager/)
  • 用于自动检测并安装自定义节点

ComfyUI-Launcher 快速上手指南

ComfyUI Launcher 是一个允许您以 零配置 (ZERO setup) 运行任何 ComfyUI 工作流的工具。它自动处理自定义节点和模型文件的安装，并为每个工作流提供隔离的运行环境。

1. 环境准备

根据您的操作系统选择相应的依赖：

• Windows / Linux:
  • 推荐：Docker (需支持 GPU 加速)
  • 备选：Python 3
• macOS:
  • Python 3

注意：如果您在 Windows 上使用 Docker，建议通过 WSL (Windows Subsystem for Linux) 环境运行以获得最佳兼容性。

2. 安装步骤

方案 A：使用 Docker (推荐 Linux & Windows)

此方式利用容器隔离环境，适合需要 GPU 加速的场景。

Linux:

docker run \
--gpus all \ # 如果没有 GPU 或是在 MacOS 上，请删除此行
--rm \
--name comfyui_launcher \
-p 4000-4100:4000-4100 \
-v $(pwd)/comfyui_launcher_models:/app/server/models \
-v $(pwd)/comfyui_launcher_projects:/app/server/projects \
-it thecooltechguy/comfyui_launcher

Windows (CMD/PowerShell):

docker run ^
--gpus all ^ # 如果没有 GPU，请删除此行
--rm ^
--name comfyui_launcher ^
-p 4000-4100:4000-4100 ^
-v %cd%/comfyui_launcher_models:/app/server/models ^
-v %cd%/comfyui_launcher_projects:/app/server/projects ^
-it thecooltechguy/comfyui_launcher

方案 B：手动安装 (macOS, Linux, Windows/WSL)

适用于无法使用 Docker 的环境。

1. 克隆仓库

   git clone https://github.com/ComfyWorkflows/comfyui-launcher
   cd comfyui-launcher/
   

2. 启动服务

   ./run.sh
   

3. 基本使用

访问界面

安装完成后，打开浏览器访问以下地址：

• URL: http://localhost:4000

导入与运行工作流

• 您可以直接导入 .json 格式的工作流文件。
• 工具会自动检测并安装所需的自定义节点和缺失的模型文件。
• 每个工作流将在独立的环境中运行，互不干扰。

更新工具

• Docker 用户:

  docker pull thecooltechguy/comfyui_launcher
  

• 手动安装用户:

  git pull