balenalib/jetson-xavier Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

balenalib/jetson-xavier-debian 镜像文档

镜像概述和主要用途

该镜像为balena.io IoT设备基础镜像系列的一部分，专为Jetson Xavier设备优化，主要用于balena.io平台和balenaOS系统，同时也兼容其他适当架构的Docker环境。它提供了精简的运行时环境和完整的构建工具支持，满足IoT应用从开发构建到生产部署的全流程需求。

!balenalogo

核心功能和特性

1. 简化的包管理

• 提供install_packages脚本，抽象底层包管理器差异，自动以最小依赖方式安装指定包（忽略可选依赖）
• 自动清理包管理器元数据，减少镜像体积
• 支持安装失败时自动重试

2. 动态设备支持

• 默认入口点为ENTRYPOINT ["/usr/bin/entry.sh"]
• 通过设置ENV UDEV=1环境变量可启用udevd守护进程，使容器内/dev目录能动态识别并显示外部插入的设备节点

更多特性详情请参见特性概述。

镜像变体

balenalib镜像提供多种变体以适应不同使用场景：

:<version> 或 :<version>-run

默认镜像，运行时精简版，仅包含应用运行所需的核心组件，体积小巧。

:<version>-build

构建专用版，包含大量源代码构建所需工具，减少Dockerfile中手动安装依赖的需求，从而降低系统整体镜像体积。

了解更多变体信息

使用场景和适用范围

• Jetson Xavier设备上的IoT应用开发与部署
• 需要与balena.io平台集成的边缘计算项目
• 从源代码构建应用的开发流程（使用-build变体）
• 生产环境中运行轻量级应用（使用-run变体）

详细使用方法和配置说明

与Balena平台配合使用

参考入门指南快速上手，也可查看示例项目了解实际应用场景。

支持的版本及Dockerfile链接

• bullseye (latest)
• bookworm
• buster
• sid

查看Dockerfile源码

创建应用Dockerfile

在项目中创建如下Dockerfile：

dockerfile
FROM balenalib/jetson-xavier-debian:latest
# 在此添加你的应用代码和配置

构建和运行镜像

console
# 构建镜像
$ docker build -t my-app .

# 运行容器（交互式，退出时自动删除）
$ docker run -it --rm --name my-running-app my-app

配置参数说明

• UDEV环境变量：设置ENV UDEV=1可启用udevd守护进程，使容器能够识别动态插入的外部设备，适用于需要访问USB设备、传感器等外设的场景。

用户反馈

问题反馈

如遇问题或疑问，请通过GitHub Issue联系我们。

贡献代码

欢迎贡献新功能、修复或更新（无论大小）。建议重大变更前先通过GitHub Issue讨论，以确保方向一致。

相关文档

• 基础镜像完整文档
• balenalib镜像新特性说明