Appearance
安装与环境准备
本页说明阿花 AI 在 Windows 11 上的完整安装准备流程。阿花采用免安装 exe 压缩包交付，但运行前必须先准备 Docker Desktop、WSL2 与 NVIDIA 显卡驱动。
系统要求
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 11 64 位 | Windows 11 22H2 及以上 |
| CPU | 8 核 | Intel i7 / AMD Ryzen 7 及以上 |
| 内存 | 16 GB | 32 GB 及以上 |
| 显卡 | NVIDIA RTX3060 | NVIDIA RTX3060 12GB 及以上 |
| 驱动 | Game Ready Driver 可运行 | NVIDIA Studio Driver |
| 磁盘 | 100 GB 可用空间 | 100 GB 以上 NVMe SSD |
| 容器 | Docker Desktop | Docker Desktop + WSL2 backend |
不支持环境
不建议在 Windows 10、无独显设备、虚拟机、远程云桌面或未启用 WSL2 的 Docker 环境中运行生产生成流程。
离线安装资源包
为了降低客户电脑网络环境对安装过程的影响，阿花提供了离线安装资源包。资源包中包含阿花免安装程序分卷包，以及运行阿花所需的常用安装工具。
网盘下载地址
通过网盘分享的文件：AFlower-Portable-7z-parts
下载地址：
text
https://pan.baidu.com/s/1XiZe8aTeDVXjrZ9wUiAGpw
提取码：asnq
资源包内容示意
请下载完成后，对照下图确认文件是否完整：
安装顺序
建议按照图片中的编号顺序安装：
- 先安装 WSL2 离线安装包：
wsl.2.7.5.0.x64.msi - 再安装 Docker Desktop：
Docker Desktop Installer.exe - 再安装 7-Zip 解压工具：
7z2601-x64.exe - 最后解压阿花免安装分卷包，并启动阿花客户端
安装前检查
1. 检查电脑是否支持 Docker 运行
阿花依赖 Docker Desktop 启动本地 AI 模型服务。正常情况下，Windows 11 专业版电脑通常已经具备运行条件，用户不需要进入 BIOS 修改设置。
可以通过任务管理器简单检查：
- 按
Ctrl + Shift + Esc打开任务管理器。 - 点击“性能”。
- 点击“CPU”。
- 查看右下角是否显示“虚拟化：已启用”。
如果显示“已启用”，可以继续安装。
如果显示“未启用”，请联系售后或电脑维护人员处理，不建议普通用户自行进入 BIOS 修改。
2. 安装 WSL2 离线包
在离线安装资源包中找到 wsl.2.7.5.0.x64.msi，双击安装即可。
安装完成后，建议重启电脑一次。
说明
WSL2 是 Docker Desktop 在 Windows 上运行本地容器服务所需的基础组件。用户无需理解具体技术含义，只需要完成安装即可。
3. 安装 Docker Desktop
在离线安装资源包中找到 Docker Desktop Installer.exe，双击安装。
安装完成后：
- 启动 Docker Desktop。
- 等待 Docker Desktop 显示正在运行。
- 如果提示重启电脑，请按提示重启。
- 重启后再次打开 Docker Desktop。
注意
Docker Desktop 第一次启动可能较慢，请等待它完成初始化。不要反复关闭或重复安装。
4. 安装 7-Zip 解压工具
在离线安装资源包中找到 7z2601-x64.exe，双击安装。
安装完成后，用 7-Zip 解压阿花分卷压缩包。
重要
阿花安装包是分卷压缩包，请不要只解压其中一个文件。请确保所有分卷文件放在同一个目录下，再从第一个分卷开始解压。
5. 检查显卡驱动
阿花建议使用 NVIDIA RTX5060 及以上显卡。
可以按下面方式检查：
- 按
Ctrl + Shift + Esc打开任务管理器。 - 点击“性能”。
- 查看是否存在 NVIDIA GPU。
- 确认显卡型号是否为 RTX3060 或更高配置。
如果电脑没有 NVIDIA 显卡，或显卡型号过低，可能无法正常生成 AI 视频。
安装阿花客户端
阿花以免安装压缩包交付，用户不需要手动启动 jar，也不需要部署传统 Web 服务。
安装步骤：
- 确认所有阿花分卷压缩包都在同一个文件夹中。
- 使用 7-Zip 从第一个分卷开始解压。
- 建议解压到普通英文路径，例如
D:\Apps\Aflower。 - 打开解压后的阿花目录。
- 双击启动
阿花.exe。 - 首次启动时等待本地服务初始化。
- 按提示完成授权激活。
- 授权成功后，系统会自动检查 Docker、WSL2、显卡、磁盘与模型服务状态。
路径建议
不要解压到包含特殊字符、超长路径或受权限保护的系统目录。推荐使用 D:\Apps\Aflower 或其他普通用户可读写目录。
安装阿花客户端
阿花以免安装压缩包交付，用户不需要手动启动 jar，也不需要部署传统 Web 服务。
- 下载交付包，例如
release.zip。 - 解压到英文路径，例如：
text
D:\Apps\Aflower
- 双击启动
阿花.exe。 - 首次启动时等待本地服务初始化。
- 按提示完成授权激活。
- 授权成功后，系统会检查 Docker、WSL2、显卡、磁盘与模型服务状态。
路径建议
不要解压到包含特殊字符、超长路径或受权限保护的系统目录。推荐使用 D:\Apps\Aflower 或其他普通用户可读写目录。
启动流程
mermaid
flowchart TD
A --> B[双击安装wsl.2.7.5.0.x64.msi]
B --> C[双击安装Docker Desktop Installer.exe]
C --> D[解压阿花分卷压缩包AFlower-Portable-7z-parts]
D --> E[用户输入注册码]
E --> F[检查 Docker Desktop 与 WSL2]
F --> G[拉取并启动模型服务]
G --> H[拉取并启动模型服务]
验证步骤
然后打开阿花客户端，确认：
- 可以进入登录或激活界面。
- Docker 检查通过。
- 授权状态正常。
- 任务面板可以接收 WebSocket 状态。