flywheel/node Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

flywheel-io/node 镜像文档

镜像概述

flywheel-io/node 是一个基于 Alpine Linux 的轻量级 Docker 镜像，集成了 Node.js、npm 包管理器及 Chromium 浏览器，专为前端开发与测试工作流设计。该镜像旨在提供一个统一、可移植的环境，简化前端项目的开发、构建与测试流程。

仓库地址：flywheel-io/docker/node

核心功能与特性

轻量级基础

• 基于 Alpine Linux 构建，镜像体积小，部署速度快，资源占用低。

完整开发工具链

• 集成 Node.js 运行时环境，支持 JavaScript/TypeScript 开发。
• 包含 npm 包管理器，用于依赖管理与项目构建。

浏览器测试支持

• 内置 Chromium 浏览器，支持需要浏览器环境的前端测试（如使用 Jest、Cypress、Playwright 等测试框架）。

兼容性与灵活性

• 兼容主流前端开发工具链，可无缝集成到现有开发流程中。
• 支持自定义配置，满足不同项目的特定需求。

使用场景与适用范围

• 前端开发环境：快速搭建包含 Node.js 和浏览器环境的开发环境，避免本地环境配置差异。
• 自动化测试：执行需要浏览器环境的前端测试用例，如端到端测试、组件测试等。
• CI/CD 集成：作为持续集成/持续部署流程中的构建或测试阶段环境，确保流程一致性。
• 轻量级部署：适用于资源受限环境下的前端项目开发与测试工作流。

使用方法与配置说明

基本使用

拉取镜像

bash
docker pull flywheel-io/node:latest

启动交互式终端

bash
docker run -it --rm flywheel-io/node:latest sh

运行 npm 命令（挂载项目目录）

将本地项目目录挂载到容器中，执行依赖安装或构建命令：

bash
docker run -it --rm -v $(pwd):/app -w /app flywheel-io/node:latest npm install
docker run -it --rm -v $(pwd):/app -w /app flywheel-io/node:latest npm run build

执行前端测试

利用内置 Chromium 运行测试命令（以 Jest 为例）：

bash
docker run -it --rm -v $(pwd):/app -w /app flywheel-io/node:latest npm test

Docker Compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  frontend-dev:
    image: flywheel-io/node:latest
    volumes:
      - ./:/app
    working_dir: /app
    command: npm run dev
    ports:
      - "3000:3000"  # 根据项目端口需求调整

启动服务：

bash
docker-compose up

注意事项

• 挂载本地目录时，确保文件权限正确，避免因权限问题导致操作失败。
• Chromium 运行可能需要特定配置（如禁用沙箱模式），可根据测试框架要求调整启动参数。
• 如需使用特定版本的 Node.js 或 Chromium，可查看镜像标签（如 flywheel-io/node:18-alpine）以获取对应版本。

参考与更多信息

• 镜像仓库：flywheel-io/docker/node
• 官方文档：请参考 GitLab 仓库中的详细说明，获取最新版本信息及高级配置指南。