biescloudtechsupport/node

Node.js 2.20.0 Slim 基础镜像文档

镜像概述

本镜像基于 Node.js 2.20.0 的 slim 版本构建，专为支持使用 NEXT.JS 框架和 HeroUI 组件库的前端项目设计。Slim 版本特性确保镜像体积更小、资源占用更低，适合开发环境和生产环境部署。

核心功能与特性

• 基础环境：基于 Node.js 2.20.0 slim，包含运行 NEXT.JS 应用所需的核心依赖
• 轻量级设计：采用 slim 镜像变体，减少不必要的系统组件，降低镜像体积和运行时资源消耗
• 框架支持：原生兼容 NEXT.JS 框架的开发与运行需求
• 组件库兼容：适配 HeroUI 组件库的使用场景，确保样式和交互功能正常加载

使用场景与适用范围

• 开发阶段：作为本地开发环境，支持 NEXT.JS + HeroUI 项目的热重载和调试
• 构建阶段：用于项目打包构建，生成优化后的静态资源或服务端渲染产物
• 生产部署：作为轻量级运行环境，部署基于 NEXT.JS 和 HeroUI 开发的前端应用

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name nextjs-heroui-app \
  -p 3000:3000 \
  -v $(pwd):/app \
  -w /app \
  [镜像名称] \
  npm run dev

参数说明：

• -p 3000:3000：映射容器内 NEXT.JS 默认开发端口到宿主机
• -v $(pwd):/app：将本地项目目录挂载到容器内 /app 路径
• -w /app：设置工作目录为 /app
• npm run dev：启动 NEXT.JS 开发服务器

Docker Compose 配置示例

yaml
version: '3'
services:
  nextjs-app:
    image: [镜像名称]
    ports:
      - "3000:3000"
    volumes:
      - ./:/app
    working_dir: /app
    command: npm run dev
    environment:
      - NODE_ENV=development

环境变量配置

可通过环境变量调整运行参数，常用变量包括：

• NODE_ENV：设置运行环境（development/production），默认值为 development
• PORT：指定应用运行端口，默认值为 3000

注意事项

• 确保本地项目已安装 NEXT.JS 和 HeroUI 依赖（通过 package.json 声明）
• 生产环境建议使用 npm run build 构建后，以 npm start 命令启动应用
• 如需自定义 Node.js 配置，可通过挂载 node_modules 或修改容器内配置文件实现