企业官网建设流程全解析

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 是数字人克隆和离线视频生成工具：上传一段 10 秒讲话视频克隆形象与声音，输入文案即可生成口型匹配的播报视频。这份安装指南带你完整跑通——全程本地运行，素材不出机器。

🎯 先看看 Duix.Avatar 值不值得安装

• 10 秒视频，形象和声音一次克隆：不需要建模、不需要录音棚，一段约 10 秒的讲话视频即可完成
• 文字直接生成视频：输入文案自动转语音并驱动数字人口型，文案支持中、英、日、韩等 8 种语言
• 完全离线：日常使用无需联网，人脸、声音、文案数据都留在自己的电脑里
• 免费商用：开源项目，可自由商用（用户量超 10 万或年营收超 1000 万美元的企业需签署商业许可协议）
• 适用场景：课程录播、自我介绍视频、知识科普、电商带货口播

⏱️ 动手前 30 秒：环境自检清单

按下面 5 项快速过一遍，有一项不满足就先别装：

• 系统：Windows 10（19042 及以上）或 Ubuntu 22.04
• 显卡：NVIDIA 显卡且已装好驱动——本项目所有算力都在本地，没有 N 卡服务起不来
• 内存：建议 32GB
• 磁盘：Windows 需 D 盘剩余 30GB 以上 + 约 100GB 空间放镜像（C 盘不够后可改位置，见后文可选调优）；Ubuntu 需 100GB 以上
• 网络：首次拉取镜像约 70GB，建议用 WiFi 或有线网络

⚡ Duix.Avatar 最小安装命令

真正必须执行的只有 4 件事：取代码、装 Docker、起服务、装客户端。

取项目代码

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

这一步把部署配置和程序代码下载到本地，后续命令都在这个目录里执行。

安装 Docker

• Windows：安装 Docker Desktop（需先启用 WSL；若启动报 WSL 错误，在终端执行wsl --update后重启 Docker）
• Ubuntu：

sudo apt update && sudo apt install docker.io docker-compose -y

Docker 是跑服务的容器，数字人的语音合成、语音识别、视频生成三个能力都在里面运行，所以它是前置依赖。

启动服务端（含镜像下载）

cd deploy docker-compose up -d

这条命令会下载约 70GB 的 3 个镜像并启动服务，首次需要 20～40 分钟，耐心等待下载完成。Docker Desktop 里出现 3 个服务即代表服务端就绪。

配置较低或想省磁盘，可用单镜像的精简版：docker-compose -f docker-compose-lite.yml up -d，此时只有 1 个服务。

安装客户端

• Windows：从项目 releases 页下载官方打包的安装包（.exe），双击安装
• Ubuntu：下载 AppImage 版，双击即可运行，无需安装

客户端是你实际操作的桌面程序，后台服务只负责计算。

🎬 跑通后第一次体验：创建你的第一个数字人

打开客户端，主界面左侧紫色的Create Video是"做视频"，右侧蓝色的Create Avatar是"造数字人"；下方My Works和My Avatars两个标签页分别存放你生成的视频和数字人。

你的第一次核心操作按这个顺序走：

1. 创建数字人：点击 "Create Avatar"，上传一段约 10 秒的讲话视频
   • 视频必须有声音、且是人在说话，程序靠它克隆你的声音
   • 光线均匀、正对镜头、脸部清晰，克隆效果更好
2. 等待克隆完成：新数字人会出现在 "My Avatars" 列表里
3. 生成第一条视频：点击 "Create Video"，选中刚创建的数字人，输入文案（或上传音频），开始生成
4. 查看结果：视频会进入 "My Works"，可以在线播放和下载

小提示：新手最常见的失败是建模视频没有声音或不是人在说话，报错了先回头检查素材。

⚙️ 可选调优：镜像加速、资源分配与显卡适配

以下内容都标注"可选"，只在遇到对应情况时再做。

可选 1：镜像加速（拉取镜像慢、超时时）

Docker Hub 官方源在国内网络不稳定，拉取失败就去 Docker Desktop 的 Settings → Docker Engine 里添加镜像源，然后点 "Apply & restart"：

{ "registry-mirrors": [ "https://docker.zhai.cm", "https://docker.m.daocloud.io", "https://docker.1ms.run" ] }

完整镜像列表见 doc/常见问题.md。

可选 2：资源分配与镜像位置（C 盘装不下时）

Windows 上 Docker 镜像默认放在 C 盘，70GB 的镜像很容易把 C 盘占满。如果 C 盘不足，在 Docker Desktop 的 Settings → Resources → Advanced 里，用 "Browse" 把 Disk image location 改到剩余空间 100GB 以上的盘，再点 "Apply & restart"。

可选 3：NVIDIA 50 系显卡

5080/5090 等新卡默认镜像的 CUDA 版本可能不匹配，改用项目为 50 系准备的专用配置启动即可（同样在deploy目录下执行）：

docker-compose -f docker-compose-5090.yml up -d

🔍 卡住了？按这个顺序自查

遇到问题不要反复重启，按下面顺序排查，每步 1 分钟内能完成：

1. 看服务端状态：打开 Docker Desktop，确认 3 个服务（精简版 1 个）都是 Running；有服务反复重启，跳到第 3 步
2. 看客户端日志：客户端右上角 Settings → Open Log，找最新的报错行
3. 看容器日志：在 Docker Desktop 点开对应服务 → Logs 标签页，点右侧的复制图标把日志复制下来，找 ERROR 关键字定位
4. 验证显卡：终端执行nvidia-smi，能显示显卡信息说明驱动正常；显示异常就从 NVIDIA 官网重装驱动后重启。本项目算力全靠 N 卡，多数"服务起不来"的问题根源在这里
5. 仍解决不了：翻 doc/常见问题.md，再看项目的 issue 列表——社区更新频繁，你的问题可能已在新版修复，此时到deploy目录重新执行docker-compose up -d更新服务端即可

收尾

Duix.Avatar 的部署路径其实就四件事：取代码、装 Docker、起服务、装客户端，真正的门槛只有 N 卡和磁盘空间两项。

下一步动作：现在就准备一段 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