balenalib/photon-xavier-nx-ubuntu

⚠️ 已弃用 (DEPRECATED)

此基础镜像已被弃用，将不再接收更新。请阅读https://blog.balena.io/deprecate-balenalib-images/%E8%8E%B7%E5%8F%96%E8%BF%81%E7%A7%BB%E6%8C%87%E5%8D%97%E5%92%8C%E5%BB%BA%E8%AE%AE%E7%9A%84%E6%9B%BF%E4%BB%A3%E6%96%B9%E6%A1%88%E3%80%82

镜像概述与主要用途

该镜像属于 https://balena.io/?ref=dockerhub IoT 设备基础镜像系列，专为物联网设备优化。虽然主要针对 https://balena.io/?ref=dockerhub 和 https://www.balena.io/os/?ref=dockerhub 环境设计，但也可在适配架构的任何 Docker 环境中使用。

核心功能与特性

install_packages 包安装脚本

提供便捷的 install_packages 脚本，抽象底层包管理器的实现细节，具备以下特性：

• 安装指定软件包时自动最小化依赖（忽略可选依赖）
• 清理包管理器元数据，减少镜像体积
• 安装失败时自动重试，提升可靠性

动态设备支持

每个 balenalib 基础镜像默认包含 ENTRYPOINT ["/usr/bin/entry.sh"]，支持动态插拔设备：

• 通过设置环境变量 ENV UDEV=1 启用 UDEV 功能
• 启用后，容器会启动 udevd 守护进程，动态生成的设备节点将自动出现在容器的 /dev 目录中

更多特性详情请参见 https://www.balena.io/docs/reference/base-images/base-images/#features-overview%E3%80%82

镜像变体

balenalib 镜像提供多种变体，适用于不同场景：

:<version> 或 :<version>-run

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

:<version>-build

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

https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub

使用场景与适用范围

• 适用设备：Photon Xavier NX 平台物联网设备
• 运行时场景：需部署轻量级应用，依赖最小化运行环境（使用 run 变体）
• 构建场景：需从源码构建应用，依赖编译工具链（使用 build 变体）
• 兼容环境：balenaOS、balena.io 平台，或其他支持 Docker 的 Linux 环境

使用方法与配置说明

基础使用示例

创建 Dockerfile

dockerfile
FROM docker.xuanyuan.run/balenalib/photon-xavier-nx-ubuntu:latest
# 在此处添加你的应用代码和配置

构建并运行镜像

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

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

启用 UDEV 设备支持

如需在容器中使用动态插拔设备，需设置 UDEV=1 环境变量：

dockerfile
FROM docker.xuanyuan.run/balenalib/photon-xavier-nx-ubuntu:latest
ENV UDEV=1
# 应用配置...

支持的版本及 Dockerfile 链接

• noble (latest)、jammy
  https://github.com/balena-io-library/base-images/tree/master/balena-base-images/device-base/photon-xavier-nx/ubuntu/

更多镜像历史信息，请参见 https://github.com/balena-io-library/official-images%E4%B8%AD%E7%9A%84https://github.com/balena-io-library/official-images/blob/master/library/photon-xavier-nx-ubuntu%E3%80%82

在 Balena 中使用此镜像

• https://www.balena.io/docs/learn/getting-started/photon-xavier-nx/nodejs/?ref=dockerhub：帮助你快速上手在 Balena 中使用此基础镜像
• https://www.balena.io/docs/learn/getting-started/photon-xavier-nx/nodejs/#example-projects?ref=dockerhub：提供实际应用案例，展示基于 Balena 的物联网场景实现

用户反馈

问题反馈

如遇镜像相关问题或疑问，请通过 https://github.com/balena-io-library/base-images/issues 联系我们。

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。我们鼓励提交 Pull Request，并会尽快处理。

开发前建议通过 https://github.com/balena-io-library/base-images/issues 讨论计划，尤其是较大的改动，以便其他贡献者提供方向建议、设计反馈或避免重复工作。

文档资源

镜像详细文档请参见 https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub。更多 balenalib 基础镜像新特性说明，请参见 https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub。