CentOS装GeneFace++要注意什么

在 CentOS 上安装 GeneFace++（一个基于深度学习的说话人脸生成项目）时，有几个关键点需要特别注意，否则很容易踩坑。下面按「系统层面 → 环境层面 → 项目层面」给你梳理。

一、CentOS 系统层面注意事项

1. 系统版本

• 推荐：CentOS 7.9 / CentOS 8 Stream
• 不推荐 CentOS 6（太老，glibc 版本低）

cat /etc/centos-release

2 升级基础依赖（非常重要）

CentOS 默认软件非常旧，必须装开发工具：

sudo yum groupinstall "Development Tools" -y
sudo yum install -y \
epel-release \
git \
wget \
cmake \
ffmpeg \
libglvnd-glx \
mesa-libGL

⚠️ 注意

• CentOS 7 自带 ffmpeg 通常没有（需要 EPEL 或 RPM Fusion）
• GeneFace++ 处理视频必须 ffmpeg

二、Python 环境（最容易出问题）

1 强烈建议使用 Miniconda

不要用系统 Python！

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh

创建独立环境：

conda create -n geneface python=3.9 -y
conda activate geneface

✅ GeneFace++ 官方推荐 Python 3.9

三、PyTorch 与 CUDA（核心坑点）

1 CUDA 驱动

查看驱动支持的最大 CUDA：

nvidia-smi

GeneFace++ 一般使用：

• CUDA 11.7 / 11.8
• PyTorch 1.13 / 2.0

2 安装 PyTorch（示例）

pip install torch==1.13.1+cu117 torchvision==0.14.1+cu117 \
--extra-index-url https://download.pytorch.org/whl/cu117

⚠️ CentOS 老内核可能不支持新 CUDA
如果报错：

• 升级内核
• 或改用 CPU 版本（不推荐，太慢）

四、GeneFace++ 项目本身注意点

1 克隆仓库

git clone https://github.com/yerfor/GeneFacePlusPlus.git
cd GeneFacePlusPlus

2 依赖安装

pip install -r requirements.txt

常见坑：

• face-alignment 依赖 dlib → 需要 CMake + C++ 编译器
• librosa 需要 soundfile
• opencv 在 CentOS 可能缺 libGL

解决：

pip install opencv-python-headless

五、模型与数据准备

GeneFace++ 需要：

• 预训练模型（官方提供）
• 音频 / 视频预处理

⚠️ 注意事项：

• 模型文件较大（几 GB）
• 确保磁盘空间 > 30GB
• 视频预处理依赖 ffmpeg

六、常见问题汇总（CentOS 特有）

❌ 1 ImportError: libGL.so.1

sudo yum install mesa-libGL -y

❌ 2 Illegal instruction (CPU 太老)

• 老服务器不支持 AVX
• 需源码编译 PyTorch（极不推荐）

❌ 3 gcc 版本过低

gcc --version

至少 gcc 7+

七、推荐配置总结

如果你愿意，可以告诉我：

• CentOS 版本
• 是否有 GPU
• 报错信息

我可以直接帮你“对症下药”一步步装好 ✅