balenalib/asus-tinker-board-s-alpine-node 镜像文档

镜像概述和主要用途

该镜像属于balena.io基础镜像系列，专为物联网（IoT）设备设计并优化。它针对balena.io平台和balenaOS系统进行了深度适配，同时也可在任何支持相应架构的Docker环境中运行。作为Node.js基础镜像，适用于开发和部署物联网设备上的Node.js应用程序。

!balena logo

核心功能和特性

balenalib基础镜像具备以下关键特性：

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

• 动态设备支持：默认ENTRYPOINT为ENTRYPOINT ["/usr/bin/entry.sh"]，通过设置ENV UDEV=1可启用udevd守护进程，使容器能动态识别并显示/dev目录中的设备节点。

更多特性详情，请参阅特性概述文档。

镜像变体

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

:<version> 或 :<version>-run

默认镜像变体，设计为精简的运行时环境，仅包含应用运行必需的组件，体积小巧。

:<version>-build

包含构建工具的重型镜像，预装大量源代码构建所需工具，减少Dockerfile中手动安装的包数量，从而减小系统总体镜像体积。

了解更多变体信息

使用场景和适用范围

适用于物联网设备开发，特别是基于balena.io平台的项目，需在嵌入式设备上运行Node.js应用的场景，包括但不限于：

• 边缘计算节点
• 设备状态监控应用
• 实时数据处理服务
• 物联网网关应用

详细使用方法和配置说明

如何在Balena平台使用此镜像

快速入门指南可帮助您开始使用该基础镜像，同时提供示例项目展示balena平台的应用可能性。

什么是Node.js？

Node.js是用于构建可扩展服务器端和网络应用的软件平台。应用程序使用JavaScript编写，可在Mac OS X、Windows和Linux的Node.js运行时中无缝运行。

Node.js应用通过非阻塞I/O和异步事件模型实现高吞吐量和效率，采用单线程执行模型，同时使用多线程处理文件和网络事件。因其异步特性，常用于开发实时应用程序。

Node.js内部使用Google V8 JavaScript引擎执行代码，大部分基础模块采用JavaScript编写，内置异步I/O库支持文件、套接字和HTTP通信，无需Apache等额外软件即可作为Web服务器运行。

***.org/wiki/Node.js

!Node.js logo

支持的版本及对应Dockerfile链接

18.7.0 (latest)、16.17.0、14.20.0、12.22.12

有关镜像及其历史的更多信息，请查看balena-io-library/official-images GitHub仓库中的相关清单文件(asus-tinker-board-s-alpine-node)。

基础使用示例

创建Dockerfile

在Node.js应用项目中创建以下Dockerfile：

# 指定所需版本的Node.js基础镜像
FROM balenalib/asus-tinker-board-s-alpine-node:latest
# 暴露应用默认端口（根据实际情况修改）
EXPOSE 8888

构建并运行镜像：

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

Docker Compose配置

version: "2"
services:
  node:
    image: "balenalib/asus-tinker-board-s-alpine-node:latest"
    user: "node"
    working_dir: /home/node/app
    environment:
      - NODE_ENV=production
    volumes:
      - ./:/home/node/app  # 挂载当前目录到容器
    expose:
      - "8081"  # 暴露内部端口
    command: "npm start"  # 启动命令

使用Docker Compose启动：

$ docker-compose up -d

注：此配置假设项目包含package.json文件并定义了start脚本。

运行单个Node.js脚本

对于单文件项目，可直接运行脚本：

$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/app -w /usr/src/app balenalib/asus-tinker-board-s-alpine-node:latest node your-daemon-or-script.js

用户反馈

Issues

如遇问题或疑问，请通过GitHub Issue联系我们。

Contributing

欢迎贡献新功能、修复或更新（无论大小）。我们鼓励在编码前通过GitHub Issue讨论您的计划，以获取反馈和避免重复工作。

Documentation

镜像文档存储在基础镜像文档中。有关balenalib新特性的更多信息，请参阅博客文章。