3步在Linux上做出自己的AI数字人：Duix Avatar部署实践
【免费下载链接】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
做一条专业数字人视频，过去动辄数十万美元。现在 Duix Avatar 让一台普通电脑就能做 AI数字人：这是个真开源项目，支持离线数字人生成与数字人克隆，下面是完整的 Linux部署 实录，从自测机器到产出第一条视频。
🎯 你能从 AI数字人 克隆里得到什么
先不聊项目背景，只说用户视角能拿到的能力：
- 一次克隆，形象声音都有：传一段 10 秒左右、本人开口说话的视频，外观和音色一起克隆下来
- 两种驱动方式：直接输入文案走 TTS 合成，或上传自己的录音
- 离线数字人生成：全部算力在本地跑，素材不出机器
- 八种语言：中、英、日、韩、法、德、阿拉伯、西班牙语
- 多模型管理：建多个数字人，按场景切换
🖥️ 我的电脑能跑吗：Linux部署前自测清单
算力全在本地，硬件没有商量余地。先对号入座，有一条不满足就别急着开工：
| 项 | 推荐配置 | 说明 |
|---|---|---|
| CPU | 13 代 Intel i5-13400F 及以上 | 更高更好 |
| 内存 | 32GB 及以上 | 硬性要求，16GB 基本起不来 |
| 显卡 | NVIDIA RTX 4070 及以上 | 必须装好驱动 |
| 硬盘 | 空闲 100GB 以上 | 首次拉取约 70GB 数据 |
| 系统 | Ubuntu 22.04 | 官方验证过的版本 |
结论就一句：32G 内存 + 有驱动的李群（N 卡）缺一不可，A 卡或核显请先考虑别的方案。
🛠️ 三步 Docker部署：驱动、容器、客户端
第一步：让 Docker 用上 NVIDIA 显卡
目标一句话：容器能调到 GPU。先装 Docker 和 Compose：
sudo apt update sudo apt install -y docker.io docker-compose再去 NVIDIA 官网驱动页按自己的卡下载安装驱动，一条命令验证是否装好：
nvidia-smi能打出显卡信息才算过。接着装 NVIDIA Container Toolkit，它是容器使用 GPU 的必经桥接，先按 README_zh.md 里 Ubuntu 安装小节把官方源加上（两条 curl 命令），然后执行：
sudo apt-get update sudo apt-get install -y nvidia-container-toolkit sudo nvidia-ctk runtime configure --runtime=docker sudo systemctl restart docker第二步：一条命令拉起三个服务端
克隆项目，用 Linux 专用配置起服务：
git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar cd Duix-Avatar/deploy docker-compose -f docker-compose-linux.yml up -d首次拉取约 70GB 镜像和模型，半小时起步，耐心等。RTX 50 系（5090）的卡换用docker-compose-5090.yml；配置较低的机器可以改用docker-compose-lite.yml，只起一个生成服务。
第三步：客户端免安装
从官方 releases 页下载 Linux 版 AppImage，双击即运行。注意：root 用户进桌面的话，双击可能打不开，改在终端执行并加参数，例如./Duix.Avatar-x.x.x.AppImage --no-sandbox。
✅ 如何验证部署成功并生成第一条视频
三个服务全部 Running 才算及格。列出本机在跑的容器，核对状态：
docker ps应看到duix-avatar-asr、duix-avatar-tts、duix-avatar-gen-video三个容器。缺一个、或者反复重启，说明上一步没做干净。
界面显示正常但客户端报错时，翻两处日志：Docker 里对应容器的 Logs 页，以及客户端设置菜单里打开的本地日志。
然后产出第一条数字人视频：客户端里点 Create Avatar，上传一段自己说话的 10 秒视频完成克隆；再点 Create Video，输入文案或上传音频，口播视频就出来了。能播放，部署闭环。
⚠️ 常见坑：镜像拉不动、GPU 不识别、服务起不来
坑一：镜像拉取超时症状：up -d报Client.Timeout exceeded或context canceled。原因：连不上 Docker Hub 官方源。解法：往/etc/docker/daemon.json的registry-mirrors里加几个国内镜像源再重启 Docker；源会随时间失效，现行名单见官方FAQ，自己搜最新可用的一手。
坑二：容器起不来或报 CUDA 错症状：服务秒退、重启循环，日志出现 GPU/CUDA 相关报错。原因：NVIDIA 驱动没装好，或容器工具包没配对。解法：先跑nvidia-smi，打不出显卡就修驱动；打得出来就回头复查 Toolkit 那四条命令，尤其别漏了重启 Docker。
坑三：创建模特失败，Connection refused症状：新增模特直接报错，容器日志里是连接被拒或File not exist。原因：asr/tts 服务启动慢（内存吃紧时更明显），或素材视频本身没有声音。解法：服务起来后等几分钟再克隆；内存低于 32GB 大概率无解；素材必须是人开口说话、带声音的视频。典型报错长这样：
📌 收尾
Duix Avatar 把曾经数十万美元的数字人搬回了自己的 Linux 机器上，而且全程离线、免费开源。细节问题翻官方FAQ，服务端编排见 deploy/docker-compose-linux.yml；想基于它做自己的应用，从 src/main/service/ 里的模型、视频、语音三份服务代码入手最顺。
【免费下载链接】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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
