Duix.Avatar v1.0.5→v1.0.6 升级指南Ubuntu 22.04 与 RTX 5090 部署方案落地【免费下载链接】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-AvatarDuix.Avatar开源离线数字人视频生成工具最近一次版本更新日志围绕三件事Ubuntu 22.04 桌面版适配验证、NVIDIA 50 系显卡专属服务端方案、客户端英文国际化。本文按对使用者的实际影响组织变更帮你在 10 分钟内判断要不要升、怎么升。 升级决策卡结论先说如果你是 Linux 桌面用户或 50 系显卡用户必须升纯 Windows 30/40 系显卡且现网运行正常可缓。维度变化操作系统仅 Windows 10/11 → 新增 Ubuntu 22.04内核 6.8.0-52-generic 已验证最低硬件门槛未变化NVIDIA 显卡为硬性要求推荐 RTX 4070 / 内存 32G部署体积新增 lite 模式1 个服务约 1 个镜像替代全量 3 个拉取流量明显下降API 是否破坏兼容不破坏三个服务端口 8383/18180/10095 及接口路径保持一致读完全文你拿到三条可复制的服务端部署命令Ubuntu 全量 / lite / RTX 5090lite 版与全量版的服务、镜像差异对照用于估算自己的部署成本一份 4 行踩坑清单全部来自官方 doc/常见问题.md 真正影响你的 3 项变更用 1 条命令在 Ubuntu 22.04 起完整服务端对使用者而言这意味着 Linux 桌面从无法部署变成一条命令起服务 免安装客户端。服务端走独立的 deploy/docker-compose-linux.yml数据目录落在~/duix_avatar_dataWindows 版是D:/duix_avatar_data两套 compose 文件路径不同别混用客户端是 AppImage无需安装。硬件门槛没变NVIDIA 显卡是硬性要求官方验证环境为 Ubuntu 22.04 Desktop内核 6.8.0-52-generic 推荐配置 i5-13400F / 32G 内存 / RTX 4070。cd deploy docker-compose -f docker-compose-linux.yml up -d唯一要动手的细节root 用户进桌面时AppImage 双击可能起不来需要在终端执行./Duix.Avatar-x.x.x.AppImage --no-sandbox。其余前置步骤装 Docker、配 NVIDIA Container ToolkitREADME_zh 里都有现成命令按序执行即可。换 RTX 50 系显卡时切换 5090 专属 compose 文件对使用者而言这意味着 5090 用户不再需要自己折腾 CUDA 环境——仓库直接给出独立部署方案。deploy/docker-compose-5090.yml 换用guiji2025/duix.avatar-5090与guiji2025/fish-speech-5090两个镜像README 说明基于 PyTorch 官方预览版并在 5090 上实测通过30/40 系 CUDA 12.8 用户也可以采用该方案。cd deploy docker-compose -f docker-compose-5090.yml up -d一个必须留意的差异5090 方案里没有 ASR 服务。全量 compose 启动 3 个服务tts/asr/gen-video5090 版只启动 2 个。绕不开的一点是如果你要克隆形象训练需要 ASR 转写参考音频5090 方案下这条链路缺位升级前必须确认自己的业务是否依赖声音克隆。lite 版只留视频合成服务砍掉 TTS 与 ASR对使用者而言这意味着只上传音频 模型视频来合成口播视频时可以不拉全部三个镜像。lite 版deploy/docker-compose-lite.yml只启动duix-avatar-gen-video一个服务端口仍是 8383cd deploy docker-compose -f docker-compose-lite.yml up -d对比一下全量版 3 个镜像fun-asr / fish-speech-ziming / duix.avatarlite 版 1 个README 给出全量版首次拉取约 70G 流量、耗时半小时上下lite 版的拉取时间和显存占用都按服务数量同比例下降。音频由上游系统产出、只需要视频合成能力的集成场景用 lite 版能显著降低部署成本。另外两项小变更一句话带过客户端界面补充英文国际化脚本语言支持英日中韩法德阿西 8 种语言READMEWhats New 同时声明修复了 #304、#292 两个已知 issueissue 详情仓库内未附升级前可在项目仓库自行核对。 可验证的数据仓库中没有公开的 benchmark 脚本合成耗时、吞吐这类数字我没有可信来源不写。能直接溯源的只有部署侧数据全量版首次拉取约70G流量、30 分钟上下README 官方口径官方推荐内存32G 及以上doc/常见问题.md 明确 16G 内存可能启动不了ASR 服务视频合成服务固定shm_size: 8g见各 compose 文件推荐显卡 RTX 4070、CPU i5-13400FWindows 另要求 D 盘 30G C 盘 100G 空闲给你的操作建议升级后自己跑一遍克隆形象 → 合成音频 → 合成视频标准流程记录各阶段耗时。这组本地基线数据是你判断下一版本是否值得升的唯一可靠依据。 迁移实操与避坑主迁移路径Ubuntu 22.04 全新部署sudo apt install docker.io docker-compose # 按 README_zh 安装 NVIDIA Container Toolkit 并重启 Docker cd deploy docker-compose -f docker-compose-linux.yml up -d # lite 版docker-compose -f docker-compose-lite.yml up -d # RTX 5090docker-compose -f docker-compose-5090.yml up -d踩坑 → 解法现象原因命令/配置修复docker-compose up -d拉镜像超时request canceledDocker Hub 官方源不稳定在/etc/docker/daemon.json增加registry-mirrors国内镜像源列表README_zh 有完整 JSON 示例新增模特报错源视频没有声音或不是人在说话无法做声音克隆重录一段 10 秒左右、人声清晰的视频定制模特报Connection refusedfunasr 连接异常ASR 服务启动慢内存太小如 16G可能导致服务起不来服务端启动后等 2-3 分钟再操作内存不足需扩容root 用户下 AppImage 双击无反应Ubuntu 桌面 sandbox 限制终端执行./Duix.Avatar-x.x.x.AppImage --no-sandbox升级前必须核对的配置项volume 路径跨平台不可复制Windows 版挂d:/duix_avatar_data/...Linux 版挂~/duix_avatar_data/...跨平台迁移时改 compose 文件而不是改目录客户端数据存在本地 SQLitesrc/main/db/index.js客户端升级重新构建后沿用原数据目录即可无迁移步骤服务接口无变更客户端固定调用127.0.0.1:8383视频合成与127.0.0.1:18180TTS定义在 src/main/config/config.js只要 compose 的端口映射不动外部集成脚本不用改代码仓库未声明任何废弃配置项config.js中无被移除的键✅ 收尾这次更新的价值是把部署入口补齐50 系显卡和 Linux 桌面从官方不支持变成有现成方案。对使用者是一次低风险的平台扩展不是引擎升级。后续若有新硬件适配以 READMEWhats New 与 deploy 目录的新 compose 文件为准。【免费下载链接】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），仅供参考