Sygil-WebUI Linux 系统安装与配置完全指南

Sygil-WebUI Linux 系统安装与配置完全指南

sygil-webui Stable Diffusion web UI 项目地址: https://gitcode.com/gh_mirrors/sy/sygil-webui

前言

Sygil-WebUI 是一个基于 Stable Diffusion 模型的 Web 用户界面，为 Linux 用户提供了完整的 AI 图像生成解决方案。本文将详细介绍在 Linux 系统上安装和配置 Sygil-WebUI 的完整流程，帮助用户快速搭建自己的 AI 创作环境。

系统要求

在开始安装前，请确保您的系统满足以下基本要求：

• 64位 Linux 操作系统（推荐 Ubuntu 20.04/22.04 或兼容发行版）
• 至少 16GB 系统内存（推荐 32GB 或更高）
• NVIDIA GPU 显存至少 4GB（推荐 8GB 或更高）
• 已安装最新版 NVIDIA 驱动和 CUDA 工具包
• 至少 20GB 可用磁盘空间（用于模型和依赖项）

安装准备

1. 安装 Anaconda

Sygil-WebUI 依赖 Python 环境，推荐使用 Anaconda 进行管理：

# 下载最新版 Anaconda 安装脚本
wget https://repo.anaconda.com/archive/Anaconda3-latest-Linux-x86_64.sh

# 运行安装脚本
bash Anaconda3-latest-Linux-x86_64.sh

# 按照提示完成安装后，更新 conda
conda update -n base -c defaults conda

注意：有用户报告 Miniconda 可能存在问题，建议使用完整版 Anaconda。

2. 准备 Stable Diffusion 模型文件

从合法渠道获取 Stable Diffusion 1.4 模型文件（通常为 .ckpt 或 .safetensors 格式），建议放置在专用目录中。

自动化安装流程

Sygil-WebUI 提供了自动化安装脚本，简化了安装过程：

1. 获取安装脚本

# 创建项目目录
mkdir -p ~/sygil-webui
cd ~/sygil-webui

# 下载安装脚本
wget -O linux-sd.sh [脚本下载地址]
chmod +x linux-sd.sh

2. 运行安装脚本

./linux-sd.sh

脚本将执行以下操作：

1. 克隆 Sygil-WebUI 仓库
2. 提示用户放置模型文件
3. 配置运行参数
4. 创建 conda 虚拟环境
5. 安装所有依赖项

3. 模型文件处理

当脚本提示时，将准备好的模型文件移动到 sygil-webui/models/ldm/stable-diffusion-v1/ 目录下，并重命名为 model.ckpt。

配置选项详解

安装过程中，脚本会提供多项配置选项：

1. 性能优化选项

• CPU 上采样：将部分计算任务转移到 CPU，节省 VRAM
• 优化模式：4GB VRAM 模式，牺牲速度换取低显存占用
• Turbo 模式：更高的 VRAM 占用但速度更快

2. 界面选项

• 自动打开浏览器：首次启动时自动打开 Web 界面
• 公开访问：生成 gradio.app 公开链接（注意安全风险）

两种界面模式选择

Sygil-WebUI 提供两种用户界面：

1. Streamlit 界面（推荐）

• 现代化 UI 设计
• 正在积极开发中
• 未来将作为主界面
• 功能正在逐步完善

2. Gradio 界面

• 功能完整稳定
• 传统界面风格
• 不再接收重大更新

常见问题解决

1. 安装卡在 PIP 依赖项

如果安装过程在 "Installing PIP Dependencies" 步骤卡住超过 10 分钟：

1. 按 Ctrl+C 终止脚本
2. 删除 src 目录
3. 重新运行安装脚本

2. 显存不足问题

尝试以下解决方案：

1. 启用优化模式（4GB VRAM）
2. 使用 CPU 上采样
3. 降低生成图像分辨率
4. 减少 batch size

3. 环境重建

如需重建 conda 环境：

conda env remove -n ldm
./linux-sd.sh

进阶配置

1. 自定义启动参数

编辑 webui.sh 文件可调整以下参数：

• --precision：计算精度（full/fautocast）
• --optimized：优化模式
• --port：Web 服务端口
• --share：是否生成公开链接

2. 模型管理

• 自定义模型放置在 models/ldm/stable-diffusion-v1/ 目录
• 多个模型可通过修改文件名切换使用
• 推荐使用 .safetensors 格式更安全

使用建议

1. 定期更新：使用脚本时可选择更新选项获取最新功能
2. 资源监控：使用 nvidia-smi 监控 GPU 使用情况
3. 输出管理：生成图片默认保存在 outputs/ 目录
4. 备份配置：定期备份 configs/ 目录下的配置文件

结语

通过本指南，您应该已经成功在 Linux 系统上安装并配置了 Sygil-WebUI。这个强大的工具将为您打开 AI 艺术创作的大门。随着项目的持续发展，建议关注官方渠道获取最新功能和改进。祝您创作愉快！

sygil-webui Stable Diffusion web UI 项目地址: https://gitcode.com/gh_mirrors/sy/sygil-webui