Duix-Avatar

环境要求

• Windows 10 19042.1526 及以上，或 Ubuntu 22.04（其他桌面 Linux 理论可用）
• NVIDIA 显卡且已正确安装驱动
• Windows：D 盘剩余 30GB 以上，C 盘剩余 100GB 以上
• 推荐配置：i5-13400F / 32GB 内存 / RTX 4070
• 已安装 Docker 与 docker-compose

安装与启动步骤

1. 1检查并更新 WSL

   Windows 用户先确认 WSL 是否已安装，若已安装则无需重装，直接更新即可，这是运行 Docker 的前提。

   wsl --list --verbose
   wsl --update

   复制

2. 2安装 Docker

   Windows 到 Docker 官网下载安装包；Ubuntu 可直接用 apt 安装 docker.io 与 docker-compose。

   sudo apt update
   sudo apt install docker.io
   sudo apt install docker-compose

   复制

3. 3安装显卡驱动

   按 NVIDIA 官网文档安装驱动，执行 nvidia-smi 能显示显卡信息即安装成功。

   nvidia-smi

   复制

4. 4安装容器工具包

   Ubuntu 需安装 NVIDIA Container Toolkit，让 Docker 能调用 GPU，最后重启 Docker 服务生效。

   distribution=$(. /etc/os-release;echo $ID$VERSION_ID) 
     && curl -s -L https://nvidia.github.io/libnvidia-container/gpgkey | sudo apt-key add - 
     && curl -s -L https://nvidia.github.io/libnvidia-container/$distribution/libnvidia-container.list | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
   sudo apt-get update
   sudo apt-get install -y nvidia-container-toolkit
   sudo nvidia-ctk runtime configure --runtime=docker
   sudo systemctl restart docker

   复制

5. 5启动服务端 Windows

   在 /deploy 目录执行 docker-compose up -d；想用精简版则加 -f docker-compose-lite.yml。

   cd /deploy
   docker-compose up -d

   复制

6. 6启动服务端 Ubuntu

   Ubuntu 使用专用编排文件启动服务，同样在 /deploy 目录下执行。

   cd /deploy
   docker-compose -f docker-compose-linux.yml up -d

   复制

7. 7安装启动客户端

   从 Releases 下载 Linux 版 AppImage，双击运行；root 用户需在终端加 --no-sandbox 参数启动。

   ./Duix.Avatar-x.x.x.AppImage --no-sandbox

   复制

关键配置

如何确认成功

执行 docker ps，Docker 中出现三个服务即成功，精简版只有一个 Duix.Avatar-gen-video 服务。

常见问题

注意事项

• D 盘需预留 30GB 以上，C 盘需 100GB 以上空间
• 内存 32GB 为必要或推荐配置，显存不足会影响生成效果
• 首次拉取镜像约消耗 70GB 流量，建议使用 WiFi
• 需确保 NVIDIA 驱动与容器工具包安装正确后再启动服务