balenalib/beaglebone-green-debian-node Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

balenalib/beaglebone-green-debian-node 镜像文档

1. 镜像概述和主要用途

本镜像属于 balena.io 物联网（IoT）设备基础镜像系列，基于 Debian 系统并集成 Node.js 运行时环境。该镜像专为 balena.io 平台和 balenaOS 优化，同时也可在其他支持相应架构的 Docker 环境中使用，适用于构建和运行物联网设备上的 Node.js 应用。

2. 核心功能和特性

2.1 便捷的包管理工具

内置 install_packages 脚本，抽象底层包管理器差异，具备以下特性：

• 自动选择依赖最少的包版本（忽略可选依赖）
• 安装后清理包管理器元数据，减少镜像体积
• 安装失败时自动重试

2.2 动态设备支持

默认 ENTRYPOINT 为 /usr/bin/entry.sh，通过环境变量控制设备节点检测：

• 设置 ENV UDEV=1 时，自动启动 udevd 守护进程
• 容器内 /dev 目录将动态生成连接的设备节点，支持热插拔设备

更多特性详情参见 balena 官方文档 - 特性概述

3. 镜像变体

balenalib 镜像提供多种变体，满足不同场景需求：

3.1 :<version> 或 :<version>-run

• 默认镜像，轻量级运行时变体
• 仅包含应用运行所需的核心依赖，体积最小化
• 示例：balenalib/beaglebone-green-debian-node:18.7.0 或 :18.7.0-run

3.2 :<version>-build

• 构建变体，重型镜像，包含源码构建所需工具链
• 预置编译器、链接器等构建工具，减少手动安装步骤
• 适合多阶段构建场景，降低整体镜像体积
• 示例：balenalib/beaglebone-green-debian-node:18.7.0-build

变体详情参见 balena 官方文档 - Run vs Build

4. 使用场景和适用范围

4.1 适用场景

• 物联网设备运行时：通过 run 变体部署轻量级 Node.js 应用，适用于资源受限的 IoT 设备
• 应用构建环境：通过 build 变体在容器内编译 Node.js 应用源码，避免本地环境依赖冲突
• balena 平台开发：与 balenaOS 和 balena.io 平台无缝集成，简化 IoT 应用部署流程

4.2 支持架构

适用于 BeagleBone Green 硬件架构（ARM 架构），需确保 Docker 环境支持对应架构。

5. 详细使用方法和配置说明

5.1 基础使用（Dockerfile）

创建 Dockerfile：

dockerfile
# 指定 Node.js 版本，例如 latest 或具体版本号
FROM balenalib/beaglebone-green-debian-node:latest
# 暴露应用默认端口（根据实际需求修改）
EXPOSE 8888

构建并运行：

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

5.2 Docker Compose 配置

创建 docker-compose.yml：

yaml
version: "2"
services:
  node:
    image: "balenalib/beaglebone-green-debian-node:latest"
    user: "node"  # 使用 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_modules）挂载到容器，需确保项目根目录存在 package.json 并定义 start 脚本。

5.3 运行单个 Node.js 脚本

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

console
$ docker run -it --rm --name my-running-script \
  -v "$PWD":/usr/src/app \  # 挂载当前目录到容器
  -w /usr/src/app \  # 设置工作目录
  balenalib/beaglebone-green-debian-node:latest \
  node your-daemon-or-script.js  # 运行脚本

5.4 在 Balena 平台使用

参考 Balena 快速入门指南 部署应用，或查看 示例项目 获取实践案例。

6. 环境变量配置

启用设备节点检测：

dockerfile
FROM balenalib/beaglebone-green-debian-node:latest
ENV UDEV=1  # 启动 udevd 守护进程

7. 支持版本

当前支持的 Node.js 版本：

• 18.7.0（latest）
• 16.17.0
• 14.20.0
• 12.22.12

版本详情及 Dockerfile 链接：GitHub 仓库

8. 用户反馈

8.1 问题报告

如遇镜像相关问题，通过 GitHub Issues 提交反馈。

8.2 贡献代码

欢迎贡献新功能、修复或更新，建议先通过 GitHub Issues 讨论方案，再提交 Pull Request。

8.3 更多文档

• balena 基础镜像特性概述
• run vs build 变体差异
• balenaOS 文档