balenalib/nanopc-t4-fedora-node

⚠️ 已弃用

该基础镜像已被弃用，将不再接收更新。请阅读https://blog.balena.io/deprecate-balenalib-images/%E8%8E%B7%E5%8F%96%E8%BF%81%E7%A7%BB%E6%8C%87%E5%8D%97%E5%92%8C%E6%8E%A8%E8%8D%90%E6%9B%BF%E4%BB%A3%E6%96%B9%E6%A1%88%E3%80%82

镜像概述和主要用途

本镜像属于 https://balena.io/?ref=dockerhub IoT设备基础镜像系列，专为balena.io平台和https://www.balena.io/os/?ref=dockerhub优化，同时也可在适配架构的任何Docker环境中使用。作为Node.js应用镜像，其核心用途是为Nanopc-T4设备提供轻量、高效的Node.js运行时环境，支持IoT场景下的应用开发与部署。

核心功能和特性

1. 简化的包管理工具

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

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

2. 动态设备支持

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

• 当设置ENV UDEV=1时，自动启动udevd守护进程
• 动态识别并加载容器内/dev目录中的设备节点，支持热插拔设备

更多特性详见 https://www.balena.io/docs/reference/base-images/base-images/#features-overview

使用场景和适用范围

适用场景

• IoT设备上的Node.js应用开发与部署
• 基于balena.io平台的边缘计算项目
• 需要动态设备接入的嵌入式系统应用
• 源码构建与运行环境分离的容器化工作流

架构支持

仅适用于Nanopc-T4设备（ARM架构）

镜像变体说明

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

• 定位：轻量级运行时镜像
• 特性：仅包含运行Node.js应用所需的核心依赖
• 适用场景：生产环境部署、资源受限的设备

:<version>-build

• 定位：构建专用镜像
• 特性：包含完整的源码构建工具链（编译器、链接器等）
• 适用场景：从源码编译Node.js应用或依赖库，减少手动安装工具的需求

详细使用方法和配置说明

支持的Node.js版本

• 20.12.0
• 19.6.1（latest）
• 18.14.1

镜像历史及Dockerfile详情见 https://github.com/balena-io-library/official-images/blob/master/library/nanopc-t4-fedora-node

基础使用方法

1. 创建Dockerfile

dockerfile
# 指定基础镜像版本
FROM docker.xuanyuan.run/balenalib/nanopc-t4-fedora-node:latest
# 暴露应用端口（根据实际需求修改）
EXPOSE 8888

构建并运行：

bash
# 构建镜像
docker build -t my-nodejs-app .

# 启动容器（交互式运行）
docker run -it --rm --name my-running-app docker.xuanyuan.run/my-nodejs-app

2. Docker Compose配置

yaml
version: "2"
services:
  node:
    image: "docker.xuanyuan.run/balenalib/nanopc-t4-fedora-node:latest"
    user: "node"  # 使用非root用户运行
    working_dir: /home/node/app  # 设置工作目录
    environment:
      - NODE_ENV=production  # 配置Node.js环境变量
    volumes:
      - ./:/home/node/app  # 挂载本地代码目录
    expose:
      - "8081"  # 暴露内部端口
    command: "npm start"  # 启动命令

启动命令：

bash
docker-compose up -d

注：该配置假设项目根目录包含package.json，且定义了start脚本（详见https://docs.npmjs.com/misc/scripts#default-values%EF%BC%89

3. 运行单个Node.js脚本

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

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

关键配置参数

环境变量

用户反馈与支持

问题反馈

如遇使用问题，请通过 https://github.com/balena-io-library/base-images/issues 提交。

贡献指南

欢迎提交功能改进、错误修复或更新，建议先通过 https://github.com/balena-io-library/base-images/issues 讨论方案。

扩展文档

• https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub
• https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub
• https://www.balena.io/docs/learn/getting-started/nanopc-t4/nodejs/?ref=dockerhub
• https://www.balena.io/docs/learn/getting-started/nanopc-t4/nodejs/#example-projects?ref=dockerhub