2. Vina 安装与编译：源码编译、二进制安装、Docker 部署、路径配置

做分子对接，第一件事就是把 Vina 装好。这事说简单也简单——官网下一个二进制文件就能跑；说复杂也复杂——碰到特定系统、CUDA 加速、批量任务，你还是得从源码自己编译。我当年从零折腾 Vina 的时候，光是环境变量就配错了好几轮，嗯，今天咱们把这几种安装方式一次讲透。

2.1 二进制安装：最省事的办法

如果你只是想快速验证安装，或者跑个小数据集，直接从官方 Releases 页下载编译好的可执行文件就行。

步骤：

1. 找到与你系统匹配的二进制包（Linux x86_64、macOS、Windows）。
2. 解压到 /usr/local/bin 或任意 PATH 目录。
3. 加执行权限：chmod +x vina
4. 运行 vina --version 验证。

二进制安装的缺点也很明显：没法自定义编译选项（比如开启多线程、调整评分函数参数），也不能针对你的 CPU 指令集做优化。说白了就是一个黑盒子，能用但不好调。

2.2 源码编译：掌控一切

我个人强烈建议，凡是正式项目都用源码编译。你想想看，对接结果差 0.1 kcal/mol 可能就影响化合物筛选的排序，而编译器选项带来的浮点精度差异，有时候真能带来这种差别。

前置条件：

• CMake ≥ 3.10
• C++ 编译器支持 C++14（GCC 7+、Clang 6+）
• (可选) Boost 库（Vina 1.2.x 之后已不再强制依赖）
• (可选) OpenMP 支持（用于并行评分）

编译步骤（以 Linux 为例）：

git clone https://github.com/ccsb-scripps/AutoDock-Vina.git
cd AutoDock-Vina
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)
sudo make install

这里有几个坑，我踩过记得很清楚：

编译完成后，可执行文件在 build/bin/ 下。你可以直接复制到系统路径，或者用 sudo make install 自动安装到 /usr/local/bin。

高级编译选项：

编译完了怎么验证？跑一下内置测试：

cd build
ctest -V

所有测试通过，说明环境没问题，放心用。

2.3 Docker 部署：再也不用担心环境依赖

做计算化学最烦的就是换一台机器环境就崩了。我记得有一次在超算上装 Vina，管理员不给装依赖库，搞了三天才跑起来。后来我学乖了，直接打 Docker 镜像，丢哪都能跑。

Dockerfile 示例：

FROM ubuntu:22.04

RUN apt-get update && apt-get install -y \
    cmake g++ git wget \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /opt
RUN git clone https://github.com/ccsb-scripps/AutoDock-Vina.git \
    && cd AutoDock-Vina \
    && mkdir build && cd build \
    && cmake .. -DCMAKE_BUILD_TYPE=Release \
    && make -j$(nproc) \
    && make install

ENTRYPOINT ["vina"]

这样打完镜像，你可以在任何有 Docker 的机器上执行：

docker build -t vina:latest .
docker run --rm -v $(pwd)/data:/data vina:latest \
    --receptor /data/1iep.pdbqt \
    --ligand /data/ligand.pdbqt \
    --out /data/output.pdbqt

Docker 部署的另一个好处是方便批量调度——配合 SLURM 或 Kubernetes，你可以同时起几十个容器并行跑不同配体，互不干扰。

2.4 路径配置：让系统找到 vina

装好之后，最基础也是最容易忽略的一步：把 Vina 的路径加到环境变量里。不然每次都要打全路径，批量脚本写起来也很累。

推荐的三种方式：

• 方式一（用户级）： 编辑 ~/.bashrc，添加：

  export PATH=$PATH:/usr/local/bin

  然后 source ~/.bashrc
• 方式二（系统级）： 将可执行文件放入 /usr/local/bin 或 /usr/bin，这些目录通常已在 PATH 中。
• 方式三（模块化，适合集群）： 用 Environment Modules 工具定义模块文件，我一般在 /etc/modulefiles/vina/ 下放一个：

  #%Module1.0
  set version 1.2.5
  prepend-path PATH /opt/vina/${version}/bin
  prepend-path LD_LIBRARY_PATH /opt/vina/${version}/lib

  用 module load vina 切换版本，干净利落。

2.5 知识框架图：安装方式对比

下面这张图梳理了三种安装方式的关系，以及你该如何根据场景选择。

2.6 总结与避坑清单

安装这事，看起来简单，但环境搭不好后面全白干。我把常见的坑列一下，你装的时候可以对照着检查。