开源数字人工具 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这份指南写给想在自己电脑上完成数字人平台本地部署的开发者、内容创作者和企业培训团队。装完之后你的机器就是一套数字人生产线上传约 10 秒视频即可克隆形象与声音输入文案后自动生成口播视频。这套能力由开源项目 Duix.Avatar 提供支持文字或语音两种驱动方式。部署前环境与配置要求选择本地部署是因为人脸和声音素材属于敏感数据留在自己的机器上最稳妥长期使用也没有额外费用。系统要求Windows10 系统 19042.1526 及以上版本NVIDIA 显卡且装好最新驱动必须有 D 盘存数字人数据空闲大于 30GC 盘空闲大于 100G存 Docker 镜像Ubuntu22.04 Desktop磁盘空闲大于 100G硬件对比三档项目最低档推荐档高端档CPU第 10 代酷睿 i5 或同级 AMD第 13 代 i7-13700F第 14 代 i9-14900K内存16GB32GB64GB显卡RTX 30606GBRTX 407012GBRTX 409024GB存储256GB SSD 1TB HDD512GB SSD 2TB SSD1TB SSD 4TB SSD大致性能720p 合成训练约 30 分钟/模型1080p 合成训练约 15 分钟/模型4K 合成训练约 8 分钟/模型 选型建议显卡优先12GB 显存的卡加 32GB 内存能覆盖绝大多数场景。部署实操6 步装好数字人服务端① 系统检查先确认系统版本达标用下面对应系统的命令验证winver lsb_release -a第一条在 Windows 执行第二条在 Ubuntu 执行。看到 19042 以上版本或 22.04即通过。② 安装 Docker 与 GPU 依赖Docker 是把服务打包成即用镜像的容器运行环境本项目完全依赖它跑服务端。Windows 用户先装并更新 WSL即 Windows 自带的 Linux 子系统wsl --list --verbose wsl --install wsl --update⚠️ WSL 更新可能要重启电脑动手前保存好手头工作。装完后从 Docker 官网下载 Docker Desktop 安装首次启动接受协议并跳过登录。Ubuntu 用户先按 NVIDIA 官方文档装好显卡驱动再执行以下命令安装 Docker 和 GPU 容器工具首次需先添加 NVIDIA Container Toolkit 软件源仓库 README 中有现成命令sudo apt update sudo apt install docker.io docker-compose sudo apt-get update sudo apt-get install -y nvidia-container-toolkit sudo nvidia-ctk runtime configure --runtimedocker sudo systemctl restart docker验证方式docker --version nvidia-smi前者输出 Docker 版本号后者显示显卡型号和驱动信息两项都正常即通过。③ 克隆项目仓库拿到 deploy/ 目录下的部署脚本和客户端源码git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar进入Duix-Avatar目录能看到deploy/文件夹即通过。④ 拉取镜像并启动服务在 deploy/ 目录启动三个服务fun-asr语音识别、fish-speech-ziming语音合成、duix.avatar视频合成cd deploy docker-compose up -d首次运行会下载大量镜像耗时取决于网速请耐心等待。按需替换命令Ubuntudocker-compose -f docker-compose-linux.yml up -d50 系显卡如 5090docker-compose -f docker-compose-5090.yml up -d显存较小的轻量版docker-compose -f docker-compose-lite.yml up -d只启动 1 个服务 镜像拉取慢时给 Docker 配置国内镜像源再重启服务能明显提速。⑤ 核对服务状态查看容器运行情况docker ps看到duix-avatar-tts、duix-avatar-asr、duix-avatar-gen-video三个容器均为 Up 状态即通过lite 版只有duix-avatar-gen-video一个。⑥ 安装客户端从项目 release 页面下载最新版安装包Windows双击Duix.Avatar-x.x.x-setup.exe按向导安装Ubuntu双击.AppImage文件直接运行root 用户需在终端加--no-sandbox参数✅ 主界面加载出来、能看到 Create Video 和 Create Avatar 两个入口即安装成功。跑通你的第一条数字人视频客户端主界面顶部有两个入口紫色的 Create Video 和蓝色的 Create Avatar。第一步建数字人形象点 Create Avatar上传约 10 秒的正面人像视频要求光线充足、镜头稳定。训练完成后My Avatars 列表里会出现你的新形象。第二步生成视频点 Create Video选中刚建的数字人输入文案。系统自动合成口型对齐的口播视频无需逐句剪辑。第三步检查产物到 My Works 列表点开作品预览确认画面、口型和声音都正常再导出成片。场景速览三类常见用法教育虚拟教师素材10~15 秒正面讲课视频背景简洁、光线均匀参数语速 120~150 字/分钟文案中用逗号句号控制停顿产出课程导入、单词领读、知识点讲解片段企业数字代言人素材正面与 45 度角视频各一段包含问候等标准动作声音安静环境录制覆盖正式、亲切两种语气产出设置品牌背景和标题后保存为可复用模板个人自媒体素材任意 10 秒正面口播片段即可参数先用 50 字以内短文案跑通流程再逐步加长产出日常口播、观点点评、带货介绍常见问题速查遇到问题先别慌打开 Docker Desktop 里对应容器的日志面板找带 ERROR 或 Traceback 的行定位问题现象可能原因处理方式容器起不来反复 Restarting端口 18180/8383 被占用显卡驱动缺失磁盘不足用netstat -tuln \| grep -E 18180\|8383查端口更新 NVIDIA 驱动清理出 30G 以上空间训练卡在某个百分比素材光线差、分辨率低显存不够重录 720p 以上、H.264 编码的 MP4或降低精度、升级显卡镜像拉取超时或极慢未配置镜像源在/etc/docker/daemon.json添加国内镜像源后重启 Docker客户端连不上服务三个容器未全部 Up在 deploy/ 目录重跑docker-compose up -d等约 10 分钟再试视频合成速度慢内存吃紧、任务排队关闭其他大型程序清理 duix_avatar_data 下的缓存文件到这里一条完全跑在本地的数字人生产线就算搭好了。遇到更细的问题先翻仓库里的 doc/常见问题.md项目的 Issues 列表和技术交流群README 里有二维码每天都有新修复大概率能找到答案。【免费下载链接】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），仅供参考