balenalib/qemux86-ubuntu

balenalib/qemux86-ubuntu 镜像文档

镜像概述

该镜像属于balena.io的IoT设备基础镜像系列，专为物联网设备优化。主要用于balena.io平台和balenaOS系统，但也可在任何适配架构的Docker环境中使用。

核心功能与特性

1. 简化的包管理工具

• install_packages 脚本：抽象底层包管理器差异，自动以最小依赖安装指定包（忽略可选依赖），安装后清理包管理器元数据，并在安装失败时自动重试，简化依赖管理流程。

2. 动态设备支持

• 默认ENTRYPOINT为["/usr/bin/entry.sh"]，通过UDEV环境变量控制设备管理：
  • 设置ENV UDEV=1时，自动启动udevd守护进程，使容器内/dev目录能动态显示外部接入的设备节点。

更多特性详见https://www.balena.io/docs/reference/base-images/base-images/#features-overview。

镜像变体

:<version> 或 :<version>-run

默认镜像变体，设计为精简的运行时环境，仅包含必要的运行时依赖，适合直接部署应用。

:<version>-build

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

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

在Balena中使用

• https://www.balena.io/docs/learn/getting-started/qemux86/nodejs/?ref=dockerhub：帮助首次使用该基础镜像的用户上手。
• https://www.balena.io/docs/learn/getting-started/qemux86/nodejs/#example-projects?ref=dockerhub：提供实际应用案例，展示基于balena的项目实现方式。

使用方法

创建应用的Dockerfile

dockerfile
FROM docker.xuanyuan.run/balenalib/qemux86-ubuntu:latest
# 在此处添加应用代码

构建并运行镜像

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

支持的版本及Dockerfile链接

• jammy (latest)、focal、impish、xenial、bionic、kinetic
  https://github.com/balena-io-library/base-images/tree/master/balena-base-images/device-base/qemux86/ubuntu/

镜像历史及更多信息，参见https://github.com/balena-io-library/official-images/blob/master/library/qemux86-ubuntu。

用户反馈

问题反馈

如遇问题或疑问，请通过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，新特性说明见https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub。