desmart/node

NodeJS 镜像文档

镜像概述

本镜像基于Ubuntu 20.04 (focal)构建，提供安全的NodeJS运行环境，集成了npm、yarn包管理工具，以及nodemon开发热重载工具和pm2生产进程管理工具，满足NodeJS应用从开发、测试到生产部署的全流程需求。

核心功能与特性

• 基础环境：基于Ubuntu 20.04 LTS，提供稳定的系统底层支持
• NodeJS环境：包含安全配置的NodeJS运行时
• 包管理工具：集成npm和yarn，支持多种依赖管理方式
• 开发工具：内置nodemon，实现代码变更自动重启，提升开发效率
• 生产工具：集成pm2进程管理器，支持应用进程的启动、监控和负载均衡
• 安全性：基于官方Ubuntu镜像构建，遵循安全最佳实践

使用场景

• NodeJS应用的开发环境搭建
• NodeJS应用的测试环境部署
• NodeJS应用的生产环境运行与管理

使用方法

基本使用（开发模式）

使用nodemon启动应用，实现代码热重载：

bash
docker run -it --rm -v $(pwd):/app -w /app [镜像名称] nodemon app.js

生产环境使用

使用pm2启动应用，实现进程管理：

bash
docker run -d --name node-app -v $(pwd):/app -w /app [镜像名称] pm2 start app.js --name "my-app"

基本操作示例

1. 进入容器终端：

bash
docker run -it --rm [镜像名称] /bin/bash

2. 安装项目依赖：

bash
# 使用npm
npm install

# 或使用yarn
yarn install

3. 开发模式运行：

bash
nodemon your-app-entry.js

4. 生产模式运行：

bash
pm2 start your-app-entry.js --name "app-name"
pm2 save  # 保存当前进程列表
pm2 startup  # 设置开机自启

配置说明

• 工作目录：建议将应用代码挂载到/app目录，通过-w /app指定工作目录
• 端口映射：若应用需要对外提供服务，使用-p [主机端口]:[容器端口]映射端口
• 环境变量：可通过-e参数设置环境变量，如-e NODE_ENV=production指定生产环境

docker-compose示例

yaml
version: '3'
services:
  node-app:
    image: [镜像名称]
    volumes:
      - ./app:/app
    working_dir: /app
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
    command: pm2 start app.js --name "my-node-app" --no-daemon