balenalib/nanopc-t4

balenalib/nanopc-t4-debian 镜像文档

镜像概述和主要用途

balenalib/nanopc-t4-debian 镜像属于 balena.io 的 IoT 设备基础镜像系列，专为物联网设备优化。该镜像特别适用于 balena.io 平台和 balenaOS 系统，同时也可在任何支持相应架构的 Docker 环境中运行。

!balenalogo

核心功能和特性

balenalib 基础镜像包含以下主要特性：

• 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

build 变体是包含更多工具的重量级镜像，内置大量源码构建所需的工具。使用该变体可减少 Dockerfile 中手动安装的包数量，从而减小系统中所有镜像的总体积。

使用场景和适用范围

• IoT 设备应用开发：作为基础镜像，适用于 nanopc-t4 等物联网设备的应用开发和部署。
• 轻量级运行时环境：run 变体适合需要精简运行时的生产环境。
• 源码构建场景：build 变体适合需要从源码构建应用的开发和构建阶段。

使用方法和配置说明

与 Balena 平台配合使用

如需在 balena 平台上使用该基础镜像，可参考 https://www.balena.io/docs/learn/getting-started/nanopc-t4/nodejs/?ref=dockerhub%EF%BC%8C%E5%90%8C%E6%97%B6%E5%8F%AF%E6%9F%A5%E7%9C%8B https://www.balena.io/docs/learn/getting-started/nanopc-t4/nodejs/#example-projects?ref=dockerhub 了解实际应用场景。

支持的版本

当前支持的版本包括：
https://github.com/balena-io-library/base-images/tree/master/balena-base-images/device-base/nanopc-t4/debian/

有关镜像及其历史的更多信息，可查看 https://github.com/balena-io-library/official-images 中的 https://github.com/balena-io-library/official-images/blob/master/library/nanopc-t4-debian%E3%80%82

基本使用步骤

1. 在应用项目中创建 Dockerfile

dockerfile
FROM docker.xuanyuan.run/balenalib/nanopc-t4-debian:latest
# 在此处添加你的应用代码和配置

2. 构建并运行 Docker 镜像

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

3. 启用 UDEV 支持（可选）

如需在容器中支持动态设备，可在 Dockerfile 中设置 UDEV 环境变量：

dockerfile
FROM docker.xuanyuan.run/balenalib/nanopc-t4-debian:latest
ENV UDEV=1
# 应用代码...

用户反馈

Issues

如在使用该镜像时遇到问题或有疑问，请通过 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 中。你可以在其中找到所有 balena 基础镜像的列表，包括针对 Node.js、Python、Go 等的专用镜像以及更小体积的镜像等。

有关 balenalib 基础镜像新功能的更多详情，可参考 https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub%E3%80%82