balenalib/photon-nano-debian-node

balenalib/photon-nano-debian-node 镜像文档

镜像概述和主要用途

该镜像属于balena.io IoT设备基础镜像系列，专为IoT设备开发优化，主要适配balena.io平台和balenaOS操作系统，同时也可在任何支持相应架构的Docker环境中使用。作为Node.js基础镜像，它为IoT应用提供了精简高效的运行和构建环境，支持从简单脚本到复杂应用的开发部署。

核心功能和特性

简化的包管理

• install_packages脚本：自动处理底层包管理器差异，安装指定包时最小化依赖（忽略可选依赖），自动清理包管理器元数据，并在安装失败时重试，大幅简化依赖管理流程。

动态设备支持

• udevd集成：默认ENTRYPOINT为/usr/bin/entry.sh，通过设置环境变量UDEV=1可启动udevd守护进程，使容器内/dev目录能动态识别并添加外部插入的设备节点，适应IoT场景中的外设热插拔需求。

镜像变体

:<version> 或 :<version>-run

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

:<version>-build

• 构建时变体：包含完整的源代码构建工具链，减少Dockerfile中手动安装构建依赖的需求，降低整体镜像体积。

使用场景和适用范围

• balena平台IoT项目：与balena.io和balenaOS深度集成，适合各类IoT设备应用开发。
• Node.js应用开发：作为Node.js基础镜像，支持IoT场景下的服务端和网络应用开发。
• 资源受限环境：run变体的精简特性特别适合内存和存储资源有限的嵌入式设备。

支持的版本

• 18.7.0 (latest)
• 16.17.0
• 14.20.0
• 12.22.12

查看https://github.com/balena-io-library/official-images/blob/master/library/photon-nano-debian-node%E8%8E%B7%E5%8F%96%E6%9B%B4%E5%A4%9A%E7%89%88%E6%9C%AC%E4%BF%A1%E6%81%AF%E3%80%82

使用方法

创建Dockerfile

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

dockerfile
# 指定基础镜像版本
FROM balenalib/photon-nano-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配置

创建docker-compose.yml：

yaml
version: "2"
services:
  node:
    image: "balenalib/photon-nano-debian-node:latest"
    user: "node"
    working_dir: /home/node/app
    environment:
      - NODE_ENV=production  # 设置Node.js环境
      - UDEV=1  # 启用动态设备支持（如需）
    volumes:
      - ./:/home/node/app  # 挂载本地项目
    expose:
      - "8081"  # 暴露应用端口
    command: "npm start"  # 启动命令

启动服务：

console
$ docker-compose up -d

运行单个脚本

直接运行Node.js脚本：

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

环境变量说明

• UDEV：设为1时启动udevd，启用动态设备检测，默认禁用。
• NODE_ENV：Node.js运行环境标识，常用值为production（生产）和development（开发）。

用户反馈

问题反馈

通过https://github.com/balena-io-library/base-images/issues%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E6%88%96%E5%BB%BA%E8%AE%AE%E3%80%82

贡献指南

欢迎贡献代码或文档，建议先通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E8%AE%A1%E5%88%92%E3%80%82

参考文档

• balena基础镜像特性
• balena基础镜像迁移指南