Node.js (ppc64le) 官方镜像文档

注意事项

本仓库是 node 官方镜像 的 ppc64le 架构专用构建版本。更多信息请参见官方镜像文档中的 “非 amd64 架构？” 和官方镜像 FAQ 中的 “镜像源在 Git 中已更改，该如何处理？”。

镜像概述与主要用途

Node.js 是一个基于 JavaScript 的服务器端和网络应用平台。其应用程序使用 JavaScript 编写，可在 Node.js 运行时环境中跨 macOS、Windows 和 Linux 系统运行，无需修改。Node.js 旨在通过非阻塞 I/O 和异步事件模型最大化吞吐量和效率，适用于构建可扩展的后端服务、实时应用和网络服务器。

核心功能与特性

• 非阻塞 I/O 模型：通过异步事件驱动架构处理并发请求，提高应用吞吐量
• 跨平台运行：支持 macOS、Windows 和 Linux 系统，应用无需修改即可部署
• V8 引擎：内置 Google V8 JavaScript 引擎，高效执行代码
• 内置 I/O 库：提供文件、 socket 和 HTTP 通信的异步 I/O 支持，可直接作为 Web 服务器运行
• 单线程与多线程结合：应用逻辑单线程执行，文件和网络事件处理使用多线程

使用场景与适用范围

• 实时应用：聊天系统、实时通知、协作工具等（得益于异步特性）
• Web 服务器：无需依赖 Apache 等额外软件，直接处理 HTTP 请求
• API 服务：构建高性能 RESTful 或 GraphQL API
• 微服务架构：作为轻量级服务节点，支持服务间通信
• 开发环境：快速搭建隔离的 Node.js 开发环境

快速参考

维护者

Node.js Docker 团队

获取帮助

Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及 Dockerfile 链接

以下为 ppc64le/node 镜像的常用标签及其对应的 Dockerfile 源链接：

• 24, 24-bookworm, 24.10, 24.10-bookworm, 24.10.0, 24.10.0-bookworm, bookworm, current, current-bookworm, latest
• 24-bookworm-slim, 24-slim, 24.10-bookworm-slim, 24.10-slim, 24.10.0-bookworm-slim, 24.10.0-slim, bookworm-slim, current-bookworm-slim, current-slim, slim
• 24-trixie, 24.10-trixie, 24.10.0-trixie, current-trixie, trixie
• 24-trixie-slim, 24.10-trixie-slim, 24.10.0-trixie-slim, current-trixie-slim, trixie-slim
• 22, 22-bookworm, 22.20, 22.20-bookworm, 22.20.0, 22.20.0-bookworm, jod, jod-bookworm, lts, lts-bookworm, lts-jod
• 22-bookworm-slim, 22-slim, 22.20-bookworm-slim, 22.20-slim, 22.20.0-bookworm-slim, 22.20.0-slim, jod-bookworm-slim, jod-slim, lts-bookworm-slim, lts-slim
• 22-trixie, 22.20-trixie, 22.20.0-trixie, jod-trixie, lts-trixie
• 22-trixie-slim, 22.20-trixie-slim, 22.20.0-trixie-slim, jod-trixie-slim, lts-trixie-slim
• 20-alpine3.21, 20.19-alpine3.21, 20.19.5-alpine3.21, iron-alpine3.21
• 20-alpine, 20-alpine3.22, 20.19-alpine, 20.19-alpine3.22, 20.19.5-alpine, 20.19.5-alpine3.22, iron-alpine, iron-alpine3.22
• 20, 20-bookworm, 20.19, 20.19-bookworm, 20.19.5, 20.19.5-bookworm, iron, iron-bookworm
• 20-bookworm-slim, 20-slim, 20.19-bookworm-slim, 20.19-slim, 20.19.5-bookworm-slim, 20.19.5-slim, iron-bookworm-slim, iron-slim
• 20-trixie, 20.19-trixie, 20.19.5-trixie, iron-trixie
• 20-trixie-slim, 20.19-trixie-slim, 20.19.5-trixie-slim, iron-trixie-slim

快速参考（续）

问题反馈地址

[***]

支持的架构

（更多信息）
amd64、arm32v6、arm32v7、arm64v8、ppc64le、s390x

镜像工件详情

repo-info 仓库的 repos/node/ 目录（历史记录）
（包含镜像元数据、传输大小等）

镜像更新

official-images 仓库的 library/node 标签
official-images 仓库的 library/node 文件（历史记录）

描述来源

docs 仓库的 node/ 目录（历史记录）

使用方法与配置说明

详细使用指南请参见 GitHub 文档：如何使用本镜像。

基本使用示例

运行交互式 shell

docker run -it --rm ppc64le/node node

运行本地 Node.js 应用

将当前目录的 Node.js 应用挂载到容器中运行：

docker run -it --rm --name my-node-app -v "$PWD":/usr/src/app -w /usr/src/app ppc64le/node node app.js

暴露应用端口

若应用监听 3000 端口，可通过 -p 参数映射端口：

docker run -it --rm --name my-node-app -p 3000:3000 -v "$PWD":/usr/src/app -w /usr/src/app ppc64le/node node app.js

镜像变体

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

ppc64le/node:<version>（默认版本）

• 用途：通用场景，适合作为临时容器（挂载源码并启动应用）或构建其他镜像的基础。
• 特点：基于 buildpack-deps，包含大量常用 Debian 包，减少衍生镜像的依赖安装量。
• 标签命名：部分标签包含 Debian 发行版代号（如 bookworm、trixie），建议显式指定以避免 Debian 版本更新导致的兼容性问题。

ppc64le/node:<version>-slim（精简版本）

• 用途：空间受限环境，仅包含运行 Node.js 所需的最小依赖。
• 特点：体积小于默认版本，不含额外工具和库，适合生产环境中仅需运行 Node.js 应用的场景。

ppc64le/node:<version>-alpine（Alpine 版本）

• 用途：极致精简需求，追求最小镜像体积。
• 特点：基于 Alpine Linux（约 5MB 基础镜像），使用 musl libc 替代 glibc，可能存在部分依赖兼容性问题。需自行安装额外工具（如 git、bash）。

许可证信息

• Node.js 许可证：查看许可证信息
• Node.js Docker 项目许可证：查看许可证信息

镜像可能包含其他软件（如基础系统的 Bash 等），其许可证需参考对应软件。部分自动检测的许可证信息可在 repo-info 仓库的 node/ 目录 中找到。

使用前请确保遵守所有包含软件的相关许可证。