universonic/stable-diffusion-webui

Stable Diffusion web UI Docker 使用指南

简介

Stable Diffusion web UI 是一个基于 Gradio 库开发的 Stable Diffusion 浏览器界面工具，支持通过 Docker 快速部署和使用。

基本使用示例

快速启动容器的基础命令如下，适用于简单测试或临时使用：

bash
docker run --gpus all --restart unless-stopped -p 8080:8080 \
  --name stable-diffusion-webui -d universonic/stable-diffusion-webui

参数说明：

• --gpus all：启用主机所有 GPU 资源；
• --restart unless-stopped：容器意外停止后自动重启；
• -p 8080:8080：将容器内 8080 端口映射到主机 8080 端口，访问 `[***] 即可打开界面；
• -d：后台运行容器。

数据存储配置

为避免容器内数据丢失（如扩展、模型、生成结果等），建议将数据目录挂载到宿主机。具体步骤如下：

1. 创建宿主机数据目录

在宿主机合适位置创建数据根目录，例如 /my/own/datadir（路径可自定义，需确保有读写权限）。

2. 启动容器并挂载目录

通过 -v 参数将宿主机目录挂载到容器内对应路径，命令如下：

CODE_TOKEN_1

3. 故障排查

若容器启动失败或服务异常，可通过日志定位问题：

CODE_TOKEN_2

docker-compose 部署

对于需要长期运行或多服务管理的场景，推荐使用 docker-compose 配置，示例如下：

CODE_TOKEN_3

使用方法：将上述内容保存为 docker-compose.yml，在文件目录下执行 docker-compose up -d 启动服务。

重要注意事项

• 模型文件必须存在：若宿主机模型目录（如 /my/own/datadir/models/Stable-diffusion）未放置 Stable Diffusion 模型文件（checkpoint、vae 等），容器会启动失败并不断重启。需手动将模型文件放入该目录，等待服务启动后即可正常使用。
• 进一步问题参考：更多配置细节可查阅 官方文档。