WebUI 安装方式
根据现有文件、Python 环境和快照情况选择正确的实例来源。
在 Hanafubuki 中,一个“实例”由实例记录、实例根目录、独立 Python 和 WebUI Core 组成。首页点击“添加实例”后,可以选择四种来源;它们对现有文件的处理方式不同。
安装前检查
开始前建议确认:
- 首次启动的 Python、Micromamba 和 Git 已准备完成;异常时先打开“设置 → 运行环境”。
- 网络能够访问需要的代码仓库和软件包来源,或已经配置可用的网络与代理和镜像。
- 目标磁盘有足够空间,并允许当前用户创建、修改和删除文件。
- 模型、输出和自定义代码已有独立备份;环境快照不包含这些文件的完整副本。
选择实例来源
| 来源 | 适合什么情况 | 是否安装环境 | 对现有文件的影响 |
|---|---|---|---|
| 全新安装 | 没有现成 WebUI,希望从头创建 | 下载独立 Python、Core 和依赖 | 应使用新的专用实例目录 |
| 导入现有实例 | 已知现有根目录、Core 和独立 Python | 不重新安装,导入后直接就绪 | 只引用原路径;后续管理操作可能修改这些文件 |
| 扫描系统 | 不确定 WebUI 位于哪里,或只有 Core | 完整实例直接就绪;缺少 Python 的实例等待安装 | 扫描阶段只读取;后续补装可能修改发现的 Core |
| 从快照恢复 | 已有环境快照 JSON,希望重建环境 | 按快照准备 Python、代码、包和扩展 | 会清理目标环境并强制重置目标 Git 仓库 |
最简单的选择
第一次使用请选择“全新安装”并保留默认选项。已有能运行的独立 Python 和 WebUI 时选择“导入现有实例”;只有代码目录或不确定目录结构时使用“扫描系统”。
支持的 WebUI
| 类型 | 主要用途 | 来源 |
|---|---|---|
| Stable Diffusion WebUI | 基于 Gradio 的图像生成界面 | 10 个变体 |
| ComfyUI | 节点式生成工作流 | Comfy-Org/ComfyUI |
| InvokeAI | 带统一画布的图像创作工具 | PyPI 软件包 invokeai |
| Fooocus | 简化的图像生成流程 | 3 个变体 |
| SD Trainer | LoRA 与模型训练 | 3 个变体 |
| Qwen TTS WebUI | 文本转语音 | licyk/qwen-tts-webui |
| RVC Next WebUI | 语音转换与实时变声 | licyk/rvc-next-webui |
| Mizuoto TTS WebUI | 多引擎文本转语音 | licyk/mizuoto-tts-webui |
选择的类型决定安装器、默认 Python、PyTorch 选项以及安装后可用的管理功能。不要只按目录名称猜测类型。
支持的变体
Stable Diffusion WebUI、Fooocus 和 SD Trainer 各自提供一组变体:每个变体是一组固定的仓库、分支和子模块设置。全新安装时在“分支”中选择变体,安装后可在WebUI 变体页面切换。ComfyUI、Qwen TTS WebUI 和 RVC Next WebUI 只使用上表中的单一仓库;InvokeAI 以软件包形式安装,版本在WebUI 版本页面管理。
下表对应本版本 Hanafubuki 内置的 sd-webui-all-in-one。应用更新后列表可能变化,以安装向导和变体页面实际显示的内容为准。
Stable Diffusion WebUI 变体
| 变体 | 仓库 | 分支 | 子模块 |
|---|---|---|---|
| Stable-Diffusion-WebUI-Forge-Neo(默认) | Haoming02/sd-webui-forge-classic | neo | — |
| Stable-Diffusion-WebUI-Forge-Classic | Haoming02/sd-webui-forge-classic | classic | — |
| Stable-Diffusion-WebUI 主分支 | AUTOMATIC1111/stable-diffusion-webui | master | — |
| Stable-Diffusion-WebUI 测试分支 | AUTOMATIC1111/stable-diffusion-webui | dev | — |
| Stable-Diffusion-WebUI-Forge | lllyasviel/stable-diffusion-webui-forge | main | — |
| Stable-Diffusion-WebUI-reForge 主分支 | Panchovix/stable-diffusion-webui-reForge | main | — |
| Stable-Diffusion-WebUI-reForge 测试分支 | Panchovix/stable-diffusion-webui-reForge | dev | — |
| Stable-Diffusion-WebUI-AMDGPU | lshqqytiger/stable-diffusion-webui-amdgpu | master | — |
| SD.Next 主分支 | vladmandic/sdnext | master | 包含 |
| SD.Next 测试分支 | vladmandic/sdnext | dev | 包含 |
安装向导中的“默认分支”即 Forge-Neo。测试分支更新频繁,可能与扩展或模型工作流不兼容;AMDGPU 变体面向 AMD 显卡。
Fooocus 变体
| 变体 | 仓库 | 分支 | 子模块 |
|---|---|---|---|
| Fooocus | licyk/Fooocus | licyk_dev | — |
| RuinedFooocus | runew0lf/RuinedFooocus | main | — |
| Fooocus-MRE | MoonRide303/Fooocus-MRE | moonride-main | — |
“Fooocus”变体基于 lllyasviel 的原版 Fooocus,但使用 licyk 维护的分叉仓库。
SD Trainer 变体
| 变体 | 仓库 | 分支 | 子模块 |
|---|---|---|---|
| SD-Trainer | Akegarasu/lora-scripts | main | 包含 |
| SD Trainer Next | wochenlong/lora-scripts-next | main | 包含 |
| Kohya GUI | bmaltais/kohya_ss | master | 包含 |