woahbase/alpine-nodejs Docker 镜像 - 轩辕镜像

alpine-nodejs 镜像文档

镜像概述

alpine-nodejs 是一个多架构 Docker 镜像，基于轻量级阿尔卑斯 Linux（Alpine Linux）构建，集成 S6 进程管理工具、Node.js 运行时及 NPM、Yarn、PNPM 等主流 Node.js 包管理器。该镜像旨在为 Node.js 应用提供精简、高效且跨平台的开发与运行环境，由 WOAHBase 维护。

核心功能与特性

1. 多架构支持

支持多种硬件架构，包括 x86_64、aarch64、armv7l、armhf、i386、ppc64le、riscv64 等，适配不同计算平台需求。

2. 轻量级基础

基于 Alpine Linux 构建，具备体积小、启动快、资源占用低的特点，适合对镜像大小和性能敏感的场景。

3. 完整 Node.js 生态

集成 Node.js 运行时及 NPM（Node 包管理器）、Yarn、PNPM 等主流包管理工具，满足各类 Node.js 项目的依赖管理需求。

4. S6 进程管理

内置 S6 进程管理系统，提供可靠的服务进程管理能力，确保容器内应用稳定运行。

使用场景与适用范围

• Node.js 应用开发环境：提供本地开发所需的完整工具链，无需在主机系统单独安装 Node.js 及相关依赖。
• 轻量级服务部署：适用于部署中小型 Node.js 服务（如 API 服务、前端构建产物托管等），减少服务器资源占用。
• CI/CD 流程集成：作为持续集成/持续部署流程中的构建或运行环境，确保跨环境的一致性。

使用方法与配置说明

1. 拉取镜像

从 Docker Hub 拉取最新版本镜像：

bash
docker pull woahbase/alpine-nodejs:latest

如需指定架构（如 aarch64），可通过标签拉取对应架构版本：

bash
docker pull woahbase/alpine-nodejs:aarch64

2. 运行容器示例

基本交互模式（开发调试）

启动交互式 shell，挂载当前项目目录并进入工作目录：

bash
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  woahbase/alpine-nodejs:latest \
  sh

进入容器后，可执行 Node.js 相关命令（如 node -v 查看版本、npm install 安装依赖等）。

启动 Node.js 应用

运行指定 Node.js 应用（假设项目根目录包含 app.js）：

bash
docker run -d \
  --name node-app \
  -v $(pwd):/app \
  -w /app \
  -p 3000:3000 \
  woahbase/alpine-nodejs:latest \
  node app.js

参数说明：

• -d：后台运行容器
• --name node-app：指定容器名称
• -v $(pwd):/app：挂载当前目录到容器内 /app 路径
• -w /app：设置工作目录为 /app
• -p 3000:3000：映射容器端口 3000 到主机端口 3000（根据应用实际端口调整）
• node app.js：启动应用的命令

3. 使用包管理器

容器内已预装 NPM、Yarn、PNPM，可直接用于依赖管理：

bash
# 使用 NPM 安装依赖
docker run -it --rm -v $(pwd):/app -w /app woahbase/alpine-nodejs:latest npm install

# 使用 Yarn 安装依赖
docker run -it --rm -v $(pwd):/app -w /app woahbase/alpine-nodejs:latest yarn install

# 使用 PNPM 安装依赖
docker run -it --rm -v $(pwd):/app -w /app woahbase/alpine-nodejs:latest pnpm install

维护与资源

• 官方文档：woahbase.online/images/alpine-nodejs
• 镜像仓库：Docker Hub
• 源代码：GitHub