inglebard/stable-diffusion-ui

Docker镜像 inglebard/stable-diffusion-ui 文档

https://github.com/Inglebard/dockerfiles/tree/stable-diffusion-ui
https://hub.docker.com/r/inglebard/stable-diffusion-ui/

镜像概述与主要用途

本镜像是基于 https://github.com/cmdr2/stable-diffusion-ui 项目构建的 Docker 容器化方案，旨在提供便捷、隔离的 Stable Diffusion Web UI 部署环境。通过容器化，用户可快速启动服务，无需手动配置复杂依赖，适用于需要高效使用 Stable Diffusion 文本生成图像功能的场景。

核心功能与特性

• 集成 Web UI 工具：内置 cmdr2/stable-diffusion-ui，提供直观的 Web 界面操作，支持 Stable Diffusion 核心功能（如文本生成图像、模型管理等）。
• 环境隔离：容器化部署避免系统依赖冲突，简化安装流程。
• 预配置参数：默认暴露 Web 访问端口，支持数据持久化与性能优化卷挂载。

使用场景与适用范围

• 目标用户：AI 绘画爱好者、开发者、需要快速部署 Stable Diffusion UI 的个人或团队。
• 典型场景：
  • 无需手动配置 Python、CUDA 等依赖，通过 Docker 一键启动服务。
  • 追求环境隔离，避免本地系统污染的场景。
  • 需要 GPU 加速以提升图像生成效率的场景（需额外配置 GPU 传递）。

技术规格

用户

• 容器内以标准用户（standard user）运行，遵循最小权限原则，提升安全性。

集成软件

• 核心组件：cmdr2/stable-diffusion-ui（Stable Diffusion Web UI 工具）。

端口

• 暴露端口：9000（Web UI 访问端口，需映射至主机端口以通过浏览器访问）。

卷挂载

推荐挂载以下卷以实现数据持久化与性能优化：

• /opt/easy-diffusion/：存储应用配置、模型文件、生成结果等数据，避免容器重建导致数据丢失。
• /dev/shm：共享内存挂载，优化容器内存使用效率（尤其在图像生成等内存密集型任务中）。

GPU 支持

若需启用 GPU 加速（推荐），需在启动容器时传递 GPU 设备（依赖 Docker 已配置 GPU 支持，如安装 nvidia-docker）。

使用方法与配置说明

基础启动命令

通过 docker run 启动容器，基础示例如下：

bash
docker run -t -i --rm \
  -v /dev/shm:/dev/shm \  # 挂载共享内存，优化性能
  -p 9000:9000 \          # 端口映射：主机端口:容器端口（主机端口可自定义，如 8080:9000）
  inglebard/stable-diffusion-ui

访问方式：启动后，通过浏览器访问 http://<主机IP>:<映射端口>（如 http://localhost:9000）即可打开 Web UI。

带 GPU 加速的启动命令

若需启用 GPU 加速，需添加 --gpus 参数（需确保主机已安装 nvidia-docker）：

bash
docker run -t -i --rm \
  --gpus all \            # 传递所有 GPU 设备（也可指定具体设备，如 "device=0"）
  -v /dev/shm:/dev/shm \
  -v /path/to/local/data:/opt/easy-diffusion/ \  # 挂载本地目录至 /opt/easy-diffusion/，持久化数据
  -p 9000:9000 \
  inglebard/stable-diffusion-ui

致谢

本镜像基于以下项目构建：

• https://github.com/cmdr2/stable-diffusion-ui