balenalib/cl-som-imx8-alpine-node

balenalib/cl-som-imx8-alpine-node 镜像文档

镜像概述和主要用途

该镜像属于balena.io的IoT设备基础镜像系列，专为物联网设备优化。它不仅适用于balena.io平台和balenaOS操作系统，也可在任何支持相应架构的Docker环境中运行。镜像集成了多种实用特性，旨在简化IoT应用的开发与部署流程。

核心功能和特性

高效包管理工具

• install_packages脚本：抽象底层包管理器差异，自动选择最小依赖安装（忽略可选依赖），安装后清理包管理器元数据，并在安装失败时自动重试，提升包安装效率和可靠性。

动态设备支持

• UDEV设备检测：默认ENTRYPOINT为/usr/bin/entry.sh，会检查UDEV环境变量（通过ENV UDEV=1设置）。当UDEV=1时，自动启动udevd守护进程，使容器内/dev目录能动态识别并显示外部接入的设备节点。

更多特性详情可查看官方特性概述文档。

镜像变体

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

:<version> 或 :<version>-run

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

:<version>-build

构建专用变体，包含大量源码构建工具（如编译器、链接器等），减少手动安装依赖的需求，从而降低整体镜像体积。

了解更多变体差异可参考官方文档。

与Balena平台配合使用

若需在balena平台使用此基础镜像，可参考入门指南快速上手。此外，示例项目库提供了丰富的应用场景参考。

关于Node.js

Node.js是一个用于构建可扩展服务器端和网络应用的软件平台。其特点包括：

• 跨平台运行：应用使用JavaScript编写，可在Node.js运行时（支持Mac OS X、Windows、Linux）直接运行，无需修改。
• 高效异步架构：基于非阻塞I/O和异步事件模型，最大化吞吐量和资源利用率；单线程执行应用逻辑，多线程处理文件/网络事件，适合实时应用开发。
• 内置核心能力：集成Google V8 JavaScript引擎，内置异步I/O库（支持文件、socket、HTTP通信），可直接作为Web服务器运行，无需依赖Apache等外部软件。

更多信息：Node.js***

支持的版本及Dockerfile链接

• 18.7.0 (latest)、16.17.0、14.20.0、12.22.12
  https://github.com/balena-io-library/base-images/tree/master/balena-base-images/node/cl-som-imx8/alpine/

镜像历史及详细信息可查看https://github.com/balena-io-library/official-images/blob/master/library/cl-som-imx8-alpine-node%E3%80%82

使用方法

通过Dockerfile构建应用

在Node.js项目中创建Dockerfile：

dockerfile
# 指定基础镜像版本
FROM balenalib/cl-som-imx8-alpine-node:latest
# 暴露应用端口（替换为实际端口）
EXPOSE 8888

构建并运行：

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

使用Docker Compose部署

创建docker-compose.yml：

yaml
version: "2"
services:
  node:
    image: "balenalib/cl-som-imx8-alpine-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脚本）

启动服务：

console
$ docker-compose up -d

直接运行单Node.js脚本

对于简单单文件项目，可直接通过镜像运行脚本：

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

用户反馈

问题反馈

如有使用问题或疑问，请通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4%E3%80%82

贡献指南

欢迎贡献代码（功能、修复、更新等）。提交前建议通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E8%AE%A1%E5%88%92%EF%BC%8C%E4%BB%A5%E4%BE%BF%E8%8E%B7%E5%8F%96%E7%A4%BE%E5%8C%BA%E5%8F%8D%E9%A6%88%E5%92%8C%E6%8C%87%E5%AF%BC%E3%80%82

文档资源

• 基础镜像文档：官方文档中心
• 新特性说明：balenalib镜像更新博客