balenalib/npe-x500-m3

balenalib/npe-x500-m3-debian 镜像文档

镜像概述和主要用途

本镜像属于 balena.io 物联网（IoT）设备基础镜像系列，专为 IoT 设备优化设计。该镜像主要面向 balena.io 平台和 balenaOS 操作系统，但也可在其他支持相应架构的 Docker 环境中使用。

核心功能和特性

1. 简化的包管理工具 install_packages

• 功能：抽象底层包管理器的具体实现，提供统一的包安装接口。
• 特性：
  • 安装指定软件包时自动选择依赖项最少的版本（忽略可选依赖）；
  • 安装完成后自动清理包管理器元数据，减少镜像体积；
  • 支持安装失败时自动重试。

2. 动态设备接入支持（UDEV）

• 默认入口点：镜像默认 ENTRYPOINT 为 ENTRYPOINT ["/usr/bin/entry.sh"]；
• UDEV 配置：通过设置环境变量 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

• 定位：默认镜像，运行时精简版。
• 特性：仅包含运行时必需组件，体积小巧，适合生产环境部署。

:<version>-build

• 定位：构建环境版。
• 特性：包含大量源码构建工具，减少 Dockerfile 中手动安装的依赖包数量，从而降低系统中所有镜像的总体积。

更多变体差异参见 https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub%E3%80%82

详细使用方法和配置说明

在 Balena 平台中使用

• 入门指南：参考 https://www.balena.io/docs/learn/getting-started/npe-x500-m3/nodejs/?ref=dockerhub 快速上手；
• 示例项目：通过 https://www.balena.io/docs/learn/getting-started/npe-x500-m3/nodejs/#example-projects?ref=dockerhub 了解实际应用场景。

通用 Docker 环境使用

创建 Dockerfile

在应用项目中创建 Dockerfile：

dockerfile
FROM docker.xuanyuan.run/balenalib/npe-x500-m3-debian:latest
# 在此添加应用代码和配置

构建和运行镜像

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

# 运行容器（基础示例）
docker run -it --rm --name my-running-app docker.xuanyuan.run/my-app

启用 UDEV 支持

若需动态设备接入，在 Dockerfile 中设置 UDEV 环境变量：

dockerfile
FROM docker.xuanyuan.run/balenalib/npe-x500-m3-debian:latest
ENV UDEV=1
# 应用代码和配置

支持版本及 Dockerfile 链接

镜像历史及更多信息参见 https://github.com/balena-io-library/official-images/blob/master/library/npe-x500-m3-debian%EF%BC%88balena-io-library/official-images 仓库）。

用户反馈

问题反馈

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

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。建议在提交代码前，通过 https://github.com/balena-io-library/base-images/issues 讨论计划，尤其是大型贡献，以便其他贡献者提供方向指导和设计反馈。

镜像完整文档参见 https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub%EF%BC%8C%E6%96%B0%E7%89%B9%E6%80%A7%E8%AF%A6%E6%83%85%E5%8F%82%E8%A7%81 https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub%E3%80%82