Jetson-Containers 项目系统配置指南
2025-07-09 06:38:48作者：邵娇湘
前言
本文旨在为使用jetson-containers项目的开发者提供完整的系统配置指南。该项目为NVIDIA Jetson系列开发板提供了容器化解决方案，能够帮助开发者快速部署AI应用。在开始使用前，需要完成一系列系统配置工作，本文将详细介绍每个步骤。
系统要求
首先需要确认您的Jetson设备满足以下JetPack版本要求：
- Jetson Nano/TX1/TX2：JetPack 4.6.1+ (L4T R32.7.1或更高)
- Jetson Xavier系列：JetPack 5.1+ (L4T R35.2.1或更高)
- Jetson Orin系列：JetPack 6.0 DP (L4T R36.2.0)或JetPack 6.2 DP (L4T R36.4.4)
重要提示：目前不支持在x86平台上构建容器，仅支持在Jetson设备上运行。
项目安装
- 克隆项目仓库并运行安装脚本：
git clone https://example.com/path/to/jetson-containers
bash jetson-containers/install.sh
安装过程中会要求输入sudo密码，脚本会自动完成以下工作：
- 安装必要的Python依赖
- 将
autotag等工具链接到/usr/local/bin目录 - 设置环境变量
提示：如果后续移动了项目目录位置，需要重新运行安装脚本。
Docker运行时配置
为了在构建容器时能够使用NVCC编译器和GPU加速，需要将Docker的默认运行时设置为nvidia。
- 编辑Docker配置文件
/etc/docker/daemon.json，添加以下内容：
{
"runtimes": {
"nvidia": {
"path": "nvidia-container-runtime",
"runtimeArgs": []
}
},
"default-runtime": "nvidia"
}
- 重启Docker服务使配置生效：
sudo systemctl restart docker
- 验证配置是否成功：
sudo docker info | grep 'Default Runtime'
应显示Default Runtime: nvidia。
Docker数据存储迁移
容器镜像和缓存会占用大量存储空间，建议将其迁移到大容量外部存储设备（推荐NVMe SSD）。
-
确保目标存储设备已格式化为ext4并设置自动挂载（在
/etc/fstab中配置） -
复制现有Docker数据：
sudo cp -r /var/lib/docker /mnt/docker
- 修改Docker配置文件，添加数据存储路径：
{
"runtimes": {
"nvidia": {
"path": "nvidia-container-runtime",
"runtimeArgs": []
}
},
"default-runtime": "nvidia",
"data-root": "/mnt/docker"
}
- 重启Docker服务并验证：
sudo systemctl restart docker
sudo docker info | grep 'Docker Root Dir'
交换空间配置
构建大型容器或运行大模型时，建议配置足够的交换空间。
- 禁用ZRAM并创建交换文件：
sudo systemctl disable nvzramconfig
sudo fallocate -l 16G /mnt/16GB.swap
sudo mkswap /mnt/16GB.swap
sudo swapon /mnt/16GB.swap
提示：如果有NVMe存储，优先将交换文件放在NVMe上。
- 添加到
/etc/fstab实现开机自动挂载：
/mnt/16GB.swap none swap sw 0 0
图形界面管理（可选）
为节省内存资源，可以选择临时或永久禁用Ubuntu桌面环境。
- 临时禁用/启用：
sudo init 3 # 禁用桌面
sudo init 5 # 重新启用
- 永久配置：
sudo systemctl set-default multi-user.target # 禁用桌面启动
sudo systemctl set-default graphical.target # 启用桌面启动
用户权限配置
为避免频繁输入sudo密码，建议将当前用户加入docker组：
sudo usermod -aG docker $USER
执行后需要注销并重新登录使配置生效。
电源模式设置
根据供电情况，可以调整Jetson设备的电源模式以获得最佳性能。
- 查看当前电源模式：
sudo nvpmodel -q
- 设置为最高性能模式（通常为模式0）：
sudo nvpmodel -m 0
不同Jetson设备支持的电源模式可能不同，建议参考官方文档选择最适合的模式。
结语
完成以上配置后，您的Jetson设备已经为运行和构建jetson-containers项目做好了准备。这些优化配置不仅能提升容器使用体验，还能充分利用硬件资源，为AI应用开发提供稳定的基础环境。
