FLUKA 这款软件，做辐射防护和粒子输运的人应该都不陌生。它和 MCNP、Geant4 并列为蒙特卡罗模拟工具里的老牌主力，在加速器屏蔽设计、医学物理、空间剂量评估这些方向都有大量应用。问题是，对很多刚接触它的人来说，第一步不是学会写输入卡片，而是先把软件在 Linux 上装起来。我过去帮学生配过不少次环境，也见过很多人卡在各种奇怪的报错上，最后连程序都没跑起来就放弃了。这篇笔记基于我在 Ubuntu 20.04/22.04 上的完整安装过程，所有命令都实际操作验证过，按照步骤复制即可；如果你想长线用 FLUKA 做计算，我也把环境变量、配套 GUI、验证方法这些细节一并写了。

我不打算讲太多空泛的“蒙特卡罗原理”，而是直接把你需要敲的命令、需要改的文件和需要避开的坑铺开讲。从一个从业者的角度说，安装这类科学计算软件，最核心的就三件事：依赖环境是否齐全、路径变量是否配置正确、能不能跑通一个官方自带的测试算例。只要这三件事过关，后面出问题的概率会小很多。

1. 安装前的准备工作：别急着下载，先把系统底子打好

1.1 确认你的 Ubuntu 版本和系统架构

FLUKA 官方目前主要提供 64 位 Linux 版本，理论上支持 Ubuntu 18.04 到 24.04 这些主流发行版，实测下来 20.04 和 22.04 都得很顺利。如果你用的是 24.04，需要注意系统默认的 Python 版本已经是 3.12，对后面装 Flair 或关联工具会有一些影响，但不影响 FLUKA 核心程序运行。

首先确认你的系统信息：

uname -m

正常情况下输出是x86_64。如果你是在 ARM 架构的机器上装 Ubuntu，比如某些开发板或者 Apple Silicon 虚拟机里跑的 ARM Linux，那么你需要去官方下载页面确认有没有对应的 ARM 架构二进制包。我个人的建议是：能用 x86_64 就跑 x86_64，不要自己折腾源码交叉编译，FLUKA 的构建体系对新手并不友好。

接着确认你的 Ubuntu 版本：

lsb_release -a

1.2 一次性装齐编译器和基础依赖

FLUKA 本身虽然是预编译好的二进制，但它外层的运行脚本、配套工具和后续的几何建模工具仍然依赖不少系统组件。我在第一次安装时犯过一个低级错误：只等着下载官方包，结果运行脚本时报了一堆“找不到解释器”“找不到命令”的错，后来才发现原来 tcsh 和 gfortran 没装。

执行下面这组命令，把常见依赖一口气装完：

sudo apt update sudo apt upgrade -y sudo apt install -y tcsh perl make gcc g++ gfortran python3 python3-pip python3-tk libxm4 libxpm-dev libxft-dev libxext-dev

解释一下这些包的作用：

• tcsh：FLUKA 的rfluka启动脚本默认依赖 C Shell 语法，如果没装 tcsh，会报/bin/sh: bad interpreter或者类似错误。
• gfortran：虽然官方二进制不需要你自己编译 Fortran，但某些辅助工具和扩展程序运行时需要 Fortran 运行时库。
• libxpm-dev libxft-dev libxext-dev：后面装 Flair 或者某些图形界面工具时会用到，提前装好省得再来一次。

注意：不要在这一步跳过tcsh。网上不少教程默认你的系统已经有 C Shell，但 Ubuntu 默认是没有的。这个坑几乎每个人都会踩一次。

1.3 申请 FLUKA 下载权限和版本选择

FLUKA 的下载机制和普通开源软件不太一样，它需要通过官方渠道提交申请，审核通过后会给你一个下载链接。整个注册流程比较简单，只需要提供工作邮箱和单位信息，审核周期一般在一个工作日内。

我建议你直接去 FLUKA 官网提交下载请求，拿到压缩包后再回来继续。不建议在第三方网盘或者论坛上找别人转载的二进制包，一来无法确认是否被篡改，二来版本可能非常老旧，缺少官方最近的修复和物理模型更新。

FLUKA 目前主流版本是 4 系列，你拿到的压缩包可能是fluka-4-x.y.tar.gz这样的命名，解压后具体版本号会有差异，但安装逻辑完全一样。

2. FLUKA 核心程序安装：从解压到环境变量配置

2.1 选择安装目录并解压

官方压缩包解压后是一个独立的目录，理论上放在任何位置都能运行。但考虑到后面写输入文件、跑算例都会生成大量文件，我的建议是单独建一个软件目录，不要直接扔在~/Downloads里，避免误删或者路径混乱。

下面是我常用的目录结构：

mkdir -p ~/opt cd ~/opt tar -xzf ~/Downloads/fluka-4-x.y.tar.gz ls -l

解压后你会看到一个以版本号命名的目录，比如fluka-4-3.0。为了后续配置环境变量方便，我习惯于把它重命名成简洁的FLUKA：

mv fluka-4-3.0 FLUKA

2.2 配置 FLUPRO 环境变量

FLUKA 运行时会通过环境变量FLUPRO查找自己的主目录、示例文件、编译好的可执行程序。也就是说FLUPRO必须指向你刚才解压出来的那个目录，否则运行脚本会一直报“找不到文件”。

打开.bashrc文件：

vim ~/.bashrc

在文件末尾追加：

export FLUPRO=$HOME/opt/FLUKA export PATH=$PATH:$FLUPRO/flutil:$FLUPRO/bin

然后让配置立刻生效：

source ~/.bashrc

验证路径是否设置正确：

echo $FLUPRO

如果输出/home/你的用户名/opt/FLUKA，就说明这一步已经完成了。

提示：有些教程会让你在/etc/profile或者/etc/environment里配置全局环境变量，我建议不要这么做。一方面把个人软件路径放到系统级配置里会让其他用户也看到，另一方面后续如果换版本、改目录还要动系统文件，非常不灵活。写在用户级.bashrc里最合理。

2.3 source 初始化脚本

FLUKA 自带一个初始化脚本，通常在安装目录下的flutil/fluka-init或者类似位置。这个脚本会帮你把 PATH、LD_LIBRARY_PATH 等变量都整理好，省得你自己一个个去 export。

不同小版本之间这个脚本的名字可能略有差异，以官网文档为准。我这里是常见版本的做法：

source $FLUPRO/flutil/fluka-init

如果你希望以后每次打开终端都自动加载，可以把这行也写入.bashrc：

echo "source $FLUPRO/flutil/fluka-init" >> ~/.bashrc

不过要提醒一下：如果你同时写入了export FLUPRO和source fluka-init，那么.bashrc中这两行的顺序不要弄反。必须先定义FLUPRO，再执行初始化脚本，否则脚本里引用的$FLUPRO是空的。

2.4 验证核心程序是否可用

安装完成的标志是rfluka命令可以被系统找到。执行：

which rfluka

如果输出类似~/opt/FLUKA/flutil/rfluka的路径，就说明命令已经进入 PATH，接下来可以开始测试运行了。

3. Flair 图形界面：安装与联调，让复杂输入文件不再劝退新手

3.1 Flair 和 FLUKA 的关系

FLUKA 核心程序本身是个命令行工具，你输入的是一份纯文本的卡片文件（.inp文件）。但这套卡片语法比较繁琐，尤其是几何定义部分，稍不注意就写错一个坐标，然后整个模型就废了。Flair 是 FLUKA 官方配套的图形界面工具，可以帮你编辑输入文件、检查卡片格式、查看几何结构、提交计算任务并可视化结果。

用一句不严谨但好理解的话来说：FLUKA 是发动机，Flair 是仪表盘。发动机不装好，仪表盘再漂亮也没用；但如果只是偶尔跑一两个简单算例，只装核心程序也可以。我个人的建议是：新手一开始就把 Flair 装好，因为它的几何预览和卡片自动补全功能能省掉大量低级错误。

3.2 Python 依赖和 Flair 安装

Flair 是用 Python 写的，所以需要先确认 Ubuntu 里 Python3 环境正常：

python3 --version

接下来安装 Python 包依赖。由于 Ubuntu 对系统级 Python 环境做了权限管理，我强烈建议用虚拟环境或者--user方式安装，不要直接用 sudo pip 往系统目录里写：

pip3 install --user numpy matplotlib

Flair 本身可以从 FLUKA 官方下载页面拿到对应的发行包，一般是一个压缩包，解压后是一个放在哪都能运行的目录。官网经常提供预打包版本，优先选择预打包版本，省去自己编译依赖的麻烦。

解压后，建议把 Flair 目录也放进 PATH：

export PATH=$PATH:$HOME/opt/flair

然后在终端里尝试启动：

flair

如果能弹出一个图形窗口，说明核心依赖没有问题。

3.3 在 Flair 中指定 FLUKA 路径

第一次打开 Flair 时，它不一定能自动找到 FLUKA 的根目录。你需要在界面的设置项里手动指定FLUPRO路径和 FLUKA 版本号。

具体操作路径根据版本略有不同，但一般都在“Settings”或者“Configuration”里。设置好后，Flair 会读取 FLUKA 自带的物理模型数据，这样你才能在图形界面中正确分析输入卡片。

如果你是在本地 Ubuntu 上安装，Flair 直接打开、直接改文件、直接提交作业就可以。真正需要留意的是远程服务器场景，下面我会专门说一下。

3.4 Ubuntu 24.04 的特殊处理

Ubuntu 24.04 默认 Python 3.12 移除了distutils，这本来不是什么大问题，但某些版本的 Flair 依赖包在安装时仍会对distutils做检查，导致安装中断。如果你遇到这类提示，可以先装一个兼容层：

sudo apt install -y python3-setuptools

然后再重试 pip 安装。这个坑在 20.04 和 22.04 上不会遇到，但我在 24.04 上实测时就碰上了，记录下来提醒大家。

4. 跑通第一个算例：用官方示例验证安装是否真正可用

4.1 准备一个运行目录

FLUKA 运行时会生成一堆中间文件，包括输入文件的拷贝、输出文件、二进制结果文件等。我强烈建议每个算例都单独建一个工作目录，不要把运行文件直接放在$FLUPRO下面，否则时间一长，软件目录会被各种临时文件搞得乱七八糟。

mkdir -p ~/flukarun/test01 cd ~/flukarun/test01

4.2 复制并运行官方示例

FLUKA 压缩包内的examples目录自带多个示例输入文件，这些文件覆盖了不同物理场景，是验证安装最可靠的选择。你不需要自己从零写输入卡片，因为那反而可能因为卡片格式问题干扰你对“安装是否成功”的判断。

ls $FLUPRO/examples/

从列表里挑一个简单的.inp文件复制到工作目录，然后运行：

cp $FLUPRO/examples/xxx.inp . rfluka xxx.inp

其中xxx.inp是你选中的示例文件名字。FLUKA 默认会读取当前目录下所有需要的资源，如果一切正常，终端会刷出大量运行日志。

4.3 如何判断运行是否成功

运行结束后，当前目录会出现多个文件，最需要关注的是.out文件和.bnn文件。.out是标准输出，记录了整个模拟过程的关键信息；.bnn是二进制结果文件，后面用 Flair 查看剂量分布都要靠它。

判断是否成功，最简单的办法是看日志最后几行：

tail -n 30 xxx001.out

注意：FLUKA 的输出文件名会在输入文件名后自动追加三位数字，类似xxx001.out。如果正常结束，日志末尾通常会出现“Run terminated”或者类似的结束标志；如果中途崩溃，日志会停在某个错误信息附近，并伴有大量的问号提示。

4.4 多线程加速参数说明

跑测试算例时默认单线程就够了，但如果后续要跑实际物理模型，建议利用多核 CPU：

rfluka -N 4 xxx.inp

-N 4表示同时跑 4 个循环（cycles），一般取 CPU 核心数即可。需要注意的是，FLUKA 的多线程机制是把不同循环分发给多个任务并行，而不是像 OpenMP 那样共享内存并行。如果你的服务器有 16 个物理核心，-N 16是可行的，但如果你的机器本身还跑着其他任务，建议留几个核心给系统和其他进程。

5. 我踩过的坑：FLUKA 安装与运行常见问题速查

5.1 环境变量不生效，每次都要重新 source

症状：终端里执行rfluka提示command not found，但明明刚才还能运行。

原因：你把export FLUPRO写在了一个临时终端窗口里，并没有写进.bashrc，或者写入后没有重新加载。

解决：

source ~/.bashrc

如果仍然找不到命令，检查是否在.bashrc里写了export FLUPRO之后再写source $FLUPRO/flutil/fluka-init，顺序错误会导致后面一行里的$FLUPRO是空的。

5.2 运行报错：找不到 tcsh 或 bad interpreter

症状：rfluka一执行就报错，提示解释器有问题。

原因：Ubuntu 默认没有安装 tcsh，而 FLUKA 的启动脚本引用了 C Shell 语法。

解决：回到上面第 1.2 节，执行：

sudo apt install -y tcsh

这类问题不会在官方文档里被反复强调，因为几乎所有科学计算 Linux 环境都会预装，但普通的 Ubuntu 桌面版就是没有。

5.3 运行中途报错：找不到 gfortran 相关库

症状：程序已经在跑了，但某个辅助模块突然报错，提示找不到libgfortran.so。

原因：使用了某些需要 Fortran 运行时的辅助工具，但系统没装 gfortran。

解决：

sudo apt install -y gfortran

装完后再重跑一次即可。严格来说，这不一定发生在安装阶段，而是在后续编译用户自定义的辅助程序时更常见，反正提前装好不会有坏处。

5.4 WSL 环境下 Flair 图形界面打不开

症状：在 WSL 或者虚拟机里跑核心程序没有问题，但输入flair后没有图形窗口弹出来。

原因：WSL 早期版本没有内置图形界面支持，需要 X Server 配合；虚拟机则可能没有正确安装增强工具，导致 OpenGL 相关功能异常。

解决：

• Windows 11 自带 WSLg，一般直接就能弹出窗口。
• 如果是旧版 WSL，可以在 Windows 侧启动 X Server，然后在 WSL 里设置export DISPLAY=:0。
• 如果只是想快速验证安装，可以不依赖图形界面，直接用文本编辑器改写.inp文件，用命令行跑rfluka，效果完全一样。

5.5 运行目录里出现大量临时文件，找不到主输出

症状：跑完一个算例后，目录里全是.tmp、.dat、.out文件，看得眼花缭乱。

原因：FLUKA 默认在当前目录生成所有中间文件，用户没有做目录隔离。

解决：从一开始就养成“一个算例一个文件夹”的习惯，每个文件都放在独立的目录里，输出文件名也保持和输入文件名一致，这样后续整理数据和写论文时都会省心很多。

5.6 常见问题速查表

6. 几点实用的安装后配置建议

6.1 关于源码编译：能劝退就劝退

FLUKA 官方提供的是预编译二进制包，对绝大多数人来说完全够用。但总有朋友出于“掌控感”想从源码自己编译，结果一般都会陷入依赖泥潭：需要特定版本的 gfortran、特定版本的 CMake、以及可能跟系统库冲突的底层依赖。

更有甚者，FLUKA 某些底层代码涉及大量编译选项，新手如果不知道如何开启并行支持，编译出来的版本甚至可能比预编译版本性能更低。所以我的结论是：除非你是 FLUKA 内部开发人员或者有明确的定制需求，否则不要自己从源码编译。把时间花在物理模型学习和输入卡片调试上，收益大得多。

6.2 建议保留一份干净的模型计算目录结构

我自己的习惯是这样：

~/flukarun/ ├── case01/ │ ├── input.inp │ └── output/ ├── case02/ └── case03/

每一个 case 目录放一个独立的算例，输出文件和输入文件分开管理。这样不管过了多久回来看，我都能一眼找到想要的模型文件。FLUKA 的中间文件命名是靠输入文件名加序号来区分的，如果你把所有算例堆在同一个目录里，过两个月自己都分不清哪个是哪个了。

6.3 简单但重要的备份习惯

安装完成后，把整个~/opt/FLUKA目录做一次备份，也是非常推荐的。虽然正式建模时不需要频繁重装软件，但系统升级、硬盘更换、虚拟机迁移这些场景下，有备份就能直接恢复，不需要重新经历一次下载和申请流程。

tar -czf fluka-backup.tar.gz ~/opt/FLUKA

这一条看起来很简单，但真的能省很多事。

6.4 学会查看官方文档

FLUKA 安装包自带doc目录，里面有大量 PDF 手册，包括输入卡片说明、安装说明和示例解释。很多时候你遇到的问题早就有官方说明，只是很多人习惯直接搜索网上的零散答案，反而忽略了最权威的来源。遇到报错时，先翻一下$FLUPRO/doc目录下的对应手册，往往比在论坛里大海捞针高效得多。

回到我的经验上来，FLUKA 在 Ubuntu 下的安装整体并不算难，真正的分水岭在于你是否理解环境变量和启动脚本之间的配合关系。只要把FLUPRO这个关键路径配置准确，再确认 tcsh 和 gfortran 这类基础依赖都在，10 分钟内就能让程序跑起来。装完以后别急着丢开，拿官方示例完整跑一次，看看输出文件的结束标志，这才是真正有效的验收。以后你换电脑、换系统、帮同事配置环境时，回头再看这一步，会感谢自己当初没有跳过验证环节。