Z-Image-Turbo WebUI 本地部署与使用指南
Z-Image-Turbo WebUI 是一个基于容器化技术的本地 AI 绘画工具,旨在简化环境配置流程。它预装了 Conda、PyTorch 及 CUDA 依赖,用户无需手动处理版本冲突或驱动问题,即可实现离线运行。
1. 快速启动
镜像最大的优势在于将部署过程压缩为一条命令。无论本地是否安装 Conda 或 Python,脚本会自动处理环境激活与模型加载。
1.1 执行启动脚本
在终端(Linux/macOS)或 WSL(Windows)中进入镜像根目录,执行:
bash scripts/start_app.sh
该脚本位于镜像内部,无需额外下载。执行后会自动激活 Conda 环境并启动服务。
启动成功时,终端会输出如下信息:
================================================== Z-Image-Turbo WebUI 启动中... ================================================== 模型加载成功!启动服务器:0.0.0.0:7860 请访问:http://localhost:7860
注意:模型已在后台静默加载完毕,服务就绪后即可响应请求,无需等待漫长的编译提示。
1.2 访问界面
浏览器地址栏输入 http://localhost:7860 即可访问。脚本已自动检测端口占用情况,通常无需修改 hosts 或 IP。
提示:首次访问可能需要数秒加载前端资源,后续刷新速度较快。
1.3 底层优化逻辑
该镜像并非简单的打包,而是针对性能做了三项关键调整:
- 环境固化:基于
miniconda3 + torch28 + CUDA 12.4定制,规避 Python 包冲突。 - 模型预热:内置
model.warmup()逻辑,首次生成前完成显存分配与计算图编译。 - 轻量路由:精简版 Gradio 后端,移除多余 API 与监控埋点,专注功能本身。
2. 核心操作
WebUI 界面简洁,主要包含三个标签页,日常使用集中在图像生成页。
2.1 中文提示词输入
正向提示词(Prompt)框支持原生中文语义理解,无需翻译或添加权重模板。
例如输入:
一只橘猫趴在窗台边,阳光斜射,毛发泛金光,高清摄影风格
点击右下角绿色闪电图标生成。默认输出为 1024×1024 高清图,细节表现稳定。
2.2 尺寸与风格预设
底部提供常用尺寸一键切换,避免手动计算宽高倍数:
1024×1024:默认高清方形,适合海报、印刷。横版 16:9:适配 B 站封面、PPT 背景。竖版 9:16:匹配手机锁屏、短视频平台。512×1024:快速草稿模式,测试提示词效率更高。
实测同一提示词下,512×512 模式耗时约 4 秒,1024×1024 约 16 秒,画质均满足发布需求。
2.3 负向提示词优化
新手常忽略负向提示词的作用,其实它能有效过滤常见缺陷。
建议粘贴以下通用负面描述:
低质量,模糊,扭曲,多余手指,畸形肢体,文字水印,边框,签名

