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 -a1.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解释一下这些包的作用tcshFLUKA 的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。为了后续配置环境变量方便我习惯于把它重命名成简洁的FLUKAmv fluka-4-3.0 FLUKA2.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如果你希望以后每次打开终端都自动加载可以把这行也写入.bashrcecho 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 matplotlibFlair 本身可以从 FLUKA 官方下载页面拿到对应的发行包一般是一个压缩包解压后是一个放在哪都能运行的目录。官网经常提供预打包版本优先选择预打包版本省去自己编译依赖的麻烦。解压后建议把 Flair 目录也放进 PATHexport 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/test014.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 多线程加速参数说明跑测试算例时默认单线程就够了但如果后续要跑实际物理模型建议利用多核 CPUrfluka -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 常见问题速查表症状可能原因处理方式command not found: rflukaPATH 未配置或未 source检查.bashrc重新source ~/.bashrcbad interpreter缺少 tcshsudo apt install -y tcsh运行中断日志中有问号提示输入卡片格式问题或数据路径缺失用官方示例对比确认所有文件路径有效Flair 打不开显示服务器或 Python 依赖问题WSLg/X Server 配置或重新安装 Python 依赖libgfortran 相关错误缺少 gfortran 运行时sudo apt install -y gfortran找不到fluka-init版本不同脚本名可能不同查看解压目录内文档确认脚本位置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 分钟内就能让程序跑起来。装完以后别急着丢开拿官方示例完整跑一次看看输出文件的结束标志这才是真正有效的验收。以后你换电脑、换系统、帮同事配置环境时回头再看这一步会感谢自己当初没有跳过验证环节。