Linux-Ubuntu安装Stable Diffusion Forge [复制链接]
发表于 2025-8-6 19:31:13 | 显示全部楼层 |阅读模式
SD Forge在Win上配置起来相对简朴且教程丰富,而在Linux平台的配置则稍有门槛且教程较少。本文提供一个基于Ubuntu24.04发行版(对其他Linux以及SD分支亦有参考价值)的Stable Diffusion ForgeUI安装配置教程,希望有所帮助

本教程以NVIDIA显卡为例介绍安装方法,AMD显卡没尝试过,或许也有用。

先决条件

安装NVIDIA显卡驱动

下令终端运行
  1. nvidia-smi
复制代码
若显示以下画面,代表已安装显卡驱动,可跳过本步骤

若未安装,在应用栏找到软件和更新—附加驱动,安装专有驱动,重启电脑。若无版本依靠,发起与本教程一致(575版本
安装CUDA 驱动和 cuDNN

为顺遂进行后续步骤,安装的CUDA版本应不低于12.1。若无版本依靠,发起与本教程保持一致(12.8版本)。执行“nvidia-smi”下令可查看驱动支持的最高版本。比方,上图所示的显卡驱动最高可支持CUDA12.9版本。
本文的重点是Forge安装,CUDA安装的相关教程丰富且详细,请自行查阅,这里就不赘述了
安装CUDA后,终端运行以下代码查看是否安装乐成
  1. nvcc -V
复制代码
终端输出以下字样则安装乐成,否则查抄一下是否未精确配置情况变量

安装cuDNN后,终端运行以下代码查看是否安装乐成
  1. # cuda版本需修改为与实际一致
  2. cat /usr/local/cuda-12.8/include/cudnn_version.h | grep CUDNN_MAJOR -A 2
复制代码
若终端输出以下字样则安装乐成(cannot告诫不必理会),否则查抄一下cudnn的文件位置是否精确

克隆项目

选取合适位置打开终端运行以下代码将SD Forge压缩克隆到本地并解压。假如下载速率缓慢,可能必要配置网络
  1. sudo apt update
  2. sudo apt install git
  3. git clone https://github.com/lllyasviel/stable-diffusion-webui-forge.git
复制代码
配置Python虚拟情况

安装并配置pyenv

为避免污染Ubuntu24自带的Python情况,SD Forge的Python依靠及Pytorch均需在虚拟情况安装。本教程的虚拟情况基于pyenv配置,pyenv的安装与使用可参考像在Windows里面一样丝滑使用Ubuntu24.04里面的“安装vscode并配置python虚拟情况”章节(看前两部门即可,其他部门不消管)
除非比力相识conda(假如这么做,需自行修改后续教程的部门配置方法),否则发起与本教程保持一致——使用pyenv创建虚拟情况
安装Python3.10.2

进入“stable-diffusion-webui-forge”目次,打开终端运行以下代码下载并配置Python3.10.2(SD Forge依靠Python3.10,其他版本可能会有依靠题目(3.10子版本则没有限制)。若无版本依靠,发起同本教程保持一致)
  1. pyenv install 3.10.2
  2. pyenv virtualenv 3.10.2 ForgeEnv
  3. pyenv activate ForgeEnv
复制代码
乐成安装并激活Python3.10.2虚拟情况后在用户名前会显示(ForgeEnv) 字样。勿关闭该终端,背面还会用到
安装依靠

在上一节配置的虚拟情况中运行以下代码安装SD Forge依靠。假如下载缓慢,可参考像在Windows里面一样丝滑使用Ubuntu24.04中“安装vscode并配置python虚拟情况”章节的其他说明(2),手动添加清华镜像源加快下载
  1. pip install --upgrade pip
  2. pip install -r requirements_versions.txt
复制代码
安装pytorch与xformers

  1. pip install torch==2.3.1 torchvision==0.18.1 torchaudio==2.3.1
  2. pip install xformers==0.0.27
复制代码
留意,torch, torchvision, torchaudio与xformers有版本依靠。除非清楚其匹配关系,否则不要修改上述代码中的版本号。
启动文件配置(重点)

打开stable-diffusion-webui-forge文件夹,找到“webui-user.sh”文件不是webui.sh,别搞混了)
用文件编辑器打开webui-user.sh,将全文替换为以下代码并根据实际情况修改后保存关闭(看解释,部门配置必须结合实际情况修改
  1. #!/bin/bash
  2. #########################################################
  3. #                     虚拟环境自动激活                   #
  4. #########################################################
  5. # 本部分代码用于运行webui.sh文件时自动激活配置的python虚拟环境
  6. # 本部分代码删除后不影响使用,但每次打开Forge前都必须在控制台手动输入pyenv activate ForgeEnv激活虚拟环境
  7. # 自动激活只适用PYENV配置的虚拟环境,conda用户需根据实际情况修改本部分代码(或直接删除,每次打开采用手动激活)
  8. # 配置虚拟环境路径
  9. PYENV_ROOT="$HOME/.pyenv"
  10. VENV_NAME="ForgeEnv"
  11. # 加载 Shell 配置
  12. source ~/.bashrc
  13. # 显式初始化 Pyenv 和 Pyenv-Virtualenv
  14. export PYENV_ROOT="$HOME/.pyenv"
  15. export PATH="$PYENV_ROOT/bin:$PATH"
  16. eval "$(pyenv init -)"                
  17. eval "$(pyenv virtualenv-init -)"   
  18. # 激活虚拟环境
  19. pyenv activate "$VENV_NAME" || { echo "错误:虚拟环境激活失败!"; exit 1; }
  20. #########################################################
  21. #                      常规配置                          #
  22. #########################################################
  23. # 路径配置
  24. install_dir="/home/$(whoami)" # 使用默认用户目录, 如果不是,需指定
  25. # SD目录名
  26. clone_dir="stable-diffusion-webui-forge" # 若不是这个名字,需根据实际修改
  27. # python3 executable
  28. python_cmd="$HOME/.pyenv/shims/python"  # 解释器如果不在这里,需根据实际情况修改
  29. # git executable
  30. # export GIT="git" # git配置可以不管
  31. # python3 venv without trailing slash (defaults to ${install_dir}/${clone_dir}/venv)
  32. venv_dir="$HOME/.pyenv/versions/ForgeEnv"  # 虚拟环境如果不是这个,需根据实际情况修改
  33. # script to launch to start the app
  34. export LAUNCH_SCRIPT="launch.py" # 不需修改
  35. # 安装指定版本的深度学习框架, 若需修改, 需保证与xformers版本匹配
  36. export TORCH_COMMAND="pip install torch==2.3.1 torchvision==0.18.1 torchaudio==2.3.1" # 这是一个版本组合, 请勿单独修改某一项的版本
  37. # 依赖项, 一般不需修改,若遇到依赖问题, 或需修改txt文件里面的库版本号
  38. export REQS_FILE="requirements_versions.txt"
  39. # Fixed git repos  # git配置可以不管
  40. # export K_DIFFUSION_PACKAGE=""
  41. # export GFPGAN_PACKAGE=""
  42. # Fixed git commits  # git配置可以不管
  43. # export STABLE_DIFFUSION_COMMIT_HASH=""
  44. # export CODEFORMER_COMMIT_HASH=""
  45. # export BLIP_COMMIT_HASH=""
  46. # 启用加速
  47. export ACCELERATE="True"  # 不需修改
  48. # 内存相关,懒得配置TCMALLOC了,直接关
  49. export NO_TCMALLOC="True"
  50. # 设置过网络环境的需加上
  51. export ALL_PROXY=''
  52. export all_proxy=''
  53. #########################################################
  54. #                启动参数配置(含模型共享)                #
  55. #########################################################
  56. MODEL_DIR="/除controlnet外的其他模型位置/models" # 如果不需共享模型,删除本行、下行及COMMANDLINE_ARGS里面从--ckpt-dir(含上一行末尾的\符号)直到倒数第二个引号的内容
  57. CONTROLNET_DIR="controlnet模型位置/extensions"  # 注意,controlnet相关模型在插件里
  58. #  如果共享失败,检查源文件位置(尤其是大小写)以及除号和反除号是否设置正确
  59. # ckpt, vae,lora;clip, esrgan,gfpgan;controlnet这三类模型共享参数配置不一样,注意区分
  60. export COMMANDLINE_ARGS="--xformers \
  61. --server-name 127.0.0.1 \
  62. --port 7860 \
  63. --enable-insecure-extension-access \
  64. --ckpt-dir="$MODEL_DIR/Stable-diffusion" \
  65. --clip-models-path="$MODEL_DIR/CLIP" \
  66. --vae-dir="$MODEL_DIR/VAE" \
  67. --esrgan-models-path="$MODEL_DIR/ESRGAN" \
  68. --gfpgan-models-path="$MODEL_DIR/GFPGAN" \
  69. --lora-dir="$MODEL_DIR/Lora" \
  70. --controlnet-dir="$CONTROLNET_DIR/sd-webui-controlnet"" # 配置显存优化, ip地址与端口,插件等启动参数。如果需安装多个sd, 每个sd的ip端口号不能相同
  71. # 为防止路径有空格,路径加了引号转义
  72. ###########################################
复制代码
启动SD Forge

启动前发起先手动下载或共享大模型到指定目次,否则等待时间特别长
文件运行授权

stable-diffusion-webui-forge文件夹打开终端,执行以下下令添加运行权限(仅初次运行需授权)
  1. chmod +x webui.sh
  2. chmod +x webui-user.sh
复制代码
激活虚拟情况

若在启动文件精确配置了虚拟情况自动激活,本步骤可跳过,否则每次打开ForgeUI前都需在stable-diffusion-webui-forge文件夹打开终端述运行下述代码以激活虚拟情况
  1. pyenv activate ForgeEnv
复制代码
运行启动文件

若没有在启动文件配置虚拟情况自动激活,则需在虚拟情况(上一节打开的终端中)运行下述代码以打开Forge
  1. ./webui.sh
复制代码
若已在启动文件精确配置了虚拟情况自动激活,则在stable-diffusion-webui-forge文件夹打开终端述运行上述代码即可
启动后终端会显示“Running on local URL:http://127.0.0.1:7860”字样,按住ctrl后点击“http://127.0.0.1:7860”即可打开SD Forge的UI网页

最后的说明

完成上述全部配置步骤后,以后只需在stable-diffusion-webui-forge文件夹打开终端述执行启动文件即可启动SD ForgeUI
未配置虚拟情况自动激活

  1. pyenv activate ForgeEnv
  2. ./webui.sh
复制代码
已精确配置虚拟情况自动激活

  1. ./webui.sh
复制代码
ok,SD Forge安装配置全部竣事,May this guide serve as your gateway to a seamless and empowering journey with SD Forge on Linux, where creativity meets cutting-edge technology
放张图


  1. 1girl,violet evergarden,full body,solo,blonde hair,blue eyes,sky,red ribbon,hair between eyes,jewelry,blue jacket,ribbon,outdoors,day,hair ribbon,looking at viewer,jacket,blue sky,brooch,cloud,bangs,blur,white,background intakes,bride,brideDusk,facing the audience,long legs,white silk,
  2. Negative prompt: (worst quality, low quality:1.4),(depth of field, blurry:1.2),(greyscale, monochrome:1.1),3D face,cropped,lowres,text,(nsfw:1.3),(worst quality:2),(low quality:2),(normal quality:2),normal quality,((grayscale)),skin spots,acnes,skin blemishes,age spot,(ugly:1.331),(duplicate:1.331),(morbid:1.21),(mutilated:1.21),(tranny:1.331),mutated hands,(poorly drawn hands:1.5),blurry,(bad anatomy:1.21),(bad proportions:1.331),extra limbs,(disfigured:1.331),(missing arms:1.331),(extra legs:1.331),(fused fingers:1.61051),(too many fingers:1.61051),(unclear eyes:1.331),lowers,bad hands,missing fingers,extra digit,bad hands,missing fingers,(((extra arms and legs))),
  3. Steps: 28, Sampler: DPM++ 2M, Schedule type: Karras, CFG scale: 7, Seed: 3605002200, Size: 1024x1024, Model hash: 30953ab0de, Model: 动漫MeinaMix_MeinaV8, Denoising strength: 0.42, Clip skip: 2, ADetailer model: face_yolov8n.pt, ADetailer confidence: 0.3, ADetailer dilate erode: 4, ADetailer mask blur: 4, ADetailer denoising strength: 0.4, ADetailer inpaint only masked: True, ADetailer inpaint padding: 32, ADetailer version: 24.9.0, Hires Module 1: Use same choices, Hires CFG Scale: 7, Hires upscale: 2, Hires steps: 5, Hires upscaler: R-ESRGAN 4x+ Anime6B, Version: f2.0.1v1.10.1-previous-662-g0ced1d0c, Module 1: vae-ft-mse-840000-ema-pruned
复制代码



免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

×
回复

使用道具 举报

登录后关闭弹窗

登录参与点评抽奖  加入IT实名职场社区
去登录
快速回复 返回顶部 返回列表