安装 Nextflow 与环境配置

说实话，装 Nextflow 这件事本身并不复杂。但我见过不少新手在这上面栽跟头——要么 Java 版本不对，要么路径没配好，折腾半天跑不起来。我最早用 Nextflow 的时候也踩过类似的坑，后来总结了一套相对稳当的流程。

这一节我们就把安装环境这件事彻底讲透。你跟着做，基本不会有问题。

系统要求

先说说硬件和软件的门槛。Nextflow 本身是个 Java 程序，所以它对系统的要求主要看 JDK。下面这张清单是我个人经验里最容易出问题的地方：

安装方式怎么选

安装 Nextflow 主要有三种路子：直接下载脚本、用 Conda、或者用 Docker 跑。我个人习惯是：日常开发用 Conda，生产环境用 Docker。为什么？你想想看——Conda 管理依赖方便，但版本锁定要小心；Docker 隔离得彻底，但每次启动要拉取镜像，速度上有点慢。

下面我分别讲清楚每种方式的细节。

通过 Conda 安装

如果你已经装好了 Miniconda 或 Anaconda，接下来就很简单了。打开终端，直接敲：

conda install -c bioconda nextflow

这行命令会从 bioconda 频道拉取 Nextflow 及其 Java 依赖。安装完以后，可以试试 nextflow -version，如果能显示版本号，就说明基础装好了。

等一下——这里有个细节。Conda 默认安装的版本可能不是最新的。我在项目里就吃过这个亏：旧版本不兼容某些 DSL2 特性。所以我一般会指定版本号：

conda install -c bioconda nextflow=24.10.4

版本号你可以去 Nextflow 发布页 查，挑最新的稳定版就行。

通过 Docker 运行 Nextflow

如果你不想在本地装 Java 和 Nextflow，直接用 Docker 镜像也是一种选择。Nextflow 官方提供了 Docker 镜像，里面已经把 Java 和 Nextflow 都打包好了。

docker pull nextflow/nextflow:latest

拉下来以后，用以下命令运行 nextflow 命令：

docker run --rm -v $PWD:/work -w /work nextflow/nextflow:latest nextflow -version

需要注意的是，Docker 方式每次启动都会从头拉取镜像（如果本地没有）。建议提前把镜像拉好，或者写个 shell 函数封装一下：

nxf() {
  docker run --rm -v $PWD:/work -w /work nextflow/nextflow:latest nextflow "$@"
}

然后你就可以直接用 nxf run main.nf 了，跟本地安装几乎没区别。

环境变量设置

装好之后，还需要配几个关键的环境变量。不然 Nextflow 可能找不到 Java，或者工作目录乱飞。

• JAVA_HOME — 指向 JDK 安装目录。如果不配，Nextflow 会用系统默认的 Java，但版本可能不对。
• NXF_HOME — Nextflow 的缓存和配置目录，默认在 ~/.nextflow。我习惯把它放到一个大磁盘分区，避免占满系统盘。
• NXF_WORK — 工作目录，用来放中间文件。如果不设，Nextflow 会在当前目录下生成 work/ 文件夹。
• NXF_TEMP — 临时目录，建议指向内存盘或者 SSD 上的路径。

拿我的 .bashrc 举个例子：

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export NXF_HOME=/data/nextflow
export NXF_WORK=/data/nextflow_work
export NXF_TEMP=/dev/shm
export PATH=$JAVA_HOME/bin:$PATH

验证安装

环境变量配好之后，我们来做个快速验证。打开终端，依次执行下面三条命令：

java -version
nextflow -version
nextflow run hello

第一条确认 Java 版本 >= 11。第二条确认 Nextflow 安装成功并显示版本。第三条会运行 Nextflow 自带的 hello 示例流程。如果你看到类似下面的输出，说明一切正常：

 N E X T F L O W  ~  version 24.10.4
Launching `hello` [nostalgic_wozniak] DSL2 - revision: e6e1c1d2e3
[4a/3b2c1d] process > sayHello (1)
[8f/9e7d6c] process > sayHello (2)
...

这里要注意：如果运行 nextflow run hello 时报错提示 “No such file: hello”，别慌——去 GitHub 上把 nextflow-io/hello 仓库克隆下来，然后 nextflow run main.nf 就行了。我当年就是卡在这一步，一度以为安装失败了。

安装流程总览

为了让你对整个安装过程有一个清晰的印象，我画了张流程图。你跟着箭头走一遍，基本就不会漏掉什么：

这张图从系统要求出发，分两条支线到 Conda 和 Docker，然后统一经过环境变量配置，最后验证。你跟着走一遍，零基础也能搞定。

常见问题与避坑

最后再分享几个实际中容易遇到的问题：

• Permission denied——如果你是用直接下载脚本的方式（wget -qO- https://get.nextflow.io | bash），记得给 nextflow 文件加可执行权限：chmod +x ./nextflow。
• java.lang.UnsupportedClassVersionError——Java 版本太低。换成 JDK 11 以上的版本就行。
• Nextflow 启动巨慢——检查 NXF_HOME 是不是设在了网络磁盘上。第一次启动会下载一些依赖文件，放在本地 SSD 上能快很多。
• Docker 内无法访问宿主机文件——记住用 -v $PWD:/work -w /work 挂载当前目录。