balenalib IoT设备基础镜像（Node.js版）介绍

镜像概述

本镜像属于 balena.io IoT设备基础镜像系列，专为balena.io平台和balenaOS优化，同时兼容其他符合架构要求的Docker环境。

核心特性

balenalib基础镜像包含以下实用功能：

• 简化包管理：内置install_packages脚本，可自动适配底层包管理器（无需手动处理apt/yum等差异）。该脚本会优先安装依赖最少的软件包（忽略可选依赖），安装后自动清理包管理器元数据，并在安装失败时重试。

• 动态设备支持：默认入口点（ENTRYPOINT ["/usr/bin/entry.sh"]）可检测UDEV环境变量。当设置ENV UDEV=1时，脚本会启动udevd守护进程，确保容器内/dev目录下的设备节点能动态识别并生效。

更多特性细节可参考***文档-特性概述。

镜像变体

balenalib镜像提供多种变体，适配不同使用场景：

:<version> 或 :<version>-run

默认镜像，精简的"运行时"变体，仅包含应用运行必需的基础组件，体积小巧。

:<version>-build

"构建时"变体，预装大量源码构建工具（如编译器、链接器等），可减少Dockerfile中手动安装的依赖包数量，从而降低整体镜像体积。

了解更多变体差异

在Balena平台使用

• 入门指南：参考***入门文档可快速掌握基础使用流程。
• 示例参考：示例项目库包含实际应用场景，可直观了解镜像功能。

关于Node.js

Node.js是一款用于构建可扩展服务器端和网络应用的平台，特性包括：

• 跨平台兼容：基于JavaScript开发，可在macOS、Windows、Linux系统的Node.js运行时中直接运行，无需修改代码。
• 高效异步处理：采用非阻塞I/O和异步事件模型，专注提升吞吐量和资源效率；虽为单线程运行，但通过多线程处理文件/网络事件。
• 实时应用优势：异步特性使其特别适合开发实时交互应用（如聊天、数据流处理）。
• 底层引擎与工具：内置Google V8 JavaScript引擎执行代码，核心模块多基于JavaScript开发；自带异步I/O库（支持文件、socket、HTTP通信），无需依赖Apache等额外软件即可作为Web服务器运行。

更多背景可参考***-Node.js

支持版本与Dockerfile

当前支持以下Node.js版本，Dockerfile源码可在GitHub仓库查看：

• 18.7.0（最新）、16.17.0、14.20.0、12.22.12
  查看Dockerfile源码

镜像使用方法

1. 创建Dockerfile

在Node.js项目中创建如下Dockerfile：

# 指定基础镜像版本（可替换为上述支持的版本号）
FROM balenalib/imx8m-var-dart-debian-node:latest
# 暴露应用端口（替换为实际端口）
EXPOSE 8888

构建并运行：

# 构建镜像
docker build -t my-nodejs-app .
# 启动容器（交互式运行，退出时自动清理）
docker run -it --rm --name my-running-app my-nodejs-app

2. 使用Docker Compose

创建docker-compose.yml：

version: "2"
services:
  node:
    image: "balenalib/imx8m-var-dart-debian-node:latest"
    user: "node"
    working_dir: /home/node/app
    environment:
      - NODE_ENV=production  # 设置环境变量
    volumes:
      - ./:/home/node/app  # 挂载本地代码到容器
    expose:
      - "8081"  # 暴露端口
    command: "npm start"  # 启动命令（需package.json中定义start脚本）

启动服务：

docker-compose up -d

3. 直接运行单文件脚本

对简单项目，可直接通过镜像运行脚本，无需编写Dockerfile：

# 挂载当前目录到容器，运行指定脚本
docker run -it --rm --name my-running-script \
  -v "$PWD":/usr/src/app \
  -w /usr/src/app \
  balenalib/imx8m-var-dart-debian-node:latest \
  node your-daemon-or-script.js

用户反馈

问题反馈

如有使用问题或疑问，可通过GitHub Issue提交。

贡献代码

欢迎提交新功能、修复或更新（无论大小）。建议提交代码前，先通过GitHub Issue讨论计划，以便其他贡献者提供方向建议或避免重复开发。

文档资源

• 完整基础镜像列表（含Node.js、Python、Go等专项镜像）可参考***文档。
• 新特性说明可查看博客文章。