area51/node

NodeJS on Alpine Linux Docker镜像

镜像概述

本Docker镜像基于Alpine Linux构建，预装NodeJS运行环境，旨在提供一个轻量级、高效的NodeJS应用部署解决方案。Alpine Linux的轻量特性使得镜像体积小、资源占用低，适合在开发、测试及生产环境中快速部署NodeJS应用。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积显著小于基于Debian/Ubuntu的NodeJS镜像，减少存储空间和网络传输成本
• 完整NodeJS环境：预装NodeJS和npm，可直接运行NodeJS应用程序，无需额外安装依赖
• 高效资源利用：Alpine Linux精简的系统架构降低CPU和内存占用，提升应用运行效率
• 基础工具支持：包含Alpine包管理工具apk，方便安装额外系统依赖

使用场景和适用范围

• 开发环境中快速搭建NodeJS运行环境
• 生产环境中部署轻量级NodeJS应用（如API服务、微服务等）
• CI/CD流程中作为应用构建或测试的基础镜像
• 资源受限环境（如边缘设备、轻量级服务器）中的NodeJS应用部署

使用方法和配置说明

基本使用

运行交互式NodeJS shell

bash
docker run -it --rm node-alpine node

运行本地NodeJS脚本

将当前目录下的app.js脚本挂载到容器中并执行：

bash
docker run -it --rm -v $(pwd):/app -w /app node-alpine node app.js

启动NodeJS应用服务

假设应用监听3000端口，映射容器端口到主机：

bash
docker run -d -p 3000:3000 -v $(pwd):/app -w /app node-alpine node server.js

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  node-app:
    image: node-alpine
    ports:
      - "3000:3000"
    volumes:
      - ./app:/app
    working_dir: /app
    command: node server.js
    environment:
      - NODE_ENV=production

启动服务：

bash
docker-compose up -d

环境变量配置

可通过-e参数或environment字段设置NodeJS相关环境变量，例如：

• NODE_ENV：设置运行环境（如development、production）
• NODE_OPTIONS：NodeJS运行时选项（如--max-old-space-size=4096）

安装额外依赖

如需安装系统依赖，可通过apk命令在容器内执行：

bash
docker run -it --rm node-alpine apk add --no-cache git

注意事项

• Alpine Linux使用musl libc而非glibc，部分依赖glibc的NodeJS模块可能需要额外配置
• 建议通过卷挂载方式管理应用代码，避免直接修改容器内部文件
• 生产环境中应指定具体NodeJS版本标签，确保环境一致性