decaf/docker-node

Docker Node基础镜像

概述

本镜像为Node.js应用提供标准化的Docker基础环境，旨在简化Node.js应用的容器化构建、测试与部署流程。通过预配置Node.js运行时及相关工具，确保应用在不同环境中具有一致的运行行为，降低环境差异导致的部署问题。

核心功能与特性

• 多版本支持：提供多种Node.js LTS版本（如14.x、16.x、18.x等），满足不同应用的版本需求
• 优化镜像大小：基于Alpine或Debian Slim基础镜像构建，减少镜像体积，提升部署效率
• 预安装依赖管理工具：内置npm、yarn包管理器，支持应用依赖安装
• 安全更新：定期更新基础镜像及Node.js版本，修复已知安全漏洞
• 环境一致性：标准化运行环境，确保开发、测试与生产环境的一致性

使用场景

• Node.js应用开发：作为本地开发环境，避免本地Node.js版本冲突
• CI/CD流程集成：在持续集成/持续部署流程中用于构建、测试Node.js应用
• 生产环境部署：作为生产环境运行Node.js应用的基础镜像，确保稳定性与安全性
• 微服务架构：为基于Node.js的微服务提供统一的基础运行环境

使用方法与配置说明

基本使用

拉取镜像

根据需要的Node.js版本拉取对应镜像（以18.x版本为例）：

bash
docker pull node:18-alpine

运行容器

运行Node.js应用容器，挂载本地代码目录并暴露端口：

bash
docker run -d \
  --name node-app \
  -p 3000:3000 \
  -v $(pwd):/app \
  -w /app \
  node:18-alpine \
  sh -c "npm install && npm start"

Docker Compose配置示例

创建docker-compose.yml文件，配置Node.js应用服务：

yaml
version: '3'
services:
  node-app:
    image: node:18-alpine
    container_name: node-app
    ports:
      - "3000:3000"
    volumes:
      - ./:/app
    working_dir: /app
    environment:
      - NODE_ENV=production
      - PORT=3000
    command: sh -c "npm install && npm start"

启动服务：

bash
docker-compose up -d

环境变量配置

常用环境变量：

• NODE_ENV：设置Node.js运行环境（如development、production，默认development）
• PORT：指定应用监听端口（需与容器端口映射一致）
• npm_config_registry：设置npm镜像源（如https://registry.npm.taobao.org）

示例：设置国内npm镜像源

bash
docker run -e "npm_config_registry=https://registry.npm.taobao.org" node:18-alpine npm install

构建自定义镜像

基于本镜像构建包含应用代码的自定义镜像，创建Dockerfile：

dockerfile
FROM node:18-alpine

WORKDIR /app

COPY package*.json ./
RUN npm install --production

COPY . .

EXPOSE 3000

CMD ["npm", "start"]

构建并运行：

bash
docker build -t my-node-app .
docker run -p 3000:3000 my-node-app

注意事项

• 生产环境建议使用特定版本标签（如node:18.18.0-alpine）而非latest，确保版本稳定性
• 对于依赖原生模块的应用，可能需要安装额外系统依赖（可通过apk add或apt-get install在Dockerfile中添加）
• 本地开发时，建议使用node_modules目录挂载或.dockerignore排除node_modules，避免依赖文件冲突