1. 项目概述
最近在NVIDIA Jetson AGX Orin开发板上部署一个计算机视觉项目时，遇到了一个棘手的问题：我们需要使用JetPack 6.1版本，但NVIDIA官方软件源已经更新到了6.2.1版本。这导致通过常规apt安装方式会默认获取最新版本，而我们的项目代码已经针对6.1版本进行了优化和测试，升级到6.2.1可能会引入兼容性问题。
Jetson系列开发板（包括Jetson AGX Orin、Jetson Xavier NX等）是NVIDIA推出的边缘计算平台，广泛应用于机器人、自动驾驶、工业检测等领域。JetPack是NVIDIA为这些设备提供的软件开发套件，包含了CUDA、cuDNN、TensorRT等关键组件。不同版本的JetPack在性能、API和兼容性上可能存在差异，因此在实际项目中，我们经常需要锁定特定版本。
2. 问题分析
2.1 默认安装行为的问题
当我使用SDK Manager刷写了Ubuntu 22.04 + JetPack 6.1的基础镜像后，按照常规流程执行以下命令：
bash复制sudo apt update
sudo apt install nvidia-jetpack
系统会自动安装最新可用的JetPack版本（当前是6.2.1），而不是我们需要的6.1版本。这是因为NVIDIA的软件仓库采用了向前兼容的策略，新版本发布后，旧版本仍然保留在仓库中，但apt默认会优先选择最新版本。
2.2 直接指定版本的尝试
接下来，我尝试直接指定6.1版本的安装：
bash复制sudo apt install nvidia-jetpack=6.1+b123 \
nvidia-jetpack-runtime=6.1+b123 \
nvidia-jetpack-dev=6.1+b123
然而，这导致了依赖冲突错误。系统提示多个依赖包（如nvidia-vpi-dev、nvidia-cuda-dev等）需要6.1版本，但仓库中可用的却是6.2.1版本。这是因为虽然主包指定了6.1版本，但依赖关系解析时apt仍然倾向于选择最新版本。
3. 解决方案
3.1 创建APT优先级配置文件
解决这个问题的关键在于告诉APT系统：对于所有NVIDIA相关的软件包，6.1版本的优先级应该高于其他版本。我们可以通过创建优先级配置文件来实现这一点。
在终端执行以下命令创建配置文件：
bash复制sudo nano /etc/apt/preferences.d/jetpack-61
文件内容如下：
code复制Package: nvidia-jetpack*
Pin: version 6.1*
Pin-Priority: 1001
Package: nvidia-cuda*
Pin: version 6.1*
Pin-Priority: 1001
Package: nvidia-tensorrt*
Pin: version 6.1*
Pin-Priority: 1001
Package: nvidia-vpi*
Pin: version 6.1*
Pin-Priority: 1001
Package: nvidia-cudnn*
Pin: version 6.1*
Pin-Priority: 1001
Package: nvidia-opencv*
Pin: version 6.1*
Pin-Priority: 1001
Package: nvidia-nsight*
Pin: version 6.1*
Pin-Priority: 1001
Package: nvidia-container*
Pin: version 6.1*
Pin-Priority: 1001
Package: nvidia-cupva*
Pin: version 6.1*
Pin-Priority: 1001
这个配置文件中：
Package指定了包名模式（使用*通配符）Pin指定了版本模式（6.1*匹配所有6.1开头的版本）Pin-Priority设置为1001，这是一个很高的优先级，确保6.1版本会被优先选择
3.2 清理缓存并更新
创建配置文件后，需要清理之前的缓存并更新软件包列表：
bash复制sudo apt clean
sudo apt update
sudo reboot
重启后，系统会应用新的优先级设置。
3.3 安装指定版本
现在可以正常安装JetPack 6.1了：
bash复制sudo apt install nvidia-jetpack
系统会自动选择6.1版本及其对应的依赖包。
3.4 防止自动升级
为了防止后续的系统升级将JetPack 6.1自动升级到6.2.1，我们需要标记这些包为"hold"状态：
bash复制sudo apt-mark hold nvidia-jetpack
4. 验证安装
安装完成后，可以通过以下命令验证JetPack版本：
bash复制sudo apt install jetson-release
jetson_release -v
输出应该显示JetPack 6.1的相关信息，包括CUDA、cuDNN、TensorRT等组件的版本号。
5. 技术原理深入
5.1 APT的版本选择机制
APT（Advanced Packaging Tool）是Debian/Ubuntu系统的包管理工具，其版本选择遵循以下规则：
- 首先检查是否有固定版本（通过=指定）
- 然后考虑包的优先级（Pin-Priority）
- 最后选择最高可用版本
默认情况下，APT会给所有包分配优先级500，而我们的配置文件将6.1版本的优先级设置为1001，远高于默认值，因此会被优先选择。
5.2 依赖关系解析
NVIDIA的JetPack是一个元包（metapackage），它本身不包含实际功能，而是通过依赖关系引入其他组件（CUDA、TensorRT等）。当安装JetPack时，APT需要解析这些依赖关系，确保所有组件版本兼容。
在我们的解决方案中，通过为所有相关包设置高优先级，确保依赖解析时也选择6.1版本的组件。
6. 注意事项与常见问题
6.1 文件权限问题
创建/etc/apt/preferences.d/下的配置文件时，必须使用sudo权限。文件权限应为644（-rw-r--r--），否则APT可能会忽略它。
6.2 配置文件命名
配置文件的扩展名不重要，但建议使用有意义的名称（如jetpack-61）。不要使用.preferences扩展名，因为某些APT版本可能会忽略它。
6.3 多版本共存问题
这种方法只适用于选择特定版本，不能实现真正的多版本共存。如果需要同时使用多个JetPack版本，建议考虑使用Docker容器。
6.4 网络问题
在执行apt update时，可能会因为网络问题导致更新失败。可以尝试更换软件源镜像：
bash复制sudo sed -i 's/ports.ubuntu.com/mirrors.ustc.edu.cn/g' /etc/apt/sources.list
sudo apt update
6.5 依赖冲突解决
如果仍然遇到依赖问题，可以尝试：
bash复制sudo apt -f install
sudo dpkg --configure -a
7. 实际应用建议
7.1 项目开发环境
对于团队开发项目，建议将/etc/apt/preferences.d/jetpack-61文件纳入版本控制，确保所有开发人员使用相同的JetPack版本。
7.2 生产环境部署
在生产环境中，除了锁定JetPack版本外，还应该：
- 定期检查安全更新
- 创建系统快照
- 测试新版本兼容性
7.3 性能优化
安装完成后，建议执行以下优化：
bash复制sudo nvpmodel -m 0 # 设置为最大性能模式
sudo jetson_clocks # 启用持续最大时钟频率
8. 扩展知识
8.1 JetPack组件版本对应关系
不同JetPack版本包含的组件版本不同，以下是JetPack 6.1的典型组件版本：
| 组件名称 | 版本号 |
|---|---|
| CUDA | 11.4 |
| cuDNN | 8.2.4 |
| TensorRT | 8.0.1 |
| VPI | 2.1.5 |
| OpenCV | 4.5.4 |
8.2 其他版本锁定方法
除了APT优先级，还可以考虑：
- 使用Docker容器固定环境
- 下载.deb包手动安装
- 使用conda环境管理
8.3 版本升级策略
当需要升级JetPack版本时，应该：
- 备份当前配置
- 移除优先级配置文件
- 测试新版本兼容性
- 逐步升级开发、测试、生产环境
9. 个人经验分享
在实际项目中使用Jetson板卡多年，我总结了以下几点经验：
-
版本一致性至关重要：团队中所有开发板应该使用相同的JetPack版本，避免"在我机器上能运行"的问题。
-
文档记录：详细记录安装的软件版本和配置，便于问题排查和环境重建。
-
性能测试：新版本不一定带来性能提升，有时甚至会有回退，必须进行基准测试。
-
备份策略：在重大版本变更前，创建完整的系统镜像备份。
-
社区资源：遇到问题时，NVIDIA开发者论坛和JetsonHacks等社区是宝贵的资源。
最后提醒一点：JetPack的安装和配置可能会占用大量时间，建议在项目计划中预留足够的环境准备时间。对于关键项目，考虑准备备用开发板以防硬件故障。