在Truenas Scale Dragonfish-24.04.2上安装Nvidia驱动545.23.08的完整指南

本文将详细介绍在Truenas Scale Dragonfish-24.04.2系统中安装Nvidia驱动545.23.08版本的全过程，特别针对Steam-Headless/docker-steam-headless项目的使用场景。

环境准备与基础配置

首先需要确保Truenas Scale系统版本为Dragonfish-24.04.2，并已正确配置好基础环境。建议创建一个专用的数据集用于存放相关文件和容器配置。

容器启动脚本配置

关键的一步是正确配置容器启动脚本，确保Nvidia GPU能够正确透传给容器。推荐使用以下启动命令：

nvidia-persistenced; /mnt/{your_data_set}/jailmaker/jlmkr.py startup

这个命令首先启动Nvidia持久化服务，然后执行容器启动脚本。注意将{your_data_set}替换为你实际使用的数据集路径。

驱动获取与处理

Truenas Scale Dragonfish-24.04.2系统自带了Nvidia 545.23.08版本驱动，但这个版本在Nvidia官网上并不提供直接下载。我们需要通过其他途径获取：

1. 从GitHub下载正确的驱动版本
2. 将下载的驱动文件重命名为NVIDIA_545.23.08.run
3. 将文件放置在/home/default/Downloads目录下

驱动安装问题排查

在安装过程中可能会遇到脚本异常退出的问题，主要原因是60-configure_gpu_driver.sh脚本在/tmp目录创建了空的NVIDIA.run文件。这会导致容器以退出代码0异常终止，给调试带来困难。

解决方法是通过以下步骤进行诊断：

1. 暂时不传递Nvidia驱动，使用集成显卡启动容器
2. 手动运行60-configure_gpu_driver.sh脚本
3. 检查/tmp目录下的文件内容

最佳实践建议

1. 使用Dockage工具管理docker compose文件，可以简化容器管理
2. 确保驱动版本与系统完全匹配，避免兼容性问题
3. 在安装前备份重要数据，防止意外情况发生
4. 监控系统日志，及时发现并解决潜在问题

通过以上步骤，可以成功在Truenas Scale Dragonfish-24.04.2系统上安装Nvidia 545.23.08驱动，为Steam-Headless容器提供GPU加速支持。