anapsix/nodejs

NodeJS in a box

基于Alpine Linux 3.6的Docker镜像，内置NodeJS v6.10.3。

镜像概述和主要用途

该镜像为NodeJS应用提供轻量级运行环境，基于Alpine Linux 3.6构建，体积仅27MB，适合快速部署和资源受限场景。支持直接运行NodeJS项目或通过onbuild标签构建自定义镜像，满足不同部署需求。

核心功能和特性

• 轻量级：镜像体积仅27MB，资源占用低
• 基础环境：基于Alpine Linux 3.6，包含NodeJS v6.10.3
• 灵活部署：支持两种使用模式（直接运行和构建镜像）
• 依赖管理：支持通过配置文件管理系统依赖和构建依赖，优化镜像体积

使用场景和适用范围

适用于需要快速部署的NodeJS项目，尤其适合对镜像体积有严格要求的场景，如微服务架构、边缘计算或资源受限的服务器环境。

使用方法和配置说明

前提条件

假设当前目录下存在可解析依赖的./package.json文件，且包含正确的start脚本，确保npm install和npm start命令可正常执行。

方式一：不构建镜像直接运行

通过挂载当前项目目录，直接运行容器：

bash
docker run -it --rm \
  --name my-node-project \
  -p 5080:5080 \
  -v $(pwd):/app \
  anapsix/nodejs

注意：需根据server.js中的配置自定义EXPOSE端口。也可根据需要添加ENTRYPOINT、覆盖CMD或添加依赖。

方式二：使用onbuild标签构建镜像

创建Dockerfile：

dockerfile
FROM anapsix/nodejs:onbuild
EXPOSE 5080

依赖管理说明

• 永久系统依赖：如需安装Alpine Linux系统包（查看可用包），在项目根目录创建./deps.apk文件，每行填写一个包名。适用于latest和onbuild标签。

• 自定义操作：创建可执行脚本./deps.sh，用于执行自定义依赖安装或配置操作。

• 构建时依赖：对于仅需在构建阶段使用的依赖（如bson npm包编译需要的make和g++），在项目根目录创建./deps_build.apk文件，每行填写一个包名。这些包会在npm install前安装，完成后自动清理，以减小最终镜像体积。适用于onbuild标签（latest标签不会清理构建时依赖）。

标签说明

• latest：在docker run时解析依赖，执行npm install && npm start（若未覆盖CMD）。

• onbuild：在docker build时解析依赖，清理构建时依赖，docker run时仅执行npm start（若未覆盖CMD）。

TODO

• 添加./examples目录，提供使用示例。