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

Stable Diffusion WebUI 云服务器部署实战

综述由AI生成在本地硬件受限的情况下,利用带 GPU 的云服务器部署 Stable Diffusion WebUI 是低成本体验 AI 绘画的高效方案。基于 Ubuntu 环境,详细梳理了从选择实例、配置 Python 虚拟环境到启动服务的完整流程。重点讲解了如何通过镜像源加速模型下载、优化显存占用的启动参数,以及解决网络代理、依赖冲突、Git 权限等常见部署坑点。通过合理配置 xformers 和跳过环境预检,可显著提升生成效率并降低维护成本。

栈溢出发布于 2026/4/12更新于 2026/5/2418 浏览
Stable Diffusion WebUI 云服务器部署实战

Stable Diffusion WebUI 云服务器部署实战

本地部署虽然灵活,但对硬件尤其是显存要求较高。利用带 GPU 的云服务器,不仅能以较低成本体验强大的 AI 绘画能力,还能随时随地通过浏览器访问,非常适合开发测试与轻量级应用。

一、部署前的准备

1. 选择合适的云服务器

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

2. 环境配置

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

示例环境选用 Ubuntu + RTX3090(显存 24G),搭配 Python 3.10.6 + Miniconda。

二、项目部署流程

1. 获取项目代码

克隆官方仓库:

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

若遇到网络问题,也可以手动下载 zip 压缩包上传。核心文件包括 webui.sh(启动脚本)和 launch.py(程序入口),启动时会按照 modules/launch_utils.py 的流程配置环境。

2. 性能优化

启动前安装 libgoogle-perftools4 和 libtcmalloc-minimal4 库,有助于优化程序性能:

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

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:让服务器监听所有网络接口,允许局域网甚至公网访问(需确保安全)。
  • --enable-insecure-extension-access:允许扩展访问本地文件系统,部分社区扩展需要此权限,但存在安全风险,仅在信任扩展时启用。
  • --xformers:启用 xFormers 优化,降低显存占用并提升生成速度,仅支持 NVIDIA GPU。

4. 部署细节

启动后目录中会多出一个 stable-diffusion-webui 文件夹用于存放环境依赖,注意区分它与项目根目录。 如果使用 conda 而非 venv 创建虚拟环境,需要将 webui.sh 中的 use_venv 变量值从 1 改为 0。

三、常见避坑指南

部署过程中难免遇到各种坑,以下是高频问题的解决方案:

1. 网络与依赖失败

  • 环境配置失败:检查云主机联网状态及带宽。若需代理,可在 modules/launch_utils.py 中所有 https://github.com/xxx.git 链接前添加 https://mirror.ghproxy.com/。
  • CLIP 与 PyTorch 安装失败:可能是 GitHub 下载太慢,尝试添加代理或离线安装。
  • Stability-AI 仓库失效:原地址 Stability-AI/stablediffusion 已不存在,需在 modules/launch_utils.py 中将链接替换为 CompVis/stable-diffusion 或 w-e-w/stablediffusion。
  • 手动克隆修复:若自动拉取仍失败,可在 repositories 目录下手动执行:
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 报错。

2. 磁盘与权限

  • 磁盘空间不足:部分包占用较大,考虑扩充磁盘空间。
  • Root 用户限制:默认禁止 root 启动。个人使用可直接将 can_run_as_root=0 改为 1,或注释相关脚本;生产环境建议创建新用户。

3. 版本兼容性

  • NumPy 版本冲突:若报错 A module that was compiled using NumPy 1.x cannot be run in NumPy 2.x,请降级 NumPy:
pip install "numpy<2"
  • 缺失依赖:若缺少 pytorch_lightning 或 gradio,可使用 pip install pytorch_lightning gradio 补全。若使用了 --skip-prepare-environment 跳过预检,记得运行 pip install -r requirements_versions.txt 补全依赖。

4. Git 认证

克隆私有或受限仓库时,密码处应输入 Personal Access Token (PAT) 而非账号密码。在 GitHub 设置中生成令牌并赋予 public_repo 权限即可。

通过以上步骤,基本可以覆盖 90% 以上的部署问题。保持耐心,根据报错信息灵活调整,通常都能顺利跑通。

目录

  1. Stable Diffusion WebUI 云服务器部署实战
  2. 一、部署前的准备
  3. 1. 选择合适的云服务器
  4. 2. 环境配置
  5. 二、项目部署流程
  6. 1. 获取项目代码
  7. 2. 性能优化
  8. 3. 启动项目
  9. 4. 部署细节
  10. 三、常见避坑指南
  11. 1. 网络与依赖失败
  12. 2. 磁盘与权限
  13. 3. 版本兼容性
  14. 4. Git 认证
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • 转行 AI 行业职场人访谈:从互联网到 AIGC 的转型之路
  • Ubuntu 下 llama.cpp 编译与性能调优实战
  • Web-Rooter:基于 IR + Lint 模式的 AI Agent 联网工具
  • LangChain 核心概念与架构详解
  • CPP Summit 2020 学习笔记:系统架构与设计
  • FPGA 车牌识别与 Modelsim 仿真:基于 Artix-7 硬件实现
  • 使用 CSS 实现毛玻璃模糊背景效果
  • WebCode 与 Clawdbot 项目深度对比分析
  • Spring Cloud Feign 入门实战:声明式 HTTP 客户端详解
  • Flutter 三方库 whatsapp_bot_flutter 鸿蒙适配与实战指南
  • Spring Cloud 初探:微服务架构演进与核心组件
  • Java 模拟算法题目解析
  • 基于 AI + Remotion + n8n 构建全自动视频生成流水线
  • 几款支持免费额度的 AI UI 设计工具推荐
  • Web 自动化测试入门:从概念到 Selenium 实战
  • JDK 21 核心新特性深度解析与实践
  • OpenClaw Skills 框架解析与开发实战
  • AI 时代产品落地全流程:从需求挖掘到灰度发布实战
  • 近半年无人机与大模型结合的 8 项硬核研究
  • 轻量级C++插件框架设计与实现

相关免费在线工具

  • 加密/解密文本

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