该镜像属于balena.io物联网设备基础镜像系列,专为balena.io平台和balenaOS优化,同时也适用于任何适当架构的Docker环境。作为Node.js基础镜像,它提供了在物联网设备上运行Node.js应用的精简且高效的环境,集成了balenalib特有的工具和功能。
install_packages脚本:抽象底层包管理器细节,可自动安装指定软件包,最小化依赖(忽略可选依赖),清理包管理器元数据,并在安装失败时重试,简化依赖管理流程。ENTRYPOINT ["/usr/bin/entry.sh"],通过设置ENV UDEV=1环境变量,可启动udevd守护进程,使容器/dev目录中自动识别并显示动态插入的设备节点。更多特性详情,请查看特性概述。
balenalib镜像提供多种变体,满足不同使用场景需求:
:<version> 或 :<version>-run默认镜像变体,设计为精简的运行时版本,仅包含应用运行所需的核心组件,体积小巧高效。
:<version>-build构建专用变体,包含大量源代码构建工具,减少Dockerfile中手动安装依赖的需求,从而减小系统中所有镜像的总体积。
镜像变体详情
如需使用此基础镜像与balena平台配合,可参考入门指南,同时提供了丰富的示例项目供参考。
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
18.7.0 (latest)、16.17.0、14.20.0、12.22.12
有关镜像历史和详细信息,可查看***镜像清单文件(ccimx8x-sbc-pro-alpine-node)。
在Node.js应用项目中创建Dockerfile:
dockerfile# 指定Node.js基础镜像版本 FROM balenalib/ccimx8x-sbc-pro-alpine-node:latest # 暴露应用默认端口 EXPOSE 8888
构建并运行镜像:
console$ docker build -t my-nodejs-app . $ docker run -it --rm --name my-running-app my-nodejs-app
ymlversion: "2" services: node: image: "balenalib/ccimx8x-sbc-pro-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启动:
console$ docker-compose up -d
注:此配置会将当前目录(含
node_modules)挂载到容器,需确保项目包含定义启动脚本的package.json文件。
对于简单单文件项目,可直接运行脚本:
console$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/app -w /usr/src/app balenalib/ccimx8x-sbc-pro-alpine-node:latest node your-daemon-or-script.js
如有任何问题或疑问,请通过GitHub issue联系我们。
欢迎贡献新功能、修复或更新(无论大小),我们会尽快处理所有拉取请求。重大贡献建议先通过GitHub issue讨论计划。

来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429