Node.js Docker镜像文档

镜像概述

本Docker镜像包含Node.js运行时环境，旨在提供一个轻量级、可移植的基础环境，用于开发、测试和运行Node.js应用程序。基于Linux发行版构建，确保良好的兼容性和较小的镜像体积，适合本地开发、CI/CD流程及小型生产环境部署。

核心功能与特性

• 预安装Node.js与包管理器：包含指定版本的Node.js及npm（Node Package Manager），部分版本可能包含yarn
• 多版本支持：通过标签提供多种Node.js版本（如LTS版本、最新稳定版），满足不同应用需求
• 轻量级基础：基于Alpine或Debian等精简Linux发行版，减少镜像体积（通常小于100MB）
• 开发工具链：可能包含基础构建工具（如Git、Python、make等），支持编译原生Node.js模块
• 环境变量配置：支持通过环境变量自定义运行参数（如NODE_ENV、PORT等）

使用场景

• 本地开发环境：快速搭建一致的Node.js开发环境，避免版本冲突
• CI/CD流程：作为CI/CD流水线中的构建或测试环境，确保构建一致性
• 小型生产部署：直接运行Node.js应用（需注意生产环境安全配置）
• 基础镜像层：作为其他依赖Node.js的应用镜像的基础层

使用方法与配置说明

1. 获取镜像

从Docker Hub或GitHub Container Registry拉取镜像（具体地址需参考原仓库说明）：

bash
# 拉取最新版本
docker pull olbat/nodejs:latest

# 拉取特定Node.js版本（例如18.x）
docker pull olbat/nodejs:18

2. 基本运行示例

交互式运行（测试Node.js环境）

bash
docker run -it --rm olbat/nodejs node -v  # 查看Node.js版本
docker run -it --rm olbat/nodejs npm -v   # 查看npm版本

运行本地Node.js应用

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

bash
# 假设应用入口文件为app.js，监听3000端口
docker run -it --rm -v $(pwd):/app -w /app -p 3000:3000 olbat/nodejs node app.js

• -v $(pwd):/app：将当前目录挂载到容器内的/app目录
• -w /app：设置工作目录为/app
• -p 3000:3000：映射容器3000端口到主机3000端口

3. Docker Compose配置示例

创建docker-compose.yml文件，用于管理多服务或持久化配置：

yaml
version: '3'
services:
  node-app:
    image: olbat/nodejs:18
    volumes:
      - ./app:/app
    working_dir: /app
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - PORT=3000
    command: node app.js

启动服务：

bash
docker-compose up -d

4. 环境变量配置

支持以下常用环境变量（具体以Dockerfile为准）：

示例：设置生产环境变量

bash
docker run -it --rm -e NODE_ENV=production olbat/nodejs node app.js

注意事项

• 生产环境使用时，建议配合非root用户运行，并限制容器权限
• 如需持久化数据或配置文件，需通过-v参数挂载外部卷
• 不同标签对应不同Node.js版本，使用前请确认版本兼容性
• 镜像详情及更新日志请参考GitHub仓库