urbanmassage/node

轻量级Node Docker镜像

镜像概述

本镜像为精简版Node环境，旨在提供体积极小的Node运行时。与官方Node镜像（约200MB）相比，本镜像体积小于20MB，显著降低存储和传输成本，同时保持基础Node功能可用性。

核心功能与特性

1. 极致精简体积

• 镜像体积小于20MB，仅为官方Node镜像的1/10，大幅节省资源占用。

2. 原生模块兼容性

• 不直接支持原生模块（native modules）的在线构建，但可通过以下方式处理：
  • 在与目标运行环境相同架构的构建环境（推荐使用Ubuntu系统）中预先构建原生模块
  • 将构建完成的原生模块文件复制到镜像中，即可正常运行

3. 可靠构建保障

• 镜像通过CircleCI构建，非Dockerhub自动构建，可忽略Dockerhub页面显示的构建错误提示。

使用场景

• 对镜像体积敏感的应用部署（如边缘计算、资源受限环境）
• 轻量级Node服务（如API网关、简单后端服务）
• CI/CD流程中的临时Node环境（需快速拉取和启动）
• 嵌入式系统或容器化微服务中的Node依赖组件

使用方法与配置说明

基本使用

启动交互式Node环境

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

运行Node应用

将本地Node应用目录挂载到容器中：

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

处理原生模块

若应用依赖原生模块，需按以下步骤操作：

1. 预构建原生模块
   在与目标运行环境相同架构的Ubuntu系统中，进入项目目录执行：

   bash
   # 安装依赖并构建原生模块
   npm install
   

2. 复制构建产物到镜像
   通过Dockerfile将构建后的node_modules目录复制到镜像中：

   dockerfile
   FROM docker.xuanyuan.run/[镜像名称]
   WORKDIR /app
   COPY package.json package-lock.json ./
   COPY node_modules ./node_modules  # 复制预构建的依赖（含原生模块）
   COPY . .
   CMD ["node", "app.js"]
   

3. 构建并运行自定义镜像

   bash
   docker build -t my-node-app .
   docker run docker.xuanyuan.run/my-node-app
   

注意事项

• 原生模块限制：镜像本身不含构建工具链，无法直接执行npm install安装含原生模块的依赖，必须预先在外部构建。
• 构建环境说明：镜像构建基于CircleCI，Dockerhub页面显示的构建错误为非实际运行问题，可忽略。
• 架构兼容性：原生模块需与目标容器运行架构一致，建议构建环境与部署环境架构统一（如均为x86_64或arm64）。