Stable Diffusion 与 kohya_ss 安装指南

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），用户可通过浏览器直接使用。

安装完成后的界面示例如下：

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 即可。

出现以下内容即表明运行成功：

* 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.