balenalib/raspberrypi4-debian-node镜像文档

镜像概述和主要用途

该镜像为balena.io IoT设备基础镜像系列成员，专为树莓派4 64位平台设计，主要用于Node.js应用程序的开发、构建和部署适配balenaOS及其他Docker环境，提供精简高效的运行时和构建工具支持。

!balenalogo

balenalib基础镜像核心特性：

• install_packages脚本: 简化包管理操作自动处理底层包管理器差异安装依赖最小化清理元数据支持安装失败重试。
• 动态设备支持: 默认ENTRYPOINT为ENTRYPOINT ["/usr/bin/entry.sh"]，设置ENV UDEV=1时自动启动udevd守护进程使容器/dev目录动态识别外部设备节点。

镜像变体variants

:<version> 或 :<version>-run

默认镜像变体，精简设计仅包含运行时必需组件，适合直接部署生产环境应用。

:<version>-build

包含完整构建工具链适合源码编译场景，减少手动安装依赖步骤降低整体镜像体积。

与Balena平台配合使用

入门指南提供基础镜像使用教程，示例项目库展示balena生态应用场景。

关于Node.js

Node.js是以JavaScript为开发语言实现的服务器端运行环境，采用非阻塞I/O模型和事件驱动架构，擅长处理高并发网络请求，广泛应用于实时通信API服务等场景内置V8引擎及文件网络I/O库无需额外Web服务器软件即可运行HTTP服务。

***.org/wikiNode.js!logo.

支持版本及Dockerfile链接

[18.7.0 (latest)]16.17.0

镜像详细信息及历史版本参见***镜像清单文件。

使用方法指南

创建应用Dockerfile

dockerfile
# 指定Node.js基础镜像版本FROM balenalib/raspberrypi4-64-debian-nodeEXPOSE # 暴露应用端口号

构建运行命令：

bashdocker

Docker Compose配置示例yamlversion: "2"services node:

image: "balenalib//debian-node:latest user working_dir:/home/node/app environment:
  - NODE_ENV=production volumes:
  - ./:/home/node/app expose:
  - "8081"
command: "npm start"

bashdocker

###单个脚本运行docker run -it --rm name my-running-script -v "$PWD":/usr/src/app -w /usr/src/app balenalib/raspberrypi4-64-debian-node node your-script.js/bin/sh

用户反馈

问题反馈

通过GitHub Issues提交bug报告或功能建议。

贡献指南

欢迎提交PR参与镜像改进，重大变更建议事先通过Issue讨论。

参考文档

• [基础镜像完整文档][docs][迁移指南博客][migration-docs][balena.io官网][balena][balenaOS文档][balena-os]

[docs]: [][migration-docs]: [][balena]: [][balena-os]: []