跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI算法

Stable Diffusion WebUI 云服务器部署指南

介绍 Stable Diffusion WebUI 在云服务器的部署流程。主要涵盖环境准备、项目克隆、启动配置及常见故障排查。重点包括 GPU 选型建议、Python 虚拟环境管理、Hugging Face 镜像源配置、启动参数详解以及针对依赖下载失败、权限限制、NumPy 版本冲突等问题的解决方案。通过合理配置网络和依赖,可实现低成本、高效率的云端 AI 绘图服务搭建。

山野来信发布于 2026/3/26更新于 2026/10/26102 浏览
Stable Diffusion WebUI 云服务器部署指南

本地部署虽然方便,但对硬件要求较高,尤其是显存。使用云服务器(特别是带有 GPU 的实例)能以较低成本体验强大的 AI 绘画能力,且支持随时随地通过浏览器访问。

一、部署前的准备

1.1 选择合适的云服务器

  • GPU 型号:优先选择 NVIDIA 显卡,如 V100、T4、P4、3090、4090 等。显存越大越好,建议至少 8GB,推荐 12GB 以上。
  • 操作系统:Linux 发行版是首选,如 Ubuntu 20.04 LTS、Debian 11 或 CentOS 7/8,社区支持好,文档丰富。
  • 网络带宽:部署初期需要下载大量模型和依赖,稳定的网络环境至关重要。

1.2 环境配置

  • Python 版本:推荐使用 Python 3.10.x(如 3.10.6)。过高或过低的版本可能与某些依赖库不兼容。
  • 虚拟环境:务必使用 venv 或 conda 创建独立的虚拟环境,避免依赖冲突,这是管理的黄金法则。
  • Git 配置:确保 Git 已安装。若国内访问 GitHub 较慢,可配置镜像源,例如设置环境变量 HF_ENDPOINT 指向镜像站(如 https://hf-mirror.com),能极大加速模型下载。

参考配置示例:Ubuntu + RTX3090(显存 24G),网络带宽 600MB/s+,Python 3.10.6 + Miniconda。

二、项目部署

2.1 获取项目代码

克隆官方仓库:

git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git

若遇网络问题,也可手动下载 zip 压缩包上传。代码结构中,webui.sh 是启动脚本,launch.py 是程序入口,启动时会按 modules/launch_utils.py 的流程配置环境。

2.2 性能优化

启动前安装性能优化库:

sudo apt-get install libgoogle-perftools4 libtcmalloc-minimal4 -y

2.3 启动项目

运行以下命令启动服务:

HF_ENDPOINT=https://hf-mirror.com ./webui.sh --port 7860 --listen --enable-insecure-extension-access --xformers

参数说明:

  • HF_ENDPOINT:重定向 Hugging Face 下载请求到镜像站,解决国内访问慢的问题。
  • --port 7860:指定监听端口,默认 7860,可根据需求修改。
  • --listen:允许服务器监听所有网络接口,使局域网或公网设备能访问 WebUI。
  • --enable-insecure-extension-access:允许扩展访问本地文件系统,部分高级扩展需此权限,但存在安全风险,仅信任扩展时启用。
  • --xformers:启用 xFormers 优化,降低显存占用并提升生成速度,仅支持 NVIDIA GPU。

2.4 部署说明

启动后,项目目录会生成 stable-diffusion-webui 子目录存放环境依赖,注意区分它与项目根目录。若使用 Conda 而非 venv,需将 webui.sh 中的 use_venv 变量值从 1 改为 0。

三、常见问题与避坑

3.1 网络与环境配置失败

检查云主机联网状态及带宽,确认是否需要代理。若包无法在线下载,考虑离线安装。

3.2 磁盘空间不足

部分依赖包占用较大,必要时扩充磁盘空间。

3.3 用户权限问题

webui.sh 默认禁止 root 用户启动以保安全。个人使用时,可将 can_run_as_root=0 改为 1,或注释掉相关限制脚本。

3.4 依赖包安装失败(CLIP / PyTorch)

若因 GitHub 下载慢导致失败,可在 modules/launch_utils.py 中所有 https://github.com/xxx.git 前添加 https://mirror.ghproxy.com/。

3.5 依赖 stablediffusion 安装失败

遇到 fatal: repository 'https://github.com/Stability-AI/stablediffusion.git/' not found 错误,原地址已失效。需在 modules/launch_utils.py 中将地址替换为 https://github.com/CompVis/stable-diffusion.git 或 https://github.com/w-e-w/stablediffusion.git。

若仍报错,可手动克隆:

git clone --config core.filemode=false https://github.com/CompVis/stable-diffusion.git ./stable-diffusion-webui/repositories/stable-diffusion-stability-ai
git clone --config core.filemode=false https://github.com/Stability-AI/generative-models.git repositories/generative-models

注:core.filemode=false 用于忽略文件权限变化,防止 Linux 下 Git 跟踪执行位导致的错误。

3.6 Git 访问认证

克隆私有或受限仓库时,密码需使用 Personal Access Token (PAT) 而非账号密码。在 GitHub 设置中生成令牌并赋予 public_repo 或 repo 权限,复制该令牌作为 Git 密码输入。

若仍有权限问题,启动指令可加 --skip-prepare-environment 跳过环境准备,后续再补全依赖。

3.7 NumPy 版本兼容性

报错 A module that was compiled using NumPy 1.x cannot be run in NumPy 2.x 时,需降级 NumPy:

pip install "numpy<2"

3.8 缺失依赖包(pytorch_lightning / gradio)

若启动提示缺失依赖,可使用以下命令安装:

pip install pytorch_lightning
pip install gradio

配合 --skip-prepare-environment 启动后,也可用 pip install -r requirements_versions.txt 补全缺失包。

3.9 Git 拉取依赖失败

若自动拉取 generative-models、BLIP 等依赖失败,可在项目路径下手动执行克隆命令:

git clone --config core.filemode=false https://github.com/CompVis/stable-diffusion.git ./repositories/stable-diffusion-stability-ai
git clone --config core.filemode=false https://github.com/Stability-AI/generative-models.git ./repositories/generative-models
git clone --config core.filemode=false https://github.com/crowsonkb/k-diffusion.git ./repositories/k-diffusion
git clone --config core.filemode=false https://github.com/salesforce/BLIP.git ./repositories/BLIP

目录

  1. 一、部署前的准备
  2. 1.1 选择合适的云服务器
  3. 1.2 环境配置
  4. 二、项目部署
  5. 2.1 获取项目代码
  6. 2.2 性能优化
  7. 2.3 启动项目
  8. 2.4 部署说明
  9. 三、常见问题与避坑
  10. 3.1 网络与环境配置失败
  11. 3.2 磁盘空间不足
  12. 3.3 用户权限问题
  13. 3.4 依赖包安装失败(CLIP / PyTorch)
  14. 3.5 依赖 stablediffusion 安装失败
  15. 3.6 Git 访问认证
  16. 3.7 NumPy 版本兼容性
  17. 3.8 缺失依赖包(pytorch_lightning / gradio)
  18. 3.9 Git 拉取依赖失败

更多推荐文章

查看全部
  • GESP C++ 七级真题:物流网络
  • 量化交易实战:基于 Quantitative-Notebooks 的配对交易策略
  • 前端 CI/CD 流程与自动化部署实践
  • 前端大数据导出优化:解决 Chrome 内存崩溃的实战方案
  • Apache SeaTunnel Web 可视化数据集成实战指南
  • C++ 多态详解:原理、实现与最佳实践
  • C++ std::stringstream 详解
  • Python 实现 MCP 客户端调用高德地图天气查询示例
  • FastGithub 部署指南:智能 DNS 解析优化 GitHub 访问
  • Docker 镜像核心解析:以 Nginx 为例
  • Microi 吾码与 JavaScript 协同开发实战
  • Spring AI 框架入门:从 DeepSeek 集成到 RAG 实战
  • 零基础转行渗透测试的学习路径与职业发展指南
  • 基于 AI 辅助的学生成绩管理系统开发实战
  • Ovis: 多模态大语言模型的结构化嵌入对齐
  • 适合程序员的 7 款高效 AI 开发工具
  • 宇树 G1 机器人 VR 遥操与模仿学习开发:xr_teleoperate 集成 unitree_IL_lerobot
  • Spring AI Tool 实现自然语言操作 MySQL 数据库详解
  • Python 技术文档概览与模块索引
  • Neo4j 图数据库从搭建到项目使用深度详解

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online