Duix.Avatar 数字人克隆教程1 段 10 秒视频如何在本地免费生成口播视频【免费下载链接】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 是硅基智能推出的完全免费开源的数字人克隆工具本地部署后输入文案或音频即可自动生成口型同步的数字人视频。跟着这篇新手指南你在约 30 分钟下载等待之后就能在自己电脑上跑通第一个数字人视频。部署总流程示意Docker 安装服务端 客户端安装包两步即可完成本地部署 核心价值3 个理由足够你开始零成本——项目代码完全开放支持全球免费商用用户量超 10 万或年营收超 1000 万美元的企业需另行签署商业许可协议对比动辄数万元的商业数字人服务一分钱不花全离线——所有计算都在本地完成视频素材和声音数据全程不联网传输隐私完全可控30 分钟跑通——服务端基于 Docker 一键拉起首次镜像下载约需半小时录一段 10 秒视频就能克隆出可用的形象和声音✅ 动手前自查硬件与环境清单照着这份清单逐项确认避免部署到一半才发现配置不够项目要求自测方法操作系统Windows 1019042.1526 或更高或 Ubuntu 22.04Windows 设置页查看版本号Ubuntu 执行lsb_release -aNVIDIA 显卡与驱动30/40/50 系列均可必要算力全部在本地执行nvidia-smi能显示显卡信息即驱动正常内存建议 32GB 及以上必要16GB 可能无法启动任务管理器/free -h查看硬盘WindowsD 盘空闲 30GB 存数据C 盘空闲 100GB 存镜像右键查看磁盘剩余空间硬盘Ubuntu空闲 100GBdf -h查看网络首次下载约 70GB 流量建议连 Wi-Fi——推荐参考配置i5-13400F 32GB 内存 RTX 4070。 部署三步走Docker、服务端、客户端第 1 步装好 Docker 并验证 WSL做什么Windows 先在终端执行wsl --list --verbose查看 WSL 状态没装过就执行wsl --install再执行wsl --update更新随后从 Docker 官网下载并安装 Docker Desktop。怎么算成功Docker Desktop 图标出现在任务栏并提示 Engine running。最容易卡在哪WSL 安装受网络影响容易失败多试几次首次启动 Docker 记得接受协议、可跳过登录。第 2 步一键部署服务端重点在这做什么进入仓库的 deploy/ 目录执行docker-compose up -dUbuntu 用户改用docker-compose -f docker-compose-linux.yml up -dRTX 50 系列显卡用docker-compose -f docker-compose-5090.yml up -d。怎么算成功耐心等待约 30 分钟取决于网速Docker 中出现 3 个 Running 状态的服务分别对应语音合成、语音识别和视频合成。想省空间可改用精简版docker-compose -f docker-compose-lite.yml up -d只启动 1 个视频合成服务。最容易卡在哪镜像拉取超时、连接 Docker Hub 失败这是最高频问题详见下文「踩坑急救」第 1 条。在 Docker Desktop 设置页的 Docker Engine 中配置 registry-mirrors可解决镜像拉取超时第 3 步安装客户端做什么从项目 Releases 页面下载对应系统的官方安装包。Windows 双击Duix.Avatar-x.x.x-setup.exe安装Ubuntu 直接运行Duix.Avatar-x.x.x.AppImage。怎么算成功打开客户端能看到「Create Video / My Works / My Avatars」的首页说明客户端与服务端准备就绪。最容易卡在哪Ubuntu 下用 root 用户直接双击 AppImage 可能打不开需在终端执行./Duix.Avatar-x.x.x.AppImage --no-sandbox启动。 跑通第一个任务录 10 秒视频生成第一个口播视频录制素材手机拍一段 10-20 秒的正面说话视频——脸部光线均匀、背景简洁、口齿清晰视频中必须有人声这是声音克隆的原料。克隆形象在客户端首页点「Create Avatar」上传这段视频。后台会自动用 ffmpeg 转码、分离音频并训练声音模型等几分钟「My Avatars」里就会出现你的数字人模特。生成视频进入视频制作页左侧选中刚才的模特右侧输入口播文案或直接上传音频提交合成任务。拿到成品等几分钟到「My Works」里打开成品——人物口型与文案语音同步这就是你的第一条数字人视频。客户端首页左侧是「My Works 我的作品」上方可进入视频生成和数字人克隆入口右上角设置菜单可打开客户端日志⚙️ 进阶玩法与原理速览原理速览4 行看懂数据流转服务端由 3 个容器组成duix-avatar-asr语音识别基于 fun-asr端口 10095、duix-avatar-tts语音合成基于 fish-speech端口 18180、duix-avatar-gen-video视频合成引擎端口 8383克隆阶段上传视频 → 客户端用 ffmpeg 转 H.264 并分离音频 → ASR 转写出参考文本 → TTS 训练出你的专属音色生成阶段输入文案 → TTS 合成为你的声音 → 视频合成引擎让原视频中的人物跟着音频动嘴输出成片。开放 API可批量生产三个服务在本地http://127.0.0.1上暴露了完整的训练与合成接口接口参数可参考 src/main/service/ 下的 model.js、video.js、voice.js 源码写个小脚本就能实现批量视频生成。8 种界面语言右上角「Language switch」可在英语、日语、韩语、中文、法语、德语、阿拉伯语、西班牙语之间切换配合音色克隆即可产出多语种内容。 踩坑急救4 个高频问题对照表问题 1docker-compose 执行后服务起不来现象终端报request canceled while waiting for connectionDocker 里看不到 Running 的服务。常见原因NVIDIA 驱动没装好导致 GPU 服务无法启动或拉取镜像时连不上 Docker Hub。解决办法先执行nvidia-smi确认驱动正常再按上文第 2 步配图在 Docker 设置里加registry-mirrors国内镜像源不同版本入口略有差异参考 image-20250311143803466.png 这种配置界面然后到 deploy/ 目录重新执行docker-compose up -d。问题 2克隆形象报 Connection refused现象点击克隆形象时报错建立funasr连接异常[Errno 111] Connection refused。常见原因ASR 服务启动比客户端晚服务还没就绪内存不足如 16GB也可能导致服务起不来。解决办法服务端刚启动时等几分钟再操作内存确实偏小的话考虑升级 32GB 或使用 lite 精简版配置。问题 3新增模特时直接报错现象上传视频创建模特时弹出失败提示。常见原因素材视频没有声音或画面里没有人说话——系统需要真实人声来克隆音色。解决办法重新录一段有清晰人声的 10-20 秒视频再上传拍之前先自查正脸、有光、有声音、背景干净。问题 4视频生成卡住、TTS 服务反复重启现象合成任务长时间无进展Docker 里duix-avatar-tts状态反复变化。常见原因音频文件路径丢失TTS 日志里出现File not exists。解决办法查看 doc/常见问题.md 中的日志排查方法重启 TTS 服务后重新提交任务即可。点开 duix-avatar-tts 容器的 Logs 标签页即可看到合成请求与报错信息是排障的第一现场 用得更快更好4 条技巧 3 个场景技巧先优化素材再训练——正面拍摄、光线均匀、背景简洁、口齿清晰10-20 秒最佳素材质量直接决定克隆上限分批生成——需要多条视频时分批提交避免显存和磁盘同时吃紧定期清理数据目录——Windows 下D:\duix_avatar_data、Ubuntu 下对应挂载目录会积累转码和合成中间文件及时清理释放空间遇到问题先看客户端日志——首页右上角设置菜单里的「Open Log」可以直接打开客户端日志配合容器日志对照排查。适用场景自媒体口播不出镜也能保持日更一次克隆、反复使用企业品牌数字人产品介绍、市场推广统一形象24 小时可用教育课件把标准讲解录成数字人视频风格统一、可随时更新文案。 写在最后你的数字分身只差一个下午Duix.Avatar 的价值很简单零成本、全离线用 10 秒视频换一个月月可用的数字分身。如果部署或使用中卡住了先翻 doc/常见问题.md 的自查步骤和对照案例再到项目 Issues 区搜一搜社区每天在处理新问题。现在就打开终端开始你的第一个数字人视频吧小贴士服务端和客户端更新都比较频繁遇到问题前先确认两端都是最新版本——说不定你的问题已经在新版里修好了。【免费下载链接】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），仅供参考