crowdarchitects/node-dev-backend Docker 镜像 - 轩辕镜像

Node.js后端开发环境镜像

镜像概述

本镜像为后端开发提供一站式Node.js开发环境，集成Node.js运行时、npm/yarn包管理器及常用开发工具，旨在简化后端应用的开发、测试与调试流程，确保团队开发环境一致性，提升开发效率。

核心功能与特性

• 预配置开发环境：内置Node.js运行时（支持版本指定）、npm及yarn包管理器，无需手动安装基础依赖
• 开发工具集成：包含nodemon（代码热重载）、eslint（代码质量检查）、jest（单元测试）等常用开发工具
• 多版本支持：可通过环境变量灵活指定Node.js版本，适应不同项目需求
• 灵活定制：支持挂载本地项目目录与配置文件，保留个性化开发设置
• 轻量级设计：基于官方Node.js镜像优化，体积小巧，启动快速

使用场景

• 后端Node.js应用开发（如Express、NestJS、Koa等框架项目）
• 团队协作时统一开发环境，避免"环境不一致"问题
• 临时开发或测试环境快速搭建
• 学习Node.js后端开发的沙箱环境

使用方法

基础使用（docker run）

通过以下命令启动容器，将本地项目目录挂载到容器内进行开发：

bash
docker run -it --rm \
  -v $(pwd):/app \
  -p 3000:3000 \
  -e NODE_VERSION=18 \
  -e NPM_REGISTRY=[***] \
  node-backend-dev-env

参数说明：

• -v $(pwd):/app：将当前目录（本地项目）挂载到容器内/app目录
• -p 3000:3000：映射容器3000端口到本地，用于访问应用
• -e NODE_VERSION=18：指定Node.js版本（可选，默认使用最新LTS版本）
• -e NPM_REGISTRY：设置npm镜像源（可选，加速依赖安装）

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  node-dev:
    image: node-backend-dev-env
    volumes:
      - ./:/app
    ports:
      - "3000:3000"
    environment:
      - NODE_VERSION=18
      - NPM_REGISTRY=[***]
      - WORKDIR=/app
    command: npm run dev

启动容器：

bash
docker-compose up

自定义配置

1. 指定Node.js版本：通过NODE_VERSION环境变量设置，如NODE_VERSION=16或NODE_VERSION=20
2. 修改工作目录：通过WORKDIR环境变量指定容器内工作目录，默认/app
3. 安装额外依赖：进入容器后执行npm install <package>或在项目package.json中声明依赖
4. 配置开发工具：挂载本地配置文件（如.eslintrc.js、jest.config.js）到容器内对应目录

环境变量说明

注意事项

• 本地项目目录需包含package.json文件，以便容器内安装依赖
• 热重载功能依赖nodemon，需在package.json中配置"dev": "nodemon index.js"等启动脚本
• 生产环境请勿使用此镜像，建议基于官方Node.js镜像构建生产镜像