automaatio/comfyui

ComfyUI Docker镜像文档

镜像概述和主要用途

本镜像基于ComfyUI Wiki的Linux安装说明，在Docker容器中部署ComfyUI。ComfyUI是一个灵活的节点式AI工作流工具，本镜像提供了便捷的容器化部署方式，便于快速搭建和使用ComfyUI服务。

核心功能和特性

• 遵循ComfyUI官方Linux安装流程构建，确保兼容性
• 支持NVIDIA GPU加速（需配置nvidia运行时）
• 可通过环境变量配置用户权限、时区和GPU可见性
• 持久化存储应用数据和虚拟环境，确保数据不丢失
• 提供Web UI访问，默认端口8188

使用场景和适用范围

适用于需要容器化部署ComfyUI的用户，包括：

• AI模型开发者和研究者
• 需要快速搭建ComfyUI环境的用户
• 希望隔离ComfyUI运行环境的场景
• 利用GPU加速进行AI工作流处理的应用

使用方法和配置说明

Dockerfile获取

Dockerfile源码可通过GitHub仓库访问：https://github.com/automaatio-dev/comfyui

Docker Compose配置

以下是完整的docker-compose.yml配置示例：

yaml
# Docker-Compose

################################################
# Services
################################################

services:

  ################################################
  # ComfyUI
  ################################################

  comfyui:
    image: "automaatio/comfyui:0.3.12"
    container_name: "comfyui"
    environment:
      PUID: ${PUID}           # 用户ID，用于权限控制
      PGID: ${PGID}           # 组ID，用于权限控制
      TZ: ${TZ}               # 时区设置，如Asia/Shanghai
      NVIDIA_VISIBLE_DEVICES: ${NVIDIA_VISIBLE_DEVICES}  # 可见GPU设备，如all
      CUDA_VISIBLE_DEVICES: ${CUDA_VISIBLE_DEVICES}      # CUDA可见设备，如0,1
      NVIDIA_DRIVER_CAPABILITIES: ${NVIDIA_DRIVER_CAPABILITIES}  # GPU驱动能力，如compute,utility
      LISTEN_ADDRESS: ${LISTEN_ADDRESS}  # 监听地址，默认0.0.0.0
    runtime: "nvidia"         # 使用nvidia运行时以支持GPU
    restart: "unless-stopped"  # 除非手动停止，否则自动重启
    ports:
      - "8188:8188"           # Web UI端口映射
    volumes:
      - "/home/docker/comfyui/app:/comfyui/app"   # 应用数据持久化
      - "/home/docker/comfyui/venv:/comfyui/venv" # 虚拟环境持久化
    networks:
      - "comfyui"

################################################
# Networks
################################################

networks:
  comfyui:
    name: "comfyui"

环境变量说明

启动和访问

1. 配置环境变量（可通过.env文件设置PUID、PGID、TZ等）
2. 执行以下命令启动容器：

   bash
   docker-compose up -d
   

3. 访问Web UI：打开浏览器访问 http://localhost:8188/

数据持久化

通过卷挂载实现数据持久化：

• /home/docker/comfyui/app：存储ComfyUI应用数据
• /home/docker/comfyui/venv：存储Python虚拟环境

确保宿主机目录存在并具有适当权限。