该镜像属于balena.io IoT设备基础镜像系列,针对balena.io平台和balenaOS进行了优化,同时也可在任何支持相应架构的Docker环境中使用。它基于Debian系统,集成了Python运行环境,专为物联网设备开发设计,提供精简高效的运行时环境和便捷的开发工具。
!balenalogo
balenalib基础镜像具有以下显著特性:
便捷的包安装脚本:提供install_packages脚本,抽象底层包管理器细节,以最小依赖安装指定包(忽略可选依赖),自动清理包管理器元数据,并在安装失败时重试。
动态设备支持:默认ENTRYPOINT为/usr/bin/entry.sh,可通过设置ENV UDEV=1启用udevd守护进程,使容器内/dev目录能动态识别并显示外接设备节点。
更多特性详情请查看特性概述。
balenalib镜像提供多种变体,适用于不同使用场景:
:<version> 或 :<version>-run默认镜像变体,设计为精简的运行时环境,仅包含必要的运行时组件。
:<version>-build构建变体,包含大量源码构建所需工具,减少Dockerfile中手动安装的包数量,从而减小系统中所有镜像的总体积。
了解更多变体信息
适用于基于Python的物联网应用开发,尤其适合在balena.io平台和balenaOS上部署的嵌入式设备项目。可用于构建从简单脚本到复杂应用的各类Python程序,支持动态设备接入场景(如传感器、外设等)。
入门指南可帮助您开始使用该基础镜像,同时提供示例项目展示balena平台的应用可能性。
Python是一种解释型、交互式、面向对象的开源编程语言。它包含模块、异常处理、动态类型、高级动态数据类型和类等特性。Python语法简洁清晰,功能强大,可与众多系统调用、库及窗口系统交互,并支持C/C++扩展。Python具有良好的可移植性,可在多种Unix变体、Mac和Windows 2000及更高版本系统上运行。
***.org/wiki/Python_(programming_language)
!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/python/logo.png
https://github.com/balena-io-library/base-images/tree/master/balena-base-images/python/generic-armv7ahf/debian/
有关镜像及其历史的更多信息,请查看https://github.com/balena-io-library/official-images/blob/master/library/generic-armv7ahf-debian-python%EF%BC%88%E4%BD%8D%E4%BA%8Ehttps://github.com/balena-io-library/official-images%EF%BC%89%E3%80%82
dockerfileFROM balenalib/generic-armv7ahf-debian-python:latest WORKDIR /usr/src/app COPY requirements.txt ./ RUN pip install --no-cache-dir -r requirements.txt COPY . . CMD [ "python", "./your-daemon-or-script.py" ]
构建并运行Docker镜像:
console$ docker build -t my-python-app . $ docker run -it --rm --name my-running-app my-python-app
对于简单的单文件项目,可直接使用Python镜像运行脚本:
console$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/generic-armv7ahf-debian-python:latest python your-daemon-or-script.py
如遇到镜像相关问题或有疑问,请通过https://github.com/balena-io-library/base-images/issues%E8%81%94%E7%B3%BB%E6%88%91%E4%BB%AC%E3%80%82
欢迎贡献新功能、修复或更新(无论大小)。我们乐于接收拉取请求,并会尽快处理。
在开始编码前,建议通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E6%82%A8%E7%9A%84%E8%AE%A1%E5%88%92%EF%BC%8C%E5%B0%A4%E5%85%B6%E6%98%AF%E8%BE%83%E5%A4%8D%E6%9D%82%E7%9A%84%E8%B4%A1%E7%8C%AE%EF%BC%8C%E8%BF%99%E6%9C%89%E5%8A%A9%E4%BA%8E%E5%85%B6%E4%BB%96%E8%B4%A1%E7%8C%AE%E8%80%85%E6%8F%90%E4%BE%9B%E6%96%B9%E5%90%91%E6%8C%87%E5%AF%BC%E3%80%81%E8%AE%BE%E8%AE%A1%E5%8F%8D%E9%A6%88%EF%BC%8C%E5%B9%B6%E9%81%BF%E5%85%8D%E9%87%8D%E5%A4%8D%E5%B7%A5%E4%BD%9C%E3%80%82
该镜像文档存储在基础镜像文档中。您可以在其中找到所有基础镜像列表,包括node、python、go等专用镜像及更小体积的镜像。
有关balenalib基础镜像新特性的更多详情,请查看博客文章。

探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务