balenalib/jetson-xavier-nx-devkit-seeed-2mic-hat Docker 镜像 - 轩辕镜像

balenalib/jetson-xavier-nx-devkit-seeed-2mic-hat-debian 镜像文档

镜像概述和主要用途

该镜像属于balena.io IoT设备基础镜像系列，专为物联网设备设计。它针对balena.io和balenaOS进行了优化，同时也可在任何运行于适当架构的Docker环境中使用。

!balenalogo

核心功能和特性

balenalib基础镜像具备以下显著特性：

• 便捷的包安装脚本：提供install_packages工具，可抽象底层包管理器的具体实现，以最小依赖数量安装指定包（忽略可选依赖），自动清理包管理器元数据，并在安装失败时进行重试。

• 动态设备支持：每个balenalib基础镜像均默认定义ENTRYPOINT ["/usr/bin/entry.sh"]，该入口脚本会检查UDEV环境变量是否设为true（通过ENV UDEV=1配置）。若启用，将启动udevd守护进程，使容器/dev目录中自动出现相关设备节点。

更多详情，请查看特性概述文档。

镜像变体variants

balenalib镜像提供多种版本，适用于不同使用场景：

:<version> 或 :<version>-run

默认镜像版本。run变体为精简版本，仅包含运行时必需组件，体积小巧。

:<version>-build

构建版本包含大量源码构建所需工具，可减少Dockerfile中手动安装的包数量，从而降低系统中所有镜像的总体积。

如何在Balena中使用此镜像

入门指南可帮助您快速上手使用此基础镜像与balena平台，同时提供示例项目展示balena的应用场景。

支持的版本及对应Dockerfile链接

bullseye (latest)、bookworm、buster、sid

有关镜像及其历史的更多信息，可查看balena-io-library/official-images GitHub仓库中的相关清单文件（jetson-xavier-nx-devkit-seeed-2mic-hat-debian）。

详细使用方法和配置说明

在应用项目中创建Dockerfile

dockerfile
FROM balenalib/jetson-xavier-nx-devkit-seeed-2mic-hat-debian:latest
# 在此处添加您的应用代码

构建和运行镜像

console
$ docker build -t my-app .
$ docker run -it --rm --name my-running-app my-app

动态设备支持配置

如需启用动态设备检测，需在Dockerfile中添加环境变量：

dockerfile
ENV UDEV=1

这将使容器启动时自动启动udevd守护进程，支持外部设备动态接入。

用户反馈

问题反馈

如遇镜像相关问题或疑问，请通过GitHub issue联系我们。

贡献指南

欢迎贡献新功能、修复或更新（无论规模大小）。我们鼓励在提交代码前通过GitHub issue讨论您的计划，以便获取反馈和避免重复工作。

相关文档

• 基础镜像完整文档
• balenalib基础镜像新特性博客