4. Centrifuge 安装与编译归纳总结

Centrifuge 的安装其实不复杂，但坑也不少。我早期在几台不同的服务器上踩过一些雷，今天就帮你把这些雷都排一排。

4.1 系统依赖环境

先把依赖搞定，不然编译一半报错会很烦。我习惯在编译前先检查一遍：

依赖项	用途	常见安装方式
g++ ≥ 4.8	C++11 编译器	apt install g++ / yum install gcc-c++
CMake ≥ 3.0	构建系统	apt install cmake / 官网下载源码编译
zlib1g-dev	压缩库	apt install zlib1g-dev
libbz2-dev	Bzip2 压缩	apt install libbz2-dev
liblzma-dev	XZ 压缩（可选）	apt install liblzma-dev
pthreads	多线程支持	系统自带，无需额外安装

4.2 下载源码

官方仓库在 GitHub，用 git clone 就行。我个人习惯先创建一个干净的目录：

mkdir -p ~/tools && cd ~/tools
git clone https://github.com/DaehwanKimLab/centrifuge.git
cd centrifuge

记得，如果你用 wget 下载压缩包再解压，版本号容易搞混。我曾经有一次下错了 tag，编译出来旧版本，跑结果时才发现……后来我就只认 git clone 了。

4.3 编译过程

Centrifuge 用的是 CMake 构建系统，非常简单：

mkdir -p build && cd build
cmake ..
make -j$(nproc)

嗯，这里有个小细节：-j$(nproc) 会自动获取 CPU 核数并行编译，能快不少。我之前在 32 核服务器上编译，不到 30 秒就搞定了。

如果你想安装到系统路径，继续执行：

sudo make install

不过我个人更倾向于不安装，直接在 build 目录下用相对路径调用，这样多版本切换方便。

4.3.1 CMake 选项说明

Centrifuge 的 CMake 选项不多，但有几个值得关注：

选项	默认值	说明
-DCMAKE_INSTALL_PREFIX	/usr/local	安装路径
-DCMAKE_BUILD_TYPE	Release	编译类型，可选 Debug 方便调试
-DUSE_MPI=ON	OFF	启用 MPI 并行（需要安装 MPI 库）
-DUSE_OMP=ON	ON	启用 OpenMP 多线程

4.4 验证安装

编译完成后，先运行一下版本信息：

./centrifuge --version

如果输出类似 centrifuge 1.0.4 就基本没问题了。你也可以跑一个简单的测试：

./centrifuge -x /path/to/index -q /path/to/test.fa -S test.out

我建议顺便检查一下可执行文件的动态链接库是否完整：

ldd ./centrifuge | grep "not found"

如果什么也没输出，说明依赖都齐了。有一次我在 glibc 版本低的老机器上编译，ldd 报了很多 libstdc++ 找不到，后来升级了 gcc 才解决。

4.5 常见问题与避坑指南

我把常见的安装编译问题整理了一下，你遇到了可以直接查：

• CMake 找不到 zlib：看看 zlib1g-dev 有没有装，或者手动指定路径 -DZLIB_ROOT=/usr/local/zlib。
• 编译时报错 “undefined reference to `gzopen'”：说明 zlib 链接没找到，检查 cmake 输出里有没有 Found ZLIB 一行。
• 编译内存不足：Centrifuge 的编译需要大约 1 GB 内存。如果你在低配 VPS 上编译，可以用 make -j1 单核编译，慢点但稳。
• 找不到 pthread_create 符号：老版本 gcc 需要链接 -lpthread，可以尝试 cmake .. -DCMAKE_EXE_LINKER_FLAGS="-lpthread"。

4.6 安装编译整体流程

下面这张图总结了 Centrifuge 从环境检查到最终部署的完整流程，你可以当作安装前 checklist：

4.7 最后的建议

Centrifuge 安装完成后，我建议你再做两件事：

1. 把编译好的 centrifuge 和 centrifuge-build 所在目录加到 PATH 里，方便日常调用。
2. 跑一遍官方提供的 example 数据，验证索引构建和比对功能是否正常。这一步花不了几分钟，但能帮你快速确认安装没有隐藏问题。