LiuJuan Z-Image Generator 本地部署与 8K 人像生成指南
LiuJuan Z-Image Generator 是一个专为定制化人像和场景图片生成而生的本地化解决方案。它基于强大的阿里云通义 Z-Image 扩散模型，并融合了经过调校的自定义权重。该工具将显存管理、权重适配等复杂问题打包解决，通过简洁的 Web 界面，让用户能在本地电脑上轻松创作。
1. 环境准备与一键启动
部署过程被封装成了一个完整的 Docker 镜像，无需手动安装 Python 环境或配置 CUDA。
1.1 获取工具镜像
确保已安装 Docker。在终端执行以下命令拉取镜像：
docker pull ZEEKLOGpractices/liujuan-z-image-generator:latest
镜像包含 PyTorch、CUDA 库、Streamlit 界面及所有必要的 Python 包。
1.2 启动生成器服务
运行下面的命令启动服务：
docker run -p 8501:8501 --gpus all ZEEKLOGpractices/liujuan-z-image-generator:latest
参数说明：
-p 8501:8501：映射容器内部 8501 端口到宿主机。--gpus all：允许容器使用宿主机的所有 GPU 资源。- 镜像名称指定要运行的版本。
当看到 You can now view your Streamlit app in your browser. 信息时，服务启动成功。
1.3 访问操作界面
打开浏览器，输入地址：
http://localhost:8501
即可进入 LiuJuan Z-Image Generator 的操作界面。
2. 理解工具的核心优化
了解底层优化有助于更好地利用工具，特别是在消费级显卡上运行大型扩散模型。
- 显存碎片治理：启动时设置
max_split_size_mb:128，整理显存，预留连续空间给模型，降低因碎片化导致失败的概率。 - BF16 精度优化：默认使用 BF16（Brain Floating Point 16）精度，减少显存占用和计算量，RTX 4090 等显卡有硬件加速支持。
- 智能权重加载：内置键名清洗功能，自动处理层命名前缀差异，以'宽松模式'加载自定义权重。
- 模型 CPU 卸载：启用
enable_model_cpu_offload()功能，仅在需要时将模型部分加载到 GPU，降低显存占用。
3. 生成你的第一张 8K 人像
3.1 配置生成参数
在操作界面找到参数配置区域：
- 提示词 (Prompt)：描述越具体效果越好。例如：
photograph of a beautiful Chinese young woman, smiling, looking at viewer, detailed eyes, soft natural lighting, in a cozy coffee shop, 8k resolution, masterpiece, sharp focus - 负面提示词 (Negative Prompt)：过滤低质量元素。例如：
nsfw, low quality, worst quality, bad anatomy, blurry, ugly, disfigured, deformed, text, watermark, signature
