jimlee2048/comfyui-docker

ComfyUI Docker镜像

一个可定制的https://github.com/comfyanonymous/ComfyUI Docker镜像，具备自动环境设置功能。

⚠️ 注意：此镜像设计用于个人GUI访问使用，不适用于生产服务器部署。

特性

• 现成的Python环境，包含常见机器学习包：nunchaku、sageattention2++、sageattn3、xformers、transformers、onnxruntime、opencv-python等
  • 完整详情参见https://github.com/jimlee2048/comfyui-docker/blob/main/Dockerfile.cuda
• 自定义节点与模型的自动化管理：
  • 启动时基于配置驱动的设置
  • 初始化前后脚本钩子（支持.py、.sh、.bat、.ps1）
  • 多配置文件支持，可选基于正则表达式的过滤器，实现灵活更新
• 内置https://github.com/aria2/aria2%E7%94%A8%E4%BA%8E%E5%8A%A0%E9%80%9F%E5%A4%A7%E5%9E%8B%E6%A8%A1%E5%9E%8B%E6%96%87%E4%BB%B6%E4%B8%8B%E8%BD%BD
• 使用https://github.com/ltdrdata/ComfyUI-Manager/blob/main/docs/en/cm-cli.md%E5%AE%89%E8%A3%85%E8%87%AA%E5%AE%9A%E4%B9%89%E8%8A%82%E7%82%B9
• 支持从Comfy Registry安装自定义节点
• 为中国大陆用户提供可选优化（pip/ Hugging Face/ Civitai镜像）

可用镜像标签

环境变量

快速开始

1. 克隆此仓库，将docker/作为工作目录：

   bash
   git clone https://github.com/jimlee2048/comfyui-docker
   cd comfyui-docker/docker
   

2. 基于示例创建并配置docker/.env文件：

   bash
   cp example.env .env
   

   更多详情参见https://github.com/jimlee2048/comfyui-docker/blob/main/docker/example.env%E3%80%82

3.（可选）设置自动节点/模型管理： - 在docker/.env中设置INIT_NODE=true和/或INIT_MODEL=true - 在docker/config/中创建启动配置 更多详情参见https://github.com/jimlee2048/comfyui-docker/blob/main/docker/config/example.toml%E3%80%82

4. 基于示例创建并配置docker/compose.yml文件：

   bash
   cp compose.example.yml compose.yml
   

   更多详情参见https://github.com/jimlee2048/comfyui-docker/blob/main/docker/compose.example.yml%E3%80%82

5. 启动ComfyUI：

   • 前台运行以查看日志，首次运行推荐使用：

     bash
     docker compose up
     

   • 或作为服务在后台运行：

     bash
     docker compose up -d
     

   首次运行可能需要更长时间，因为需要安装节点和下载模型。

6. 通过http://localhost:8188访问ComfyUI

7. 停止运行：

   bash
   docker compose down
   

更新与维护

配置更改

修改启动配置或环境变量时，请勿使用Web界面上的ComfyUI Manager重启功能。

应重启容器以应用更改：

bash
docker compose down
docker compose up -d

ComfyUI更新

• 方法1：使用Web界面中的ComfyUI Manager

• 方法2：拉取最新镜像：

  bash
  docker compose pull
  docker compose down
  docker compose up -d
  

待办事项

• AMD GPU的ROCm版本
• Intel GPU的XPU版本