iron/node 镜像文档

镜像概述和主要用途

iron/node 是一个轻量级的Node.js运行环境镜像，基于精简的基础架构构建，旨在提供小巧、高效的Node.js应用运行环境。该镜像专注于减小体积并保持Node.js运行所需的核心功能，适用于需要快速部署、资源占用低的Node.js应用场景。

核心功能和特性

轻量级设计

• 基于精简基础镜像构建，相比官方标准Node.js镜像体积显著减小，降低存储和网络传输成本
• 移除不必要的系统组件和依赖，仅保留Node.js运行核心依赖

高效运行环境

• 提供完整的Node.js运行时环境，支持标准Node.js API和功能
• 优化启动速度，适合快速部署和扩展

兼容性与安全性

• 兼容主流Node.js应用，支持npm包管理
• 精简的系统组件减少潜在安全漏洞，提升运行环境安全性

使用场景和适用范围

• 小型Node.js应用部署：适用于轻量级API服务、工具脚本等小型Node.js应用
• 微服务架构：作为微服务组件运行环境，减少服务资源占用
• CI/CD流程：用于自动化构建、测试环节，提供一致的Node.js环境
• 资源受限环境：在边缘计算、嵌入式设备等资源有限场景中部署Node.js应用

使用方法和配置说明

基本使用示例

查看Node.js版本

docker run --rm iron/node node -v

运行简单Node.js脚本

创建测试脚本 app.js：

console.log('Hello from iron/node!');

运行脚本：

docker run --rm -v $(pwd):/app -w /app iron/node node app.js

运行包含npm依赖的应用

在应用目录中（需包含 package.json）：

# 安装依赖（可挂载本地目录持久化依赖）
docker run --rm -v $(pwd):/app -w /app iron/node npm install

# 启动应用（假设package.json中定义了start脚本）
docker run --rm -v $(pwd):/app -w /app iron/node npm start

端口映射

若应用需要对外提供服务（如Web应用），需映射端口：

# 假设应用监听3000端口
docker run --rm -p 3000:3000 -v $(pwd):/app -w /app iron/node node server.js

环境变量配置

通过 -e 参数设置环境变量：

docker run --rm -e NODE_ENV=production -v $(pwd):/app -w /app iron/node node app.js

持久化数据

使用数据卷挂载应用数据目录：

docker run --rm -v $(pwd):/app -v node_data:/app/data -w /app iron/node node app.js

（node_data 为命名卷，用于持久化应用数据）

注意事项

• 该镜像为精简版本，可能不包含部分系统工具，复杂依赖场景建议先测试兼容性
• 生产环境使用时，建议结合应用需求评估资源配置（如内存、CPU限制）
• 如需自定义构建，可基于该镜像通过Dockerfile添加必要依赖

进阶配置

可通过Dockerfile基于iron/node构建自定义镜像：

FROM iron/node

# 添加额外系统依赖（如需）
RUN apk add --no-cache some-package

# 设置工作目录
WORKDIR /app

# 复制应用代码
COPY . .

# 安装依赖
RUN npm install --production

# 暴露端口
EXPOSE 3000

# 启动命令
CMD ["npm", "start"]

构建并运行自定义镜像：

docker build -t my-node-app .
docker run --rm -p 3000:3000 my-node-app