Awesome Digital Human Live2D 项目部署完全指南

项目概述

Awesome Digital Human Live2D 是一个基于Live2D技术的数字人交互系统，它结合了Python后端和Web前端技术，为用户提供高度可定制的数字人交互体验。本文将详细介绍该项目的多种部署方式，帮助开发者快速搭建运行环境。

系统要求

在开始部署前，请确保您的系统满足以下最低配置要求：

• CPU: 至少2核心处理器
• 内存: 至少2GB RAM
• 操作系统: 推荐使用Linux系统(如Ubuntu)进行部署

部署方式选择

本项目提供三种主要部署方式，适用于不同场景：

1. 裸机开发部署 - 适合开发者和需要频繁修改代码的场景
2. 快速容器部署 - 使用预构建镜像，适合快速体验
3. 容器开发部署 - 适合在容器环境中进行开发

裸机开发部署指南

环境准备

1. Python环境:

   • 推荐使用Python 3.10版本
   • 其他Python 3.x版本理论上也可运行，但可能需要调整依赖版本

2. Node.js环境:

   • 推荐使用Node.js 20版本
   • 使用pnpm作为包管理器(比npm性能更高)

3. 系统依赖:

   • 需要安装FFmpeg用于音视频处理

部署步骤

1. 获取项目代码:

   git clone 项目仓库地址
   

2. 后端服务部署:

   # 安装Python依赖
   pip install -r requirements.txt
   
   # 安装FFmpeg(以Ubuntu为例)
   sudo apt update && sudo apt install -y ffmpeg
   
   # 启动后端服务
   python main.py
   

3. 前端Web部署:

   cd web
   
   # 安装pnpm(如未安装)
   npm install -g pnpm
   
   # 安装前端依赖
   pnpm install
   
   # 构建生产版本
   pnpm run build
   
   # 启动前端服务
   pnpm run start
   

容器化部署方案

快速体验部署(推荐)

适合想要快速体验项目功能的用户，使用预构建的容器镜像：

1. 环境准备:

   • 安装Docker和Docker Compose

2. 启动服务:

   docker-compose -f docker-compose-quickStart.yaml up -d
   

容器开发部署

适合需要在容器环境中进行开发的场景：

1. 环境准备:

   • 安装Docker和Docker Compose

2. 构建并启动服务:

   docker-compose up --build -d
   

访问服务

根据部署方式不同，访问地址也有所区别：

• 裸机部署:

  • 本地访问: http://localhost:3000
  • 远程访问: http://服务器IP:3000

• 容器部署:

  • 本地访问: http://localhost:8880
  • 远程访问: http://服务器IP:8880

常见问题与注意事项

1. 端口冲突:

   • 如需修改默认端口，需要同时调整:
     • Docker Compose文件中的端口映射
     • Web项目中的环境变量配置

2. 性能优化:

   • 对于生产环境，建议:
     • 增加系统资源分配
     • 使用Nginx等反向代理进行负载均衡

3. 开发建议:

   • 使用虚拟环境管理Python依赖
   • 保持Node.js和Python版本与推荐版本一致

进阶配置

项目提供了丰富的配置选项，包括但不限于:

• 数字人模型切换
• 交互行为定制
• 音视频参数调整

建议参考项目的详细配置文档进行个性化设置。

总结

Awesome Digital Human Live2D项目提供了灵活的部署方案，无论是开发环境还是生产环境，都能找到合适的部署方式。通过本文的指导，开发者可以快速搭建起数字人交互系统，为进一步的开发和定制打下基础。

对于更高级的配置和使用方法，建议深入研究项目文档和源代码，充分发挥Live2D数字人的潜力。