Duix-Avatar 本地部署 4 步走：免费跑虚拟形象视频合成实操教程

Duix-Avatar 本地部署 4 步走：免费跑虚拟形象视频合成实操教程

【免费下载链接】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，上传一张照片或一段短视频，就能产出虚拟形象视频：它在你自己的电脑上克隆面部与声音，文字即可生成会说话、会口型的数字人视频。全程离线，数据不出本机。

先花 3 分钟确认机器

结论先行：8GB 内存、10GB 空闲磁盘，是装得动的底线。

必备软件就两样：Git 负责拉取源码，Docker Desktop 负责跑后端三个服务。装完各自能正常启动，再往下走。

⚠️ 没有 NVIDIA 显卡和驱动时，后端三个服务起不来。打算长期玩虚拟形象 Docker 部署的话，先对照 常见问题文档 核对一下环境。

4 步装完，全程本地

整个安装只有 4 个动作。每步都写明"做完后你应该看到什么"，看到了再进下一步。

🔧 ① 把项目拉到本地

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

执行后，当前目录里应能看到 deploy、src、README.md 等文件。

② 给 Docker 分配资源

打开 Docker Desktop，依次点 Settings → Resources → Advanced。内存至少给 8GB，CPU 至少 4 核，磁盘留足空闲。给少了，服务跑起来会卡甚至会崩。

改完点右下角 Apply & restart。重启后底部状态栏应显示 Engine running，Resources 页里也能看到你刚设的数值。

③ 配镜像加速

继续 Settings → Docker Engine，在 JSON 配置里补上这一个字段：

{ "registry-mirrors": ["https://registry.docker-cn.com"] }

⚠️ 只新增这一个字段，别删动其他配置。改错可能让 Docker 服务直接起不来。

再次 Apply & restart。生效后第一次拉镜像应当一路走通，不再卡超时。

🔧 ④ 一条命令起服务

cd deploy docker-compose up -d

首次运行要下载语音合成、语音识别、视频合成三组镜像，可能需要几分钟。完成后，三个容器应全部处于 Running 状态。

装完先跑这 3 个动作

验收一共 3 个动作，全部通过后这套虚拟形象视频合成环境就算交付完成。

1. ✅ 打开主界面：用浏览器访问本地服务地址，看到带 Create Video、Create Avatar 两张卡片的首页。

2. 创建第一个虚拟形象：点 Create Avatar，上传一张照片或一段短视频。注意视频里必须有人声，系统靠它克隆你的声音。
3. ✅ 出一条 10 秒测试片：输入文字，选中刚建好的形象与音色，用默认模板生成一段约 10 秒的测试片。能正常播放，链路就通了。

卡住了先看这里

先看这张表，绝大多数失败都在这三条里：

其他问题先看容器状态：

docker-compose ps docker-compose logs

服务都活着、但应用行为不对，就进应用右上角 Setting → 打开日志，定位到日志文件查记录；更多场景见 常见问题文档。

这套工具能干嘛

新手高频三项：

• 快速创建虚拟形象：一张照片或一段短视频，系统自动生成形象
• 文字转视频：输入文本，选形象与音色，一键出片
• 作品管理：作品与形象分列两个标签页，可搜索、可删除

进阶玩法：

• 自定义虚拟形象：调整面部特征、服装与背景
• 语音参数调节：控制语速、语调与情感
• 批量处理：一次产出多条视频

现在就打开应用，上传你的第一张照片。几分钟后，你手上就会有一条会开口说话的自己的数字人视频。

【免费下载链接】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