balenalib/asus-tinker-edge-t-node

balenalib/asus-tinker-edge-t-debian-node 镜像文档

镜像概述和主要用途

本镜像属于 balena.io 物联网（IoT）设备基础镜像系列的一部分，专为 IoT 设备优化，主要用于搭配 balena.io 和 balenaOS 平台使用，同时也可在支持相应架构的任何 Docker 环境中运行。该镜像基于 Debian 系统，集成 Node.js 运行环境，提供精简的运行时和完整的构建工具两种变体，满足 IoT 场景下 Node.js 应用的开发、构建与部署需求。

核心功能和特性

1. install_packages 包管理脚本

• 功能：抽象底层包管理器差异，简化依赖安装流程。
• 特性：
  • 自动选择依赖最少的软件包（忽略可选依赖），减少镜像体积。
  • 安装完成后自动清理包管理器元数据，优化镜像大小。
  • 支持安装失败时自动重试，提升构建稳定性。

2. 动态设备接入支持（UDEV）

• 默认入口点：镜像默认 ENTRYPOINT 为 /usr/bin/entry.sh。
• UDEV 激活：通过设置环境变量 ENV UDEV=1 启用 UDEV 功能，此时入口脚本会启动 udevd 守护进程，使容器内 /dev 目录中自动生成动态接入设备的节点文件，支持外设热插拔。

更多特性详情可参考 balena 官方文档 - 特性概述。

使用场景和适用范围

适用场景

• IoT 设备上 Node.js 应用的容器化部署。
• 搭配 balena.io 平台进行 IoT 项目开发、测试与生产环境交付。
• 需要动态识别外设的 IoT 应用（如传感器、USB 设备等）。
• Node.js 应用的构建（源码编译）与运行时环境分离需求。

适用范围

• 硬件：华硕 Tinker Edge T 等支持的 IoT 设备。
• 平台：balenaOS、Linux 等 Docker 兼容系统。
• 开发阶段：使用 -build 变体进行源码构建；运行阶段：使用 -run 或默认变体部署精简运行时。

镜像变体

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

:<version> 或 :<version>-run

• 定位：默认镜像，精简运行时变体。
• 特性：仅包含应用运行必需的依赖，体积小巧，适合生产环境部署。

:<version>-build

• 定位：构建工具变体，重型镜像。
• 特性：集成大量源码构建工具（如编译器、链接器等），减少手动安装依赖的工作量，间接降低整体镜像体积。

更多变体详情可参考 balena 官方文档 - Run vs Build。

详细使用方法和配置说明

前提条件

• 已安装 Docker 或 Docker Compose。
• 目标设备架构与镜像匹配（如华硕 Tinker Edge T）。

1. 基础使用（Dockerfile + Docker CLI）

编写 Dockerfile

dockerfile
# 指定 Node.js 基础镜像，替换 <version> 为所需版本（如 18.7.0）
FROM balenalib/asus-tinker-edge-t-debian-node:latest
# 暴露应用默认端口（根据实际需求修改）
EXPOSE 8888

构建并运行镜像

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

# 运行容器（交互式，退出时自动删除容器）
$ docker run -it --rm --name my-running-app my-nodejs-app

2. Docker Compose 配置

docker-compose.yml 示例

yaml
version: "2"
services:
  node:
    image: "balenalib/asus-tinker-edge-t-debian-node:latest"
    user: "node"  # 使用 node 用户运行，增强安全性
    working_dir: /home/node/app  # 工作目录
    environment:
      - NODE_ENV=production  # 设置 Node.js 环境为生产环境
    volumes:
      - ./:/home/node/app  # 挂载当前目录到容器内应用目录
    expose:
      - "8081"  # 暴露端口（内部访问）
    command: "npm start"  # 启动命令（需确保 package.json 中定义 "start" 脚本）

启动服务

bash
$ docker-compose up -d  # 后台运行服务

3. 单文件 Node.js 脚本运行

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

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

4. 关键配置参数

用户反馈

问题反馈

如使用中遇到问题或有疑问，可通过 https://github.com/balena-io-library/base-images/issues 提交反馈。

贡献指南

欢迎提交新功能、修复或更新（无论大小）。建议在编码前通过 https://github.com/balena-io-library/base-images/issues 讨论计划，以确保方向一致。

文档参考

• balena 基础镜像文档
• balena 新基础镜像特性博客