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

Stable Diffusion 与 Kohya_ss 安装指南

Stable Diffusion WebUI 及 Kohya_ss 工具的详细安装流程。首先通过 Conda 环境配置并克隆 WebUI 仓库,修改配置文件指定 Python 路径后启动。随后讲解 Kohya_ss 的两种安装方式(uv 或 pip),包括依赖安装与 GUI 启动。最后提供常见问题的解决方案,如缺失 python3-tk 包及代理配置错误处理。适用于 Linux 环境下进行 AI 模型微调训练准备。

二进制发布于 2026/4/6更新于 2026/5/2026 浏览
Stable Diffusion 与 Kohya_ss 安装指南
工具简介
  • Stable Diffusion (SD): 开源的文本到图像生成模型,支持通过提示词生成高质量图像,内置自动标注功能(如 BLIP、DeepBooru 等)。
  • Kohya_ss (KS): 基于 SD 的轻量级微调工具,支持 LoRA、DreamBooth 等训练方法,优化显存占用与训练效率。
一、SD WebUI 的安装

Stable Diffusion 可通过 GitHub 仓库下载:

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

基础版本提供核心功能,如需扩展功能需安装相关插件。

1. 准备 Conda 环境
1.1 创建并激活 Conda 环境
# 创建名为 sd-webui 的环境(Python 3.10 推荐,需匹配仓库要求)
conda create -n sd-webui python=3.10 -y
# 激活环境
conda activate sd-webui
1.2 确认 Python 路径

记录当前 Conda 环境的 Python 路径(后续配置需要):

which python
# 示例输出:/home/用户名/miniconda3/envs/sd-webui/bin/python
2. 下载仓库代码
# 克隆仓库
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
cd stable-diffusion-webui
# 指定下载路径(可选)
# git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git 你指定的下载路径
3. 配置 WebUI 以使用 Conda 环境
3.1 编辑配置文件

在 webui-user.sh 中添加或修改以下内容(根据实际路径调整):

# 复制默认配置文件(若不存在)
cp webui-user.sh webui-user.sh.bak
# 备份(可选,建议备份)
nano webui-user.sh
3.2 修改关键配置

在 webui-user.sh 中添加或修改以下内容:

# 指定 Conda 环境的 Python 路径(替换为步骤 1.2 中获取的路径)
python_cmd="/home/用户名/miniconda3/envs/sd-webui/bin/python"
# 禁用自动创建虚拟环境(使用 Conda 环境而非 venv)
venv_dir="-"
# 可选:添加启动参数(如低显存模式)
export COMMANDLINE_ARGS="--medvram --opt-split-attention"
3.3 保存并退出

按 Ctrl+O 保存,Ctrl+X 退出编辑器。

4. 安装依赖并启动
4.1 运行安装脚本
./webui.sh

运行该命令后,脚本会自动检测 Conda 环境并安装 requirements.txt 和 requirements_versions.txt 中的依赖。针对 PyTorch 适配问题(如 AMD 显卡),会根据 GPU 型号自动设置 TORCH_COMMAND。安装完成后终端将显示访问地址(通常为 http://127.0.0.1:7860),用户可通过浏览器直接使用。

下图展示了安装完成后的 WebUI 界面。示例中包含部分插件,不影响基础功能使用。

文章配图

5. 启动步骤
# 每次启动前激活 Conda 环境
conda activate sd-webui
# 进入仓库目录并启动
cd stable-diffusion-webui
./webui.sh

建议将上述启动命令保存为脚本文件,以便快速执行。

二、Kohya_ss 的安装

Kohya_ss 仓库地址如下:

https://github.com/bmaltais/kohya_ss

方法一:uv 安装
1. 克隆仓库(含子模块)
# 克隆仓库并进入目录
git clone --recursive https://github.com/bmaltais/kohya_ss.git
cd kohya_ss
2. 运行安装脚本
# 执行 uv 安装脚本
./gui-uv.sh
方法二:pip 安装
1. 克隆仓库(含子模块)
git clone --recursive https://github.com/bmaltais/kohya_ss.git
cd kohya_ss
2. 安装依赖(可选 Conda 环境)

选项 A:使用系统 Python 或 venv

# 赋予脚本执行权限并运行 setup.sh
chmod +x setup.sh
./setup.sh

选项 B:使用 Conda 环境(推荐)

# 创建并激活 Conda 环境(Python 3.11)
conda create -n kohyass python=3.11
conda activate kohyass
# 运行安装脚本
chmod +x setup.sh
./setup.sh
3. 启动 GUI
# 赋予执行权限并启动
chmod +x gui.sh
./gui.sh

启动后,若看到类似 Running on http://0.0.0.0:7860 的输出,说明安装成功,可通过浏览器访问该地址使用 GUI。

文章配图

可能出现的问题
1. 缺少 python3-tk 依赖包
Skipping git operations. Ubuntu detected. This script needs YOU to install the missing python3-tk packages. Please install with: sudo apt update -y && sudo apt install -y python3-tk

如果出现上述错误,只需安装缺失的包即可:

sudo apt update -y && sudo apt install -y python3-tk
2. 不支持 socks 协议的代理 URL
ValueError: Unknown scheme for proxy URL URL('socks://127.0.0.1:7897/')

通过终端配置环境变量解决。

1. 确定你的 shell 是 bash 还是 zsh
# 在终端执行以下命令,会显示当前 shell 的进程名:
echo $SHELL
  • 输出 /bin/bash → 当前默认是 bash
  • 输出 /bin/zsh → 当前默认是 zsh
2. 编辑配置文件
# bash 用户
nano ~/.bashrc
# zsh 用户
nano ~/.zshrc
3. 添加 HTTP 代理配置
# 设置 HTTP 代理
export http_proxy="http://127.0.0.1:7897"
export https_proxy="http://127.0.0.1:7897"

将最后的'7897'换成你自己的代理地址端口号,保存退出。

4. 生效配置
# bash 用户
source ~/.bashrc
# zsh 用户
source ~/.zshrc
5. 编辑 gui.sh 文件
nano gui.sh

在脚本最顶部(第一行 #!/bin/bash 下方)添加以下内容:

#!/bin/bash
# 清除可能的残留代理
unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY all_proxy ALL_PROXY
# 强制设置 HTTP 代理(按实际端口修改,比如你的代理 HTTP 端口是 7897 就改这里)
export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"
# 脚本原本的其他内容(保持不变)
...

保存退出,重新运行 gui.sh:

./gui.sh

若显示以下输出,表示服务启动成功:

* Running on local URL: http://127.0.0.1:7860
* To create a public link, set `share=True` in `launch()`.
^CKeyboard interruption in main thread... closing server.

目录

  1. 工具简介
  2. 一、SD WebUI 的安装
  3. 1. 准备 Conda 环境
  4. 1.1 创建并激活 Conda 环境
  5. 创建名为 sd-webui 的环境(Python 3.10 推荐,需匹配仓库要求)
  6. 激活环境
  7. 1.2 确认 Python 路径
  8. 示例输出:/home/用户名/miniconda3/envs/sd-webui/bin/python
  9. 2. 下载仓库代码
  10. 克隆仓库
  11. 指定下载路径(可选)
  12. git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git 你指定的下载路径
  13. 3. 配置 WebUI 以使用 Conda 环境
  14. 3.1 编辑配置文件
  15. 复制默认配置文件(若不存在)
  16. 备份(可选,建议备份)
  17. 3.2 修改关键配置
  18. 指定 Conda 环境的 Python 路径(替换为步骤 1.2 中获取的路径)
  19. 禁用自动创建虚拟环境(使用 Conda 环境而非 venv)
  20. 可选:添加启动参数(如低显存模式)
  21. 3.3 保存并退出
  22. 4. 安装依赖并启动
  23. 4.1 运行安装脚本
  24. 5. 启动步骤
  25. 每次启动前激活 Conda 环境
  26. 进入仓库目录并启动
  27. 二、Kohya_ss 的安装
  28. 方法一:uv 安装
  29. 1. 克隆仓库(含子模块)
  30. 克隆仓库并进入目录
  31. 2. 运行安装脚本
  32. 执行 uv 安装脚本
  33. 方法二:pip 安装
  34. 1. 克隆仓库(含子模块)
  35. 2. 安装依赖(可选 Conda 环境)
  36. 赋予脚本执行权限并运行 setup.sh
  37. 创建并激活 Conda 环境(Python 3.11)
  38. 运行安装脚本
  39. 3. 启动 GUI
  40. 赋予执行权限并启动
  41. 可能出现的问题
  42. 1. 缺少 python3-tk 依赖包
  43. 2. 不支持 socks 协议的代理 URL
  44. 1. 确定你的 shell 是 bash 还是 zsh
  45. 在终端执行以下命令,会显示当前 shell 的进程名:
  46. 2. 编辑配置文件
  47. bash 用户
  48. zsh 用户
  49. 3. 添加 HTTP 代理配置
  50. 设置 HTTP 代理
  51. 4. 生效配置
  52. bash 用户
  53. zsh 用户
  54. 5. 编辑 gui.sh 文件
  55. 清除可能的残留代理
  56. 强制设置 HTTP 代理(按实际端口修改,比如你的代理 HTTP 端口是 7897 就改这里)
  57. 脚本原本的其他内容(保持不变)
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • 数据产品经理与 AI 产品经理的核心区别与发展前景
  • Llama-2-7b 在昇腾 NPU 上的六大核心场景性能基准
  • 8 款值得推荐的 WPF UI 控件库
  • Web 开发者构建多模态 Agent 图像识别技能全栈方案
  • OpenClaw 接入飞书机器人并集成 Ollama 本地大模型实战
  • 深度解析 RAG:核心优化方法与实施策略
  • 国内大模型公司面试经历与技术复盘
  • Ubuntu 24.04 安装及配置 ToDesk 远程桌面
  • Qwen3-TTS 多语种语音合成:Python API 调用与 WebUI 双模式指南
  • 滑动窗口算法实战:最大连续 1 的个数 III 与将 x 减到 0 的最小操作数
  • 二分查找实战:寻找峰值、旋转数组及缺失数字
  • JWT 认证机制下的越权漏洞分析与渗透测试实践
  • 2024 年中国大模型行业应用案例白皮书概览
  • Flutter 三方库 bavard 在鸿蒙系统的适配指南:聊天协议与机器人逻辑
  • C++ 汉诺塔问题详解与代码实现
  • LeetCode 滑动窗口算法详解:核心思路与实战案例
  • Visual C++ Redistributable 安装问题解决方案
  • 面试薪资谈判遭HR贬低:如何建立平等的职场关系
  • GitHub 精选:LLM 管道优化与 AI 聊天框架工具指南
  • 基于 Document Picture-in-Picture API 实现视频小窗与主页面同步控制

相关免费在线工具

  • 加密/解密文本

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