balenalib/qemux86

balenalib 物联网设备基础镜像

镜像概述和主要用途

本镜像属于 balena.io 物联网设备基础镜像系列，专为物联网设备设计并优化。虽然其主要针对 balena.io 和 balenaOS 环境，但也可在任何运行于相应架构的 Docker 环境中使用。

!balenalogo

核心功能和特性

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

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

• 动态设备支持：每个 balenalib 基础镜像均默认配置 ENTRYPOINT ["/usr/bin/entry.sh"]。通过设置 ENV UDEV=1 启用 UDEV 标志后，该入口脚本会启动 udevd 守护进程，使容器内 /dev 目录中动态出现相关设备节点。

有关更多详细信息，请查看文档中的 特性概述。

镜像变体 variants

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

:<version> 或 :<version>-run

这是默认镜像变体。run 变体设计为精简版本，仅包含运行时必需组件。

:<version>-build

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

如何在 Balena 中使用本镜像

入门指南 可帮助您开始使用此基础镜像，同时提供了一些 示例项目，展示基于 balena 可实现的功能。

支持的版本及对应 Dockerfile 链接

https://github.com/balena-io-library/base-images/tree/master/balena-base-images/device-base/qemux86/debian/

有关本镜像及其历史的更多信息，请查看 https://github.com/balena-io-library/official-images 中的相关清单文件（qemux86-debian）：https://github.com/balena-io-library/official-images/blob/master/library/qemux86-debian%E3%80%82

使用方法

在应用项目中创建 Dockerfile

dockerfile
FROM balenalib/qemux86-debian:latest
# 在此处替换为您的应用代码

构建并运行 Docker 镜像：

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

用户反馈

问题反馈

如在使用本镜像时遇到问题或有疑问，请通过 https://github.com/balena-io-library/base-images/issues 与我们联系。

贡献指南

欢迎贡献新功能、修复或更新（无论大小）。我们始终期待收到拉取请求，并会尽快处理。

在开始编码前，建议通过 https://github.com/balena-io-library/base-images/issues 讨论您的计划，尤其是对于较复杂的贡献。这能让其他贡献者为您提供方向指导、设计反馈，并确认是否有其他人正在开发相同功能。

文档资源

本镜像的文档存储在 基础镜像文档 中。您可在此查看所有基础镜像列表，包括针对 Node.js、Python、Go 等的专用镜像及更小体积的镜像。

有关 balenalib 基础镜像新功能的更多详情，可参考此 博客文章。