jyezalaleul/runpod-stable-diffusion

AUTOMATIC1111 Stable Diffusion WebUI Docker镜像文档

镜像概述和主要用途

本Docker镜像封装了AUTOMATIC1111 Stable Diffusion WebUI，提供开箱即用的AI图像生成环境。该WebUI是Stable Diffusion模型的主流可视化操作界面，支持文本生成图像、图像优化、模型管理等功能。通过Docker容器化部署，可简化依赖配置流程，实现跨平台快速启动，适用于各类AI图像生成场景。

核心功能和特性

• 预配置环境：内置完整的WebUI运行依赖，无需手动安装Python、CUDA及各类库文件
• Web界面支持：提供直观的浏览器操作界面，支持模型加载、参数调整、图像生成等全流程操作
• 模型兼容性：兼容Stable Diffusion系列模型（SD 1.x/2.x、等）及、ControlNet等扩展组件
• 容器化优势：隔离系统环境，避免依赖冲突，支持快速部署与版本回滚
• 跨平台运行：可在Linux、Windows（WSL2）及macOS（支持Docker的环境）中稳定运行

使用场景和适用范围

• AI图像创作爱好者快速搭建Stable Diffusion工作流
• 内容创作者生成艺术图像、设计素材、概念图等创意内容
• 开发者测试Stable Diffusion模型性能或扩展功能
• 教育场景中演示AI图像生成原理与应用
• 需要快速部署WebUI的团队或个人，减少环境配置时间

使用方法和配置说明

基本部署（Docker Run）

前提条件

• 安装Docker Engine（20.10+版本）
• 若使用GPU加速，需安装NVIDIA Container Toolkit（仅Linux）

基础启动命令

bash
docker run -d \
  -p 7860:7860 \
  -v ./models:/app/stable-diffusion-webui/models \
  -v ./outputs:/app/stable-diffusion-webui/outputs \
  --name sd-webui \
  docker.xuanyuan.run/automatic1111/stable-diffusion-webui

参数说明

• -p 7860:7860：端口映射，将容器内WebUI默认端口（7860）映射到主机相同端口
• -v ./models:/app/stable-diffusion-webui/models：挂载本地模型目录，用于加载自定义模型文件
• -v ./outputs:/app/stable-diffusion-webui/outputs：挂载输出目录，持久化保存生成的图像
• --name sd-webui：指定容器名称，便于后续管理

高级配置

环境变量配置

通过-e参数设置WebUI启动参数，常用配置示例：

bash
docker run -d \
  -p 7860:7860 \
  -v ./models:/app/stable-diffusion-webui/models \
  -v ./outputs:/app/stable-diffusion-webui/outputs \
  -e "COMMANDLINE_ARGS=--xformers --enable-insecure-extension-access --api" \
  --name sd-webui \
  docker.xuanyuan.run/automatic1111/stable-diffusion-webui

其中COMMANDLINE_ARGS支持的关键参数：

• --xformers：启用xFormers优化，提升GPU内存使用效率
• --enable-insecure-extension-access：允许安装第三方扩展
• --api：启用API接口，支持外部程序调用
• --listen：允许局域网访问（需配合--port指定端口）

Docker Compose配置

创建docker-compose.yml文件简化部署：

yaml
version: '3.8'
services:
  sd-webui:
    image: docker.xuanyuan.run/automatic1111/stable-diffusion-webui
    container_name: sd-webui
    ports:
      - "7860:7860"
    volumes:
      - ./models:/app/stable-diffusion-webui/models
      - ./outputs:/app/stable-diffusion-webui/outputs
      - ./extensions:/app/stable-diffusion-webui/extensions  # 扩展插件持久化
    environment:
      - COMMANDLINE_ARGS=--xformers --api
    restart: unless-stopped  # 容器退出时自动重启（非手动停止情况）

启动命令：docker-compose up -d

访问与使用

容器启动后，通过浏览器访问 http://localhost:7860 进入WebUI界面。首次使用需加载模型文件（将模型文件放入本地./models/Stable-diffusion目录），随后即可通过文本提示词生成图像。

注意事项

• 模型文件需用户自行准备（如Stable Diffusion官方模型或社区模型）
• GPU加速需确保Docker环境支持NVIDIA容器运行时（Linux系统）
• 大模型生成时建议分配足够内存（至少8GB RAM，GPU建议8GB+显存）
• 定期通过docker pull docker.xuanyuan.run/automatic1111/stable-diffusion-webui更新镜像以获取最新功能