improwised/docker-nodejs-base

镜像概述

改进的Node.js基础镜像，基于官方Node.js镜像优化构建，旨在提供稳定、高效的运行环境。该镜像包含核心依赖和预配置，简化Node.js应用的构建流程，同时兼顾安全性和性能优化，适用于开发与生产环境。

核心功能和特性

• 优化基础环境：基于官方Node.js稳定版本构建，确保与主流Node.js应用的兼容性
• 核心依赖预安装：包含常用基础依赖（如npm、yarn等），减少应用构建阶段的依赖安装时间
• 镜像体积优化：采用多阶段构建策略，剔除冗余文件，减小最终镜像体积
• 安全加固：遵循容器安全最佳实践，包含基础安全配置和漏洞修复
• 版本灵活性：提供多种Node.js版本标签（如16.x、18.x、20.x），适配不同应用需求

使用场景和适用范围

• 开发环境：作为Node.js应用的开发基础镜像，提供一致的本地开发环境，避免"环境不一致"问题
• 生产环境：部署Node.js应用程序，确保运行稳定性和资源利用效率
• CI/CD流程：集成到持续集成/持续部署管道，作为应用构建和测试的基础环境
• 微服务架构：作为Node.js微服务的基础镜像，支持容器化部署和服务编排

使用方法和配置说明

基本使用

通过docker run命令直接启动容器（默认启动交互式终端）：

bash
docker run -it --rm improwised/nodejs-base-image:latest node -v

构建自定义应用镜像

在项目Dockerfile中使用本镜像作为基础，构建应用镜像：

dockerfile
# 指定基础镜像（可替换为具体版本标签，如18.x）
FROM improwised/nodejs-base-image:latest

# 设置工作目录
WORKDIR /app

# 复制应用依赖文件
COPY package*.json ./

# 安装应用依赖
RUN npm install --production

# 复制应用代码
COPY . .

# 暴露应用端口
EXPOSE 3000

# 启动命令
CMD ["node", "server.js"]

环境变量配置

支持通过环境变量调整运行参数，常用变量如下：

示例（通过环境变量指定生产环境）：

bash
docker run -d -e NODE_ENV=production -p 3000:3000 my-node-app

Docker Compose集成

在docker-compose.yml中配置服务：

yaml
version: '3.8'
services:
  node-service:
    build: .
    image: improwised/nodejs-base-image:latest
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - PORT=3000
    volumes:
      - ./app:/app:ro  # 只读挂载应用代码（生产环境推荐）
    restart: unless-stopped

版本标签说明

镜像标签遵循{node-version}-{image-version}格式，例如：

• 18.x-latest：基于Node.js 18.x版本的最新镜像
• 20.x-v1.0：基于Node.js 20.x版本的v1.0镜像
• latest：默认标签，指向最新稳定Node.js版本的镜像