hellocomet/base-node

镜像概述

本镜像为基于Alpine Linux的Node.js基础容器，旨在提供轻量级、高效的Node.js运行环境。Alpine Linux的精简特性使镜像体积显著小于基于其他Linux发行版的Node.js镜像，同时保持基本的Node.js功能完整性，适合资源受限环境或对镜像体积有严格要求的场景。

核心功能与特性

1. Alpine Linux基础

• 基于Alpine Linux构建，镜像体积小（通常仅数十MB），启动速度快
• 继承Alpine的安全性优势，默认包含较少不必要组件，降低***面

2. Node.js运行环境

• 预安装Node.js及npm（或yarn，依版本而定），支持标准Node.js应用运行
• 保持与官方Node.js版本的兼容性，可通过标签指定具体Node.js版本

3. 轻量级设计

• 精简系统依赖，仅保留Node.js运行必需组件
• 支持通过npm/yarn安装额外依赖，扩展功能

使用场景

• 开发环境快速搭建：本地开发时快速获取Node.js环境，避免系统级Node.js版本冲突
• 小型Node.js应用部署：适用于轻量级API服务、脚本任务等资源需求低的应用
• CI/CD流程集成：作为构建或测试环节的基础容器，减少流程资源消耗
• 边缘设备部署：在资源受限的边缘计算环境中运行Node.js应用

使用方法与配置说明

基本使用（交互式运行）

通过以下命令启动容器并进入交互式Node.js环境：

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

• -it：启用交互式终端
• --rm：容器退出后自动删除，避免残留

运行本地Node.js脚本

挂载本地目录并运行指定脚本：

bash
# 假设本地脚本路径为 ./app.js
docker run -it --rm -v $(pwd):/app -w /app [镜像名称] node app.js

• -v $(pwd):/app：将当前目录挂载到容器内/app目录
• -w /app：设置容器工作目录为/app

安装依赖与构建应用

在容器内通过npm安装依赖并运行构建命令：

bash
docker run -it --rm -v $(pwd):/app -w /app [镜像名称] sh -c "npm install && npm run build"

常用环境变量

版本选择

通过镜像标签指定Node.js版本（若支持多版本标签），例如：

bash
docker run -it --rm [镜像名称]:18-alpine node -v  # 使用Node.js 18版本

注意事项

• 由于Alpine Linux使用musl libc，部分依赖于glibc的Node.js模块可能需要额外配置（可通过npm install --force或安装libc6-compat包解决）
• 生产环境建议指定具体版本标签，避免因镜像更新导致兼容性问题