零基础跑通 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 是一个全离线的开源数字人创作工具录一段自己的视频克隆出形象和声音后输入文字就能自动合成口型对齐的成片且素材全程不出你的电脑。这篇教程带你从装环境到生成第一条数字人视频全程约 40 分钟。01 项目概览Duix.Avatar 本地部署到底能做什么做完本章你能得到一张清晰的能力地图知道哪些环节它能替你完成、哪些素材必须自己准备。Duix.Avatar 解决的问题很直接把你本人的形象和声音变成可复用的数字分身之后念稿只花打字的时间。它基于真人视频训练而非传统 3D 建模把制作成本和硬件门槛都拉低到了消费级。核心能力一览功能模块它替你做的事形象克隆从一段真人视频里重建面部特征和轮廓生成可长期复用的虚拟模特声音克隆从同一段视频提取音色支持语速等语音参数调节文本 / 语音驱动输入文字或直接传语音即可驱动数字人表演无需真人出镜口型同步自动对齐音视频节奏让嘴唇开合贴合发音全离线运行训练与合成全部在本地完成断网也能用素材不上传云端多语言脚本台词支持中、英、日、韩、法、德、阿、西八种语言02 安装与首次运行本地部署步骤做完本章你会得到三样东西运行中的服务容器、能打开的客户端主界面以及一张硬件核对清单。预计耗时约 40 分钟其中约一半是等镜像下载。先看硬件门槛它比软件更硬——所有算力都消耗在本地NVIDIA 显卡和驱动缺一不可项目官方推荐配置说明操作系统Windows 10 19042.1526 / Ubuntu 22.04Windows 版要求存在 D 盘CPU13 代 Intel Core i5-13400FAMD 同级处理器可替代内存32GB低于此值 asr 服务可能起不来显卡NVIDIA RTX 4070驱动装好非 NVIDIA 显卡无法启动任何服务磁盘WindowsC 盘 100GBD 盘 30GB前者放服务镜像后者放项目数据磁盘Ubuntu100GB 空闲镜像与数据共用第 1 步 · 按系统装好 Docker 环境约 10 分钟Windows先检查 WSL 状态再更新它然后安装 Docker Desktop 并首次启动同意协议、跳过登录wsl --list --verbose # 查看 WSL 是否已安装 wsl --update # 更新 WSL 到最新版本若失败C 盘不足 100GB 时在 Docker Desktop 的 Settings → Resources → Advanced 里点 Browse把磁盘镜像位置改到空间充足的盘。图Docker Desktop 资源设置界面可将 Disk image location 改到空闲空间更大的磁盘Ubuntu 22.04安装 Docker、docker-compose 与 NVIDIA Container ToolkitDocker 调用 GPU 的必备件装完配置运行时并重启 Docker 服务sudo apt update sudo apt install -y docker.io docker-compose nvidia-container-toolkit sudo nvidia-ctk runtime configure --runtimedocker sudo systemctl restart docker若失败执行nvidia-smi应能打印显卡信息打印不出来说明 NVIDIA 驱动本身没装好先去解决驱动。第 2 步 · 启动服务容器下载约 30 分钟进入deploy/目录执行启动命令。首次运行要拉取三个镜像fun-asr、fish-speech-ziming、duix.avatar消耗约 70GB 流量cd deploy docker-compose up -d # Windows docker-compose -f docker-compose-linux.yml up -d # Ubuntu 22.04若失败报registry-1.docker.io ... request canceled是 Docker Hub 连接超时按 doc/常见问题.md 的配置方法给 Docker 添加国内镜像源后重试。第 3 步 · 安装客户端约 10 分钟下载官方构建的安装包Windows 双击Duix.Avatar-x.x.x-setup.exe安装Ubuntu 直接双击Duix.Avatar-x.x.x.AppImage运行root 用户启动需在终端追加--no-sandbox参数。✅ 通过标志Docker 里duix-avatar-asr、duix-avatar-tts、duix-avatar-gen-video三个容器全部 Running客户端通过协议页后进入主界面。注意 asr 服务预热较慢容器转 Running 后请先等几分钟再开始克隆。图Docker Desktop 容器日志页STATUS 显示 Running 即代表该服务已就绪03 创建第一个作品第一次生成数字人视频做完本章你会得到一个真实产出一段由文字 你的数字分身合成的口播视频。录素材拍一段 10 秒左右的正面视频——光线充足、背景干净、表情自然且必须有清晰的说话声声音克隆直接取自这段音频静音视频无法创建模特。训练形象客户端首页点 Create Avatar上传视频并填写模型名称提交后等待训练完成。确认形象形象出现在 My Avatars 列表中即训练成功。完成信号列表里能看到你的新模特卡片。写台词点 Create Video 进入创作页选择刚建的形象输入台词新手建议 50 字以内按需调整语速等语音参数。生成视频提交合成任务数分钟内完成期间保持三个服务容器在线。验收成片到 My Works 列表打开新视频。图客户端主界面——顶部两个入口分别负责视频合成与形象创建下方管理你的作品和数字人模型可感知的成功标志视频能完整播放、口型与发音逐句对齐、声音是克隆出的你的音色。到这里部署与创作两条线都跑通了。04 效率与进阶从单条成片到批量生成批量生产走 Open API服务端启动后在本地127.0.0.1暴露了 HTTP 接口——语音合成走127.0.0.1:18180/v1/invoke视频合成走127.0.0.1:8383/easy/submit进度查询走8383/easy/query?code${taskCode}。写个脚本循环调用即可批量出片接口字段与调用流程可直接参考 src/main/service/ 下 video.js、voice.js 的源码。只想合成、不想训练用轻量版部署在deploy/目录执行docker-compose -f docker-compose-lite.yml up -d只起一个Duix.Avatar-gen-video容器省硬件资源代价是没有本地 ASR/TTS 服务。一形象多语言台词换语言重新生成即可复用同一个形象无需重训——八种语言脚本在同一个模型下都能跑。05 排障速查卡住时先查这张表现象原因解决拉镜像报request canceledDocker Hub 官方源连接不稳定给 Docker 配置国内镜像源见 doc/常见问题.md容器起不来、反复退出无 NVIDIA 显卡或驱动未装好执行nvidia-smi验证驱动装好后重启 Docker 再拉服务创建形象报file not existsasr 服务尚未就绪 / 上传视频无说话声容器 Running 后等几分钟再试确认视频里有人在说话定制模特报Connection refusedfun-asr 启动慢或内存不足等待 asr 就绪后重试内存低于 32GB 时考虑扩容完整故障排查与提问模板doc/常见问题.md客户端与服务端源码入口src/main/问题定位时可对照src/main/config/检查本地配置问题反馈项目 Issues 页面每天都在处理新提交提问前先搜一遍很多坑已有解法环境装好后先按 03 章跑通第一条视频比研究更多功能更有价值。卡住的地方对照上面这张表处理十分钟内大概率能自助解决。【免费下载链接】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），仅供参考