galilee/node-build

Node.js Docker镜像文档

镜像概述

Node.js Docker镜像是用于运行Node.js应用程序的标准化容器镜像，提供预配置的Node.js运行环境，简化Node.js应用的开发、测试和部署流程。该镜像由Node.js官方或可信机构维护，基于不同操作系统（如Alpine Linux、Debian）构建，提供多种Node.js版本标签，满足不同应用场景的需求。

核心功能与特性

• 多版本支持：提供多种Node.js版本标签（如lts、20、18等），适配不同应用的版本依赖
• 多样基础镜像：提供基于Alpine（轻量级，体积小）、Debian（兼容性好）、Slim（精简Debian）等基础镜像的变体
• 工具预装：内置npm（Node.js包管理器），部分标签包含yarn，无需额外安装
• 环境配置：支持通过环境变量自定义运行参数（如NODE_ENV、PORT）
• 安全优化：定期更新基础镜像和Node.js版本，修复已知安全漏洞
• 跨平台兼容：支持Linux/amd64、Linux/arm64等主流架构

使用场景与适用范围

• 开发环境：本地开发Node.js应用，通过卷挂载实现代码热重载
• CI/CD流程：在持续集成/部署中作为构建、测试环境，确保环境一致性
• 生产部署：部署Node.js应用到容器化平台（如Kubernetes、Docker Swarm）
• 微服务架构：作为Node.js微服务的基础镜像，构建分布式应用
• 教学与演示：快速搭建一致的Node.js学习或演示环境

使用方法与配置说明

基本使用（docker run）

查看Node.js版本

bash
docker run --rm node:lts node -v
# 输出示例：v20.10.0

运行交互式终端

bash
docker run -it --rm node:lts /bin/bash

运行本地Node.js脚本

bash
# 将当前目录挂载到容器内/app，执行app.js
docker run --rm -v "$PWD":/app -w /app node:lts node app.js

Dockerfile示例（构建自定义应用镜像）

dockerfile
# 使用Node.js 20 LTS Alpine镜像（轻量级生产环境）
FROM node:20-alpine

# 设置工作目录
WORKDIR /app

# 复制依赖文件（优先复制以利用Docker缓存）
COPY package*.json ./

# 安装生产依赖（NODE_ENV=production时仅安装生产依赖）
RUN npm install --production

# 复制应用代码
COPY . .

# 配置环境变量
ENV NODE_ENV=production  # 区分开发/生产环境
ENV PORT=3000            # 应用监听端口

# 暴露端口
EXPOSE 3000

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

docker-compose配置示例（多服务部署）

yaml
version: '3.8'

services:
  node-app:
    build: .  # 基于当前目录Dockerfile构建
    image: my-node-app:latest
    container_name: node-app
    restart: always  # 异常退出后自动重启
    ports:
      - "3000:3000"  # 端口映射（主机:容器）
    environment:
      - NODE_ENV=production
      - PORT=3000
      - DB_CONN_STR=mongodb://db:27017/myapp  # 连接数据库
    volumes:
      - app-logs:/app/logs  # 挂载日志目录
    depends_on:
      - db  # 依赖数据库服务

  db:
    image: mongo:latest
    container_name: mongo-db
    ports:
      - "27017:27017"
    volumes:
      - mongo-data:/data/db  # 持久化数据库数据

volumes:
  app-logs:
  mongo-data:

环境变量说明

镜像标签说明

Node.js镜像标签格式及含义：

注意：生产环境建议使用具体版本标签（如node:20.10.0-alpine），避免因版本自动更新导致兼容性问题。

最佳实践

• 生产环境优化：优先选择Alpine或Slim变体，减少镜像体积和***面
• 依赖管理：通过.dockerignore排除node_modules、.git等无关文件，仅复制必要代码
• 环境隔离：设置NODE_ENV=production以启用Node.js生产模式（如禁用调试功能）
• 数据持久化：通过卷（Volumes）挂载日志、配置等需要持久化的数据，避免容器删除后数据丢失
• 安全加固：非root用户运行容器（通过USER指令），限制容器权限
• 版本锁定：使用具体版本标签（如node:20.10.0-alpine），避免自动升级导致的兼容性问题

注意事项

• 开发环境可通过-v "$PWD:/app"挂载本地代码目录实现热重载，但生产环境应将代码复制到镜像内
• 安装依赖时，生产环境建议使用npm install --production或设置NODE_ENV=production以减少依赖体积
• 定期更新镜像以获取Node.js安全补丁和基础镜像更新，可通过CI/CD工具自动检测更新