Cookielab Node.js 镜像文档

镜像概述和主要用途

本镜像基于 Cookielab Alpine Linux 镜像 构建，提供四个不同功能的子镜像，专为 Node.js 应用的开发、构建和运行设计，满足从基础运行环境到复杂前端构建的全流程需求。

核心功能和特性

1. cookielab/nodejs:server-<version>

• 基础镜像：*** Node.js Alpine 镜像（通过多阶段构建精简）
• 核心功能：最小化运行环境，仅包含 Node.js 运行时
• 特性：体积小巧，适合生产环境部署 Node.js 应用

2. cookielab/nodejs:build-<version>

• 基础镜像：cookielab/nodejs:server-<version>
• 核心功能：应用构建环境
• 包含工具：yarn、npm、python（用于 Gym 依赖）、git
• 特性：支持 Node.js 应用的依赖安装和构建流程

3. cookielab/nodejs:corepack-<version>

• 基础镜像：cookielab/nodejs:server-<version>
• 核心功能：集成 Corepack 的构建环境
• 包含工具：corepack、git
• 构建逻辑：通过传递 corepack-<version> 标签触发构建，默认基于 Node.js 20.12.2 构建
• 特性：支持使用 Corepack 管理包管理器（如 Yarn、pnpm）

4. cookielab/nodejs:build-<version>

• 基础镜像：cookielab/nodejs:server-<version>
• 核心功能：应用构建环境
• 包含工具：yarn、npm、python（用于 Gym 依赖）、git
• 特性：支持 Node.js 应用的依赖安装和构建流程

5. cookielab/nodejs:corepack-<version>

• 基础镜像：cookielab/nodejs:server-<version>
• 核心功能：集成 Corepack 的构建环境
• 包含工具：corepack、git
• 构建逻辑：通过传递 corepack-<version> 标签触发构建，默认基于 Node.js 20.12.2 构建
• 特性：支持使用 Corepack 管理包管理器（如 Yarn、pnpm）

6. cookielab/nodejs:<version>

• 基础镜像：cookielab/nodejs:build-<version>
• 核心功能：前端构建专用环境
• 包含工具：除继承 build-<version> 的工具外，还包含图像优化、前端资源处理等所需的额外库

版本控制

Node.js 版本通过 Git 标签控制，创建标签后自动应用于所有子镜像。

标签规则及构建示例

bash
# 构建 Node.js 20.12.2 系列镜像（server/build/frontend）
git tag 20.12.2-1 && git push origin 20.12.2

# 构建 Node.js 18.16.0 系列镜像
git tag 18.16.0-1 && git push origin 18.16.0

# 构建特定版本的 corepack 镜像（默认基于 Node.js 20.12.2）
git tag corepack-0.33.0 && git push origin corepack-0.33.0

使用方法和配置说明

基本注意事项

• 镜像无 latest 标签，必须指定具体版本（如 20.12.2）
• Entrypoint 默认为 shell，无需手动覆盖

Dockerfile 示例

dockerfile
# 使用 frontend 构建镜像（适用于前端应用构建）
FROM cookielab/nodejs:20.12.2

# 复制应用代码
COPY . /app
WORKDIR /app

# 安装依赖并构建
RUN yarn install && yarn build

# 切换非 root 用户运行（增强安全性）
USER 1987

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

使用场景和适用范围

提示：根据应用类型选择对应镜像，避免引入不必要依赖（如前端构建无需使用 server 镜像，运行环境无需使用 build 镜像）。