Linux 上如何免费部署本地 AI 数字人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 秒视频克隆一个人此后任意文案都能变成他出镜的播报视频文案、音频两种驱动方式都支持脚本覆盖中、英、日、韩等 8 种语言动手前先把硬件门槛看清楚Duix Avatar 部署路上最常见的坑不是命令而是配置。先对照下表自查全部达标再进入下一步项目最低要求是否必需备注系统Ubuntu 22.04推荐唯一完成完整验证的桌面 Linux其他发行版未测显卡NVIDIA RTX 4070必需50 系列如 5090可用但要换专用启动文件显卡驱动NVIDIA 官方驱动装好必需全部算力在本地缺驱动服务直接起不来内存32 GB必需16 GB 可能导致 ASR 服务启动失败CPU13 代 i5-13400F 级别推荐非硬性门槛硬盘100 GB 以上空闲必需首次拉取镜像约消耗 70 GB容器工具Docker Compose必需用docker --version检查有版本号可跳过安装 用四步跑通部署主线这条主线把环境准备、服务拉起、客户端接通串成一条线按顺序执行即可。第一步安装 Docker 并验证基线Docker 可以理解成把程序和它的依赖一起打包运行的隔离沙箱Compose 则是用一份 yml 文件统管多个 Docker 容器的工具。sudo apt update sudo apt install docker.io docker-compose docker --version验收标志docker --version输出带版本号的行没有报错已装过则直接跳到下一步。第二步安装 NVIDIA 驱动与容器工具包NVIDIA Container Toolkit 是 Docker 与显卡之间的桥梁缺了它容器内看不见GPU。先在 NVIDIA 官方驱动页面按你的显卡型号装好驱动再执行nvidia-smi distribution$(. /etc/os-release;echo $ID$VERSION_ID) \ curl -s -L https://nvidia.github.io/libnvidia-container/gpgkey | sudo apt-key add - \ curl -s -L https://nvidia.github.io/libnvidia-container/$distribution/libnvidia-container.list | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list sudo apt-get update sudo apt-get install -y nvidia-container-toolkit sudo nvidia-ctk runtime configure --runtimedocker sudo systemctl restart docker验收标志nvidia-smi显示显卡型号与驱动版本最后两条命令跑完无报错。第三步拉取代码并启动三个服务容器git clone https://gitcode.com/GitHub_Trending/he/Duix-Avatar cd Duix-Avatar/deploy docker-compose -f docker-compose-linux.yml up -d首次运行要下载约 70 GB 镜像耐心等。拉取卡住或超时就在/etc/docker/daemon.json里补一份国内镜像列表registry-mirrors保存后重启 Docker 再试registry-mirrors: [ https://docker.zhai.cm, https://a.ussh.net, https://hub.littlediary.cn ]验收标志docker compose ps里三个容器全部呈 Running 状态。第四步启动客户端并完成首次克隆到项目发布页下载 Linux 版 AppImage免安装格式双击即可运行在终端执行chmod x Duix.Avatar-*.AppImage ./Duix.Avatar-*.AppImage当前是 root 用户的话命令末尾补上--no-sandbox。验收标志客户端主界面打开右上角能看到创建形象和生成视频两个入口。✅ 逐项核对上线验证清单查容器状态deploy 目录执行docker compose ps三个服务均为 Running 且无异常重启。查服务日志逐个打开容器日志确认没有持续刷出的 ERROR。查显卡链路nvidia-smi正常显示显卡说明容器已能调用 GPU 算力。试建形象客户端上传一段人在说话、带声音的 10 秒视频生成模特。试出视频输入一段短文案生成口播视频确认画面与声音同步。熟悉日志入口客户端右上角设置菜单里可打开运行日志排障时先找它。遇到问题先对照排错速查表Duix Avatar 部署中的报错大多逃不出下面几种现象最可能原因处理动作拉镜像超时、compose 启动失败官方仓库连接不稳定在/etc/docker/daemon.json添加registry-mirrors国内镜像并重启 Docker三个服务起不来或反复重启NVIDIA 驱动缺失或未被识别跑nvidia-smi验证驱动装好后重新启动 compose创建模特报 Connection refusedASR 服务启动慢或内存不足服务起来后等几分钟再克隆内存须达 32 GB新增模特失败样片无声或画面中无人说话重新录制一段约 10 秒、口齿清晰的说话视频root 下 AppImage 打不开沙箱机制限制启动命令追加--no-sandbox参数面向二次开发的进阶入口Duix Avatar 把模特训练与视频合成为本地 APIDocker 启动后从127.0.0.1即可调用请求示例都在仓库里模型服务示例src/main/service/model.js视频合成服务src/main/service/video.js语音服务src/main/service/voice.js50 系列显卡专用启动文件deploy/docker-compose-5090.yml更多疑难场景doc/常见问题.md建议先用 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考