nethost/node

Node.js 最小化生产就绪容器基础镜像

镜像概述

本镜像专为Node.js应用设计，提供最小化体积与生产环境优化的容器基础。通过精简系统依赖、优化运行时配置，旨在帮助开发者构建轻量级、高性能且安全的生产环境容器，适用于各类Node.js服务的部署需求。

核心功能与特性

• 最小化体积：基于精简操作系统（如Alpine）构建，显著减少镜像大小，降低网络传输与存储成本
• 生产就绪：默认启用Node.js生产环境配置（如禁用开发依赖、优化垃圾回收），提升运行性能
• 安全加固：移除不必要的系统工具与权限，降低***面；默认使用非root用户运行应用
• 版本兼容：支持主流Node.js LTS版本，可通过标签选择特定版本（如18、20）
• 零冗余依赖：仅包含Node.js运行时核心组件，无额外开发工具，确保镜像纯净

适用场景

• 生产环境部署Node.js微服务、API服务或前端SSR应用
• 构建CI/CD流水线中的轻量级部署镜像
• 资源受限环境（如边缘计算、嵌入式系统）中的Node.js应用运行
• 对容器启动速度、镜像拉取时间有严格要求的场景

使用方法

基本运行示例

直接启动容器

bash
docker run -d --name node-app -p 3000:3000 -e NODE_ENV=production docker.xuanyuan.run/my-node-app:latest

注：my-node-app:latest为基于本镜像构建的应用镜像

Docker Compose配置

yaml
version: '3.8'
services:
  node-service:
    image: docker.xuanyuan.run/minimal-node-base:20  # 指定Node.js 20版本
    ports:
      - "8080:3000"  # 映射宿主机8080端口到容器3000端口
    environment:
      - NODE_ENV=production
      - PORT=3000
      - NODE_OPTIONS=--max-old-space-size=2048  # 配置内存限制
    restart: unless-stopped
    volumes:
      - ./app/logs:/app/logs  # 挂载日志目录（需应用支持）

构建自定义应用镜像

基础Dockerfile示例

dockerfile
# 选择基础镜像版本
FROM docker.xuanyuan.run/minimal-node-base:20-alpine

# 设置工作目录
WORKDIR /app

# 复制依赖文件并安装生产依赖
COPY package.json package-lock.json ./
RUN npm ci --only=production  # 仅安装生产依赖，加速构建

# 复制应用代码
COPY dist/ ./dist/  # 假设应用已构建到dist目录

# 暴露应用端口
EXPOSE 3000

# 启动命令
CMD ["node", "dist/server.js"]

构建与运行

bash
# 构建自定义镜像
docker build -t my-node-service:1.0 .

# 运行构建后的镜像
docker run -p 3000:3000 docker.xuanyuan.run/my-node-service:1.0

环境变量配置

注意事项

• 依赖补充：精简版镜像不含git、python等系统工具，如需构建原生模块（如bcrypt），需在Dockerfile中手动安装依赖（例：RUN apk add --no-cache python3 make g++）
• 用户权限：默认使用非root用户node（UID 1000），需确保应用目录权限正确（可通过RUN chown -R node:node /app调整）
• 健康检查：建议在生产环境添加健康检查配置（如HEALTHCHECK --interval=30s --timeout=3s CMD wget -qO- http://localhost:3000/health || exit 1）
• 版本锁定：生产环境建议使用具体版本标签（如20.10.0-alpine）而非latest，避免版本变更风险

版本标签说明

镜像标签遵循[node版本]-[基础系统]格式，例如：

• 20-alpine：Node.js 20.x + Alpine Linux
• 18-bullseye-slim：Node.js 18.x + Debian Bullseye Slim
• lts-alpine：最新LTS版本 + Alpine Linux
• latest：最新稳定版（不建议生产环境使用）