Duix Avatar部署教程：N卡机器一条Docker命令，搭起本地AI数字人-创锋一号

Duix Avatar部署教程：N卡机器一条Docker命令，搭起本地AI数字人

【免费下载链接】Duix-Avatar🚀 Truly open-source AI avatar(digital human) toolkit for offline video generation and digital human cloning.项目地址: https://gitcode.com/GitHub_Trending/he/Duix-Avatar

一台带英伟达独显的Ubuntu 22.04机器 + 三条Docker Compose命令 = 随时可用的AI数字人。Duix Avatar是一款全离线开源的数字人克隆与视频生成工具，下面按Linux部署顺序带你走一遍，最容易翻车的环节和坑位都提前标出来。

一、值不值得装：一张表看懂成本与能力

动手前先回答"值不值得装"，看个对比就明白了：

维度	传统专业数字人制作	Duix Avatar
成本	数十万美元外包预算	本地电费，软件免费
门槛	需要工作室和外包团队	Docker + 几条命令
交付物	一次性成片	可反复生成的数字人模型
数据	素材上传第三方云端	全离线，数据留在本机

核心能力就五条：

全离线操作，所有计算本地完成
多模态驱动，文本或语音都能驱动
高精度克隆，捕捉面部特征和声音特点
八国语言支持，覆盖中、英、日、韩等
Docker化服务，一条命令拉起三个核心服务

二、📋 动手前自查清单：数字人部署前先验硬件

这条命令别急着敲，先确认机器撑得住。硬性项不满足就别开跑：

项目	硬性要求	推荐
CPU	64位 x86_64	13代 Intel Core i5-13400F 及以上
内存	32GB 及以上（官方标注必要）	保持32GB起步，宁大勿小
显卡	NVIDIA 独立显卡	RTX 4070 及以上，且已装驱动
硬盘	空闲空间 100GB 以上	预留100GB以上（首次下载约70GB）
系统	桌面版 Linux	Ubuntu 22.04（官方实测环境）
依赖	Docker + Docker Compose	NVIDIA 容器工具包

官方实测环境是Ubuntu 22.04，其他桌面发行版理论可行，但遇到问题时这个版本最稳。

机器没问题后，安装Docker和Docker Compose：

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

三、⚠️ 最易翻车的一步：NVIDIA驱动与容器工具包

这一步不报任何错，但没配好后面全白搭——项目全部算力走GPU加速，Docker看不到显卡，服务只会反复重启。

先跑验证命令：

nvidia-smi

成功标志是nvidia-smi正常输出显卡型号和驱动版本。报错就先按官方流程装好对应版本的NVIDIA驱动，再回来复验。

驱动没问题只算赢了一半，还要装NVIDIA Container Toolkit让Docker用上GPU：

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

最后这句configure就是把GPU交给Docker运行时，然后重启Docker生效。别急着跑服务，先确认nvidia-smi依然正常输出再往下走。

四、服务端从零到Running：Docker Compose拉起三大核心服务

本节目标：让语音合成、语音识别、视频合成三个服务到Running状态且健康。

先克隆项目：

git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar cd Duix-Avatar

再用Linux专用配置一键启动：

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

提前打好预防针：首次启动要下载镜像和模型，总量约70GB，纯网络活，耗时长别慌，网络稳住就行。

三个服务分别是duix-avatar-tts（语音合成）、duix-avatar-asr（语音识别）、duix-avatar-gen-video（数字人视频合成）。判断健康看三点：

docker ps里三个容器全部Running；
docker logs 容器名翻一遍，无报错日志；
客户端能连上服务地址，页面可访问。

五、客户端上线：做出你的第一个数字人克隆

服务端就绪，轮到客户端，目标是连上服务做出第一个数字人。从项目发布页下载最新Linux版AppImage，免安装直接启动：

chmod +x Duix.Avatar-x.x.x.AppImage ./Duix.Avatar-x.x.x.AppImage

Ubuntu桌面下用root用户时，直接双击可能起不来，请在终端加--no-sandbox参数运行：./Duix.Avatar-x.x.x.AppImage --no-sandbox

在设置里连接服务端地址后，走最短路径四步：

准备素材：录一段正对镜头说话的出镜视频，必须带声音（程序用它克隆你的音色）；
创建模型：进"Create Avatar"入口上传视频，处理完得到一个可复用的数字人形象；
输入文本：选模型填旁白内容，也可以直接用音频文件驱动；
生成查看：合成结束后在作品列表里预览并下载成片。

跑通的标志，是客户端里能看到一段口型、音色都稳的成片——到这里，数字人生成教程就算闭环了。

六、🛟 故障急救包：常见翻车点三步解决

出问题先对照这张表，能覆盖绝大多数情况：

症状	处理
`docker-compose up -d`拉取镜像超时	给Docker配置加国内镜像源，重新执行启动命令
服务起不来 / 容器反复重启	查三项：三个服务是否都Running、NVIDIA驱动是否装好、服务端客户端是否最新版
启动后无法访问、客户端连不上	更新服务：到deploy目录重新执行`docker-compose up -d`
创建形象报错	确认素材视频有人声且人在说话；服务端刚启动时等几分钟，识别服务预热完再试

镜像源配置最折腾，核心字段只有一段，加到Docker配置文件即可：

{ "registry-mirrors": [ "https://docker.m.daocloud.io", "https://docker.1ms.run" ] }

改完点Apply让Docker重启，再重新执行拉取命令即可。

七、给开发者的门：自定义数字人场景的开放接口

想拿这套数字人做自己的业务，项目开放了模型训练和视频合成接口，不用改源码，直接调用：

模型接口：src/main/service/model.js
视频合成接口：src/main/service/video.js
语音接口：src/main/service/voice.js

机器达标就按本文顺序跑一遍，你的AI数字人很快就能在本机上产片。别把第一次运行攒着，跑就完了；卡住先翻官方常见问题文档，再不行直接给项目提issue。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析