balenalib/raspberrypi4-64-debian-node 镜像文档

镜像概述和主要用途

本镜像属于balena.io IoT设备基础镜像系列，专为物联网场景优化，主要用于balena.io平台和balenaOS操作系统，同时也兼容其他Docker环境。它基于Debian系统，集成Node.js运行环境，针对树莓派4等64位架构设备进行了适配，为IoT设备上的Node.js应用开发与部署提供稳定、高效的基础环境。

核心功能和特性

便捷的包管理工具

• 提供install_packages专用包安装脚本，抽象底层包管理器细节：
  • 自动选择依赖最少的包版本（忽略可选依赖）
  • 安装后自动清理包管理器元数据，减小镜像体积
  • 支持安装失败时自动重试，提升可靠性

动态设备管理支持

• 默认ENTRYPOINT为/usr/bin/entry.sh，实现设备动态插拔管理：
  • 通过设置ENV UDEV=1启用udev支持
  • 自动启动udevd守护进程，容器内/dev目录可动态识别设备节点

镜像变体

:<version> 或 :<version>-run

默认镜像变体，设计为精简版，仅包含运行时必要组件，适合生产环境部署，追求最小镜像体积。

:<version>-build

构建专用变体，包含大量源代码构建工具，减少Dockerfile中手动安装依赖的需求，降低系统总体镜像大小，适合开发构建阶段。

使用场景和适用范围

• IoT设备上的Node.js应用开发与部署
• 树莓派4（64位）等嵌入式设备的容器化应用
• 需要动态管理外设的物联网项目
• 基于balena.io平台的设备应用开发
• 需分离构建/运行环境的Node.js项目

Node.js简介

Node.js是一个用于可扩展服务器端和网络应用的软件平台。应用使用JavaScript编写，可在Mac OS X、Windows和Linux的Node.js运行时中无缝运行。其核心特点包括：

• 非阻塞I/O和异步事件驱动模型，最大化吞吐量和效率
• 单线程执行模型，同时利用多线程处理文件和网络事件
• 内置Google V8 JavaScript引擎，基础模块多为JavaScript编写
• 内置异步I/O库，支持文件、套接字和HTTP通信，可直接作为Web服务器运行

来源：***.org/wiki/Node.js

支持版本及Dockerfile链接

• 18.9.1 (latest)
• 16.17.1
• 14.20.1

更多镜像信息可查看***镜像清单文件。

详细使用方法和配置说明

创建Dockerfile

dockerfile
# 指定Node.js基础镜像版本
FROM balenalib/raspberrypi4-64-debian-node:latest
# 暴露应用端口（替换为实际端口）
EXPOSE 8888

构建并运行：

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

Docker Compose配置

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

启动服务：

console
$ docker-compose up -d

运行单个Node.js脚本

无需编写Dockerfile，直接运行脚本：

console
$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/app -w /usr/src/app balenalib/raspberrypi4-64-debian-node:latest node your-daemon-or-script.js

与Balena平台使用

• 快速入门指南
• 示例项目

用户反馈

Issues

通过GitHub issue提交问题。

贡献

欢迎提交PR，建议先通过GitHub issue讨论大型贡献计划。

文档资源

• 基础镜像文档
• 新功能博客