balenalib/orange-pi-zero-debian-node 镜像文档

镜像概述和主要用途

该镜像属于balena.io IoT设备基础镜像系列，专为Orange Pi Zero开发板设计，基于Debian系统，集成Node.js运行环境。镜像针对balena.io平台和balenaOS进行了优化，可在支持相应架构的任何Docker环境中使用，适用于构建和运行IoT设备上的Node.js应用。

!balena logo

核心功能和特性

便捷的包管理工具

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

动态设备支持

• 默认ENTRYPOINT为/usr/bin/entry.sh，通过设置ENV UDEV=1可启用udevd守护进程，使动态插入的设备节点在容器/dev目录中自动识别和显示。

更多特性详情请参见特性概述。

镜像变体

:<version> 或 :<version>-run（默认变体）

• 精简的运行时镜像，仅包含应用运行所需的核心组件，体积小巧。

:<version>-build

• 包含源码构建工具的重型镜像，预置多种编译依赖，减少手动安装步骤，有助于减小整体镜像体积。

了解更多变体差异

使用场景和适用范围

• 为Orange Pi Zero开发板构建Node.js IoT应用
• 在balena.io平台部署和管理边缘设备应用
• 开发需要动态设备接入（如传感器、外设）的嵌入式系统
• 构建跨平台兼容的轻量化Node.js服务

如何与Balena平台配合使用

参考入门指南快速上手，或通过示例项目了解实际应用场景。

关于Node.js

Node.js是基于Chrome V8引擎的JavaScript运行时，用于构建可扩展的服务器端和网络应用。其核心特性包括：

• 非阻塞I/O模型和事件驱动架构，高效处理并发请求
• 单线程执行模型，通过异步回调避免阻塞
• 内置HTTP和网络模块，可直接作为Web服务器运行
• 使用JavaScript全栈开发，简化技术栈复杂度

更多信息：***.org/wiki/Node.js

!Node.js logo

支持的版本

• 18.9.1 (latest)
• 16.17.1
• 14.20.1

查看Dockerfile源码

详细使用方法

基础Dockerfile示例

dockerfile
# 指定Node.js版本，如latest或具体版本号
FROM balenalib/orange-pi-zero-debian-node:latest
# 暴露应用端口
EXPOSE 8888

构建并运行：

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

Docker Compose配置

yaml
version: "2"
services:
  node:
    image: "balenalib/orange-pi-zero-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

直接运行单文件脚本

console
$ docker run -it --rm \
  --name my-script \
  -v "$PWD":/usr/src/app \
  -w /usr/src/app \
  balenalib/orange-pi-zero-debian-node:latest \
  node your-script.js

用户反馈

问题反馈

通过GitHub Issues提交问题或建议。

贡献指南

欢迎通过Pull Request贡献代码，建议先通过GitHub Issue讨论重大变更。

***文档

• 基础镜像文档
• 新特性说明