Stable Diffusion WebUI: 159K+ Stars — 2026 完整安装配置指南

:: 从发布页面下载 sd.webui.zip
:: 解压到 C:\stable-diffusion-webui
:: 先运行更新器
cd C:\stable-diffusion-webui
update.bat

:: 启动 WebUI
run.bat

@echo off

set PYTHON=python
set GIT=git
set VENV_DIR=venv
set COMMANDLINE_ARGS=--xformers --autolaunch --update-check

:: 显存优化选项（选择一个）:
:: set COMMANDLINE_ARGS=--medvram    &:: 8GB 显卡
:: set COMMANDLINE_ARGS=--lowvram    &:: 4GB 显卡  
:: set COMMANDLINE_ARGS=--normalvram &:: 12GB+ 显卡

:: RTX 40 系列添加 --xformers 可获得 20-30% 加速
:: 出现黑图/绿图时，添加 --precision full --no-half

call webui.bat

# 安装依赖 (Ubuntu/Debian)
sudo apt update && sudo apt install -y wget git python3 python3-venv libgl1 libglib2.0-0

# 克隆仓库
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
cd stable-diffusion-webui

# 创建虚拟环境并安装
python3 -m venv venv
source venv/bin/activate
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
pip install -r requirements.txt

# 启动
./webui.sh --xformers --listen

# Dockerfile.stable-diffusion-webui
FROM nvidia/cuda:12.1.1-devel-ubuntu22.04

ENV DEBIAN_FRONTEND=noninteractive

RUN apt-get update && apt-get install -y \
    python3 python3-pip python3-venv git wget \
    libgl1 libglib2.0-0 libsm6 libxext6 \
    && rm -rf /var/lib/apt/lists/*

RUN useradd -m -s /bin/bash sduser
WORKDIR /home/sduser

RUN git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
WORKDIR /home/sduser/stable-diffusion-webui

RUN python3 -m venv venv && \
    . venv/bin/activate && \
    pip install --no-cache-dir torch torchvision torchaudio \
    --index-url https://download.pytorch.org/whl/cu121 && \
    pip install -r requirements.txt

RUN chown -R sduser:sduser /home/sduser
USER sduser

EXPOSE 7860

ENTRYPOINT ["bash", "-c", \". venv/bin/activate && python3 launch.py --listen --api --xformers"]

# 构建镜像
docker build -f Dockerfile.stable-diffusion-webui -t sd-webui:latest .

# 运行，启用 GPU 访问和模型持久化
docker run -d \
  --name stable-diffusion-webui \
  --gpus all \
  -p 7860:7860 \
  -v $(pwd)/models:/home/sduser/stable-diffusion-webui/models/Stable-diffusion \
  -v $(pwd)/outputs:/home/sduser/stable-diffusion-webui/outputs \
  -v $(pwd)/extensions:/home/sduser/stable-diffusion-webui/extensions \
  -e NVIDIA_VISIBLE_DEVICES=all \
  sd-webui:latest

# docker-compose.yml
version: '3.8'

services:
  stable-diffusion-webui:
    build:
      context: .
      dockerfile: Dockerfile.stable-diffusion-webui
    container_name: sd-webui
    runtime: nvidia
    ports:
      - "7860:7860"
    volumes:
      - ./models:/home/sduser/stable-diffusion-webui/models/Stable-diffusion
      - ./outputs:/home/sduser/stable-diffusion-webui/outputs
      - ./extensions:/home/sduser/stable-diffusion-webui/extensions
      - ./vae:/home/sduser/stable-diffusion-webui/models/VAE
    environment:
      - NVIDIA_VISIBLE_DEVICES=all
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]
    restart: unless-stopped

docker-compose up -d

# 在虎网云 GPU 实例上 (Ubuntu 22.04 预配置)
sudo apt update && sudo apt install -y git wget

# 克隆并配置
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
cd stable-diffusion-webui

# 使用 CUDA 12 支持安装
python3 -m venv venv
source venv/bin/activate
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121
pip install -r requirements.txt

# 启动公开访问 (配置防火墙规则)
python3 launch.py --listen --port 7860 --xformers --gradio-auth admin:securepassword123

# 通过扩展标签页安装（推荐）
# 1. 打开 WebUI → 扩展 → 可用
# 2. 点击"加载自"
# 3. 搜索"ControlNet"
# 4. 点击安装"sd-webui-controlnet"
# 5. 重启 UI

# 或手动安装：
cd extensions
git clone https://github.com/Mikubill/sd-webui-controlnet.git

# 核心 ControlNet 模型 (SD 1.5)
wget -P models/ControlNet/ https://huggingface.co/lllyasviel/ControlNet-v1-1/resolve/main/control_v11p_sd15_openpose.pth
wget -P models/ControlNet/ https://huggingface.co/lllyasviel/ControlNet-v1-1/resolve/main/control_v11f1p_sd15_depth.pth
wget -P models/ControlNet/ https://huggingface.co/lllyasviel/ControlNet-v1-1/resolve/main/control_v11p_sd15_canny.pth
wget -P models/ControlNet/ https://huggingface.co/lllyasviel/ControlNet-v1-1/resolve/main/control_v11p_sd15_lineart.pth

# SDXL ControlNet 模型
wget -P models/ControlNet/ https://huggingface.co/lllyasviel/sd_control_collection/resolve/main/diffusers_xl_canny_mid.safetensors
wget -P models/ControlNet/ https://huggingface.co/lllyasviel/sd_control_collection/resolve/main/diffusers_xl_depth_mid.safetensors

// settings.json - ControlNet 配置
{
  "control_net_max_models_num": 3,
  "control_net_model_cache_size": 2,
  "control_net_control_transfer": false,
  "control_net_detectedmap_dir": "extensions/sd-webui-controlnet/detected_maps",
  "control_net_models_path": "models/ControlNet",
  "control_net_modules_path": "extensions/sd-webui-controlnet/annotator",
  "control_net_unit_mode": false,
  "control_net_sync_field_args": true
}

# 下载 LoRA 模型到专用目录
# 将 .safetensors LoRA 文件放入：
# models/Lora/

# 示例：下载热门风格 LoRA
wget -P models/Lora/ "https://civitai.com/api/download/models/12345"

# 将 ComfyUI 安装为独立工具（推荐而非迁移）
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI
pip install -r requirements.txt

# 共享模型目录避免重复
ln -s /path/to/stable-diffusion-webui/models/Stable-diffusion models/checkpoints
ln -s /path/to/stable-diffusion-webui/models/Lora models/loras
ln -s /path/to/stable-diffusion-webui/models/ControlNet models/controlnet

# 在不同端口启动
python main.py --port 8188

# 安装以下扩展以获得生产级体验
cd extensions

# Adetailer - 自动面部/手部/细节修复
git clone https://github.com/Bing-su/adetailer.git

# Ultimate SD Upscale - 高分辨率放大
git clone https://github.com/Coyote-A/ultimate-upscale-for-automatic1111.git

# Tiled VAE - 降低大图显存占用
git clone https://github.com/pkuliyi2015/multidiffusion-upscaler-for-automatic1111.git

# Tag Autocomplete - 提示词补全
git clone https://github.com/DominikDoom/a1111-sd-webui-tagcomplete.git

# System Info + Benchmark - 系统信息和基准测试
git clone https://github.com/vladmandic/sd-extension-system-info.git

# Inpaint Anything - 万物分割 + 重绘
git clone https://github.com/Uminosachi/sd-webui-inpaint-anything.git

# 安装扩展后重启 WebUI

# 4GB 显存 GPU (入门级):
python3 launch.py --lowvram --precision full --no-half --xformers

# 6-8GB 显存 GPU (主流级):
python3 launch.py --medvram --xformers --opt-split-attention

# 12GB+ 显存 GPU (高端):
python3 launch.py --xformers --opt-sdp-attention

# 24GB 显存 GPU (发烧级):
python3 launch.py --xformers --opt-sdp-attention --no-half-vae

# txt2img API 的 Python 客户端
import requests
import json

url = "http://localhost:7860/sdapi/v1/txt2img"

payload = {
    "prompt": "masterpiece, best quality, portrait of a cyberpunk samurai, neon city background, 8k uhd",
    "negative_prompt": "blurry, low quality, deformed, ugly, duplicate",
    "steps": 25,
    "cfg_scale": 7.0,
    "width": 1024,
    "height": 1024,
    "sampler_name": "DPM++ 2M Karras",
    "batch_size": 1,
    "seed": -1,
    "override_settings": {
        "sd_model_checkpoint": "sd_xl_base_1.0.safetensors"
    }
}

response = requests.post(url, json=payload)
result = response.json()

# 保存生成的图像
import base64
for i, img_data in enumerate(result['images']):
    with open(f"output_{i}.png", "wb") as f:
        f.write(base64.b64decode(img_data))

# batch_generate.py - 处理多个提示词
import requests
import csv
import base64

API_URL = "http://localhost:7860/sdapi/v1/txt2img"

def generate_image(prompt, filename, width=1024, height=1024):
    payload = {
        "prompt": prompt,
        "negative_prompt": "blurry, low quality, deformed",
        "steps": 25,
        "cfg_scale": 7.0,
        "width": width,
        "height": height,
        "sampler_name": "DPM++ 2M Karras"
    }
    
    response = requests.post(API_URL, json=payload)
    result = response.json()
    
    with open(filename, "wb") as f:
        f.write(base64.b64decode(result['images'][0]))
    
    return filename

# 从 CSV 处理提示词列表
with open("prompts.csv", "r") as f:
    reader = csv.DictReader(f)
    for i, row in enumerate(reader):
        filename = f"output_{i:04d}.png"
        generate_image(row['prompt'], filename)
        print(f"已生成: {filename}")

# 1. 启用认证
python3 launch.py --listen --gradio-auth admin:强密码

# 2. 使用 HTTPS 反向代理 (nginx)
# /etc/nginx/sites-available/sd-webui
server {
    listen 443 ssl http2;
    server_name sd.example.com;

    ssl_certificate /etc/letsencrypt/live/sd.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/sd.example.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:7860;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # WebSocket 支持 Gradio
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

# 3. 防火墙规则 (ufw)
sudo ufw default deny incoming
sudo ufw allow ssh
sudo ufw allow 443/tcp
sudo ufw enable

# 创建简单的健康检查脚本
#!/bin/bash
# health_check.sh

STATUS=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:7860/)
if [ "$STATUS" != "200" ]; then
    echo "$(date): WebUI 宕机 (HTTP $STATUS)，正在重启..." >> /var/log/sd-webui.log
    systemctl restart sd-webui
fi

# 自动启动的 systemd 服务
# /etc/systemd/system/sd-webui.service
[Unit]
Description=Stable Diffusion WebUI
After=network.target

[Service]
Type=simple
User=sduser
WorkingDirectory=/home/sduser/stable-diffusion-webui
ExecStart=/home/sduser/stable-diffusion-webui/venv/bin/python launch.py --xformers --listen --port 7860
Restart=on-failure
RestartSec=30
Environment="PYTHONUNBUFFERED=1"

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable sd-webui
sudo systemctl start sd-webui