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

Stable Diffusion WebUI 云服务器部署指南

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

山野来信发布于 2026/3/26更新于 2026/5/2014 浏览
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 拉取依赖失败
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • AI Agent 中的 Skills 概念与作用
  • 大模型 LLM 量化:5 个核心基础技术解析
  • Cursor + Figma MCP:AI 自动还原设计稿生成代码
  • 2026 年 3 月全球 AI 前沿动态与技术突破
  • Llama-Factory 是否支持 FlashAttention 加速
  • 无需部署服务器:内网穿透实现本地服务对外演示
  • ToDesk 集成 ToClaw:AI Agent 融入日常办公流
  • 2026 年学术写作辅助工具指南:降低 AIGC 痕迹的实用方案
  • Java 企业人事工资管理系统设计与实现
  • 降低 AIGC 疑似度:7 个实用技巧与专业工具案例
  • Kafka ISR 与 AR 深度解析:副本同步机制核心概念
  • 大模型的 6 项核心技术:Transformer、预训练与 RLHF 等
  • OpenClaw:AI 直接操控电脑工具使用指南
  • 前端API设计最佳实践:让你的API更优雅
  • 多模态大模型 VLM Unlearning 技术路线论文梳理
  • Java + AI 混合编程落地实施方案
  • C++ Lambda 表达式详解:语法、捕获与底层原理
  • 2026 年 2 月 AIGC 行业模型发布与前沿资讯汇总
  • Python 基础语法详解
  • 未来考研就业前景最好的十大专业推荐

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如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