balenalib/npe-x500-m3-ubuntu-node

⚠️ 已弃用 (DEPRECATED)

此基础镜像已被弃用，将不再接收更新。请阅读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）设备设计。镜像针对 https://balena.io/?ref=dockerhub 和 https://www.balena.io/os/?ref=dockerhub 进行了优化，但也可在任何运行于相应架构的 Docker 环境中使用。

!balenalogo

核心功能与特性

balenalib 基础镜像包含以下主要特性：

• 便捷的包安装工具：提供 install_packages 脚本，抽象底层包管理器的具体实现细节。该工具会以最小依赖方式安装指定包（忽略可选依赖），清理包管理器元数据，并在安装失败时重试。

• 动态设备支持：每个 balenalib 基础镜像默认 ENTRYPOINT 为 ENTRYPOINT ["/usr/bin/entry.sh"]。通过设置 ENV UDEV=1 环境变量，该脚本会启动 udevd 守护进程，使容器内 /dev 目录能动态识别并创建外部插入设备的节点。

更多详情请参见 https://www.balena.io/docs/reference/base-images/base-images/#features-overview 文档。

镜像变体 https://www.balena.io/docs/reference/base-images/base-images/#run-vs-build?ref=dockerhub

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

:<version> 或 :<version>-run

默认镜像变体。run 变体设计为精简版本，仅包含运行时必要组件，体积最小。

:<version>-build

构建变体是包含更多工具的重型镜像，预安装了源码构建所需的大部分工具。可减少 Dockerfile 中手动安装的包数量，从而降低系统中所有镜像的总体积。

与 Balena 配合使用

https://www.balena.io/docs/learn/getting-started/npe-x500-m3/nodejs/?ref=dockerhub 可帮助您开始使用此基础镜像与 Balena 平台。此外，https://www.balena.io/docs/learn/getting-started/npe-x500-m3/nodejs/#example-projects?ref=dockerhub 可展示基于 Balena 的应用场景。

关于 Node.js

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

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

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

***.org/wiki/Node.js

!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/node/logo.png

支持的版本及 Dockerfile 链接

https://github.com/balena-io-library/base-images/tree/master/balena-base-images/node/npe-x500-m3/ubuntu/

有关镜像及其历史的更多信息，请参见 https://github.com/balena-io-library/official-images 中的 https://github.com/balena-io-library/official-images/blob/master/library/npe-x500-m3-ubuntu-node%E3%80%82

使用方法

在 Node.js 项目中创建 Dockerfile

dockerfile
# 指定所需版本的 Node 基础镜像 node:<version>
FROM docker.xuanyuan.run/balenalib/npe-x500-m3-ubuntu-node:latest
# 替换为应用的默认端口
EXPOSE 8888

构建并运行 Docker 镜像：

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

若使用 Docker Compose：

yml
version: "2"
services:
  node:
    image: "docker.xuanyuan.run/balenalib/npe-x500-m3-ubuntu-node:latest"
    user: "node"
    working_dir: /home/node/app
    environment:
      - NODE_ENV=production
    volumes:
      - ./:/home/node/app
    expose:
      - "8081"
    command: "npm start"

通过 Docker Compose 运行：

console
$ docker-compose up -d

上述 Docker Compose 示例将当前目录（含 node_modules）挂载到容器，假设应用包含定义了 https://docs.npmjs.com/misc/scripts#default-values 的 https://docs.npmjs.com/files/package.json 文件。

运行单个 Node.js 脚本

对于简单的单文件项目，无需编写完整 Dockerfile，可直接使用 Node.js 镜像运行脚本：

console
$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/app -w /usr/src/app balenalib/npe-x500-m3-ubuntu-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 中。更多 balenalib 基础镜像（如 Python、Go 或精简版本）的信息，请参见该文档。