kouleen/node repository overview

⁠🚀 kouleen/node - 轻量级 Alpine 版 Node.js 镜像

⁠镜像简介

kouleen/node 是基于 Alpine Linux 构建的超轻量、稳定、生产可用 Node.js 容器镜像。 专为前端/Node.js 项目打造，体积小巧、启动快速，支持多 LTS 版本，内置国内源优化，开箱即用，适合开发、构建、生产全场景。

⁠核心特性

✅ 超小体积：Alpine 精简构建，比官方镜像小 50%+

✅ 多 LTS 版本支持：8 / 14 / 18 等长期支持版，精准版本控制

✅ 国内源优化：内置 npm 国内镜像，依赖下载飞速

✅ 生产级稳定：无魔改、无后门、完全兼容官方 Node.js

✅ 时区/编码优化：默认北京时间、UTF-8 中文无乱码

✅ 持续维护：同步官方安全补丁，稳定可靠

✅ 全场景适配：前端构建、Node 服务、CI/CD 流水线通用

⁠支持版本（精准标签）

⁠快速使用（按版本选择）

⁠1. 版本验证（测试镜像可用性）

# 验证 Node 8
docker run -it --rm kouleen/node:8-alpine node -v

# 验证 Node 14
docker run -it --rm kouleen/node:14-alpine node -v

# 验证 Node 18
docker run -it --rm kouleen/node:18-alpine node -v

⁠2. 前端项目构建（推荐 18-alpine）

进入你的前端项目目录（Vue/React/Angular），执行一键构建：

docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  kouleen/node:18-alpine \
  sh -c "npm install && npm run build"

⁠3. 运行 Node.js 服务（生产推荐）

docker run -d \
  --name node-app \
  --restart always \
  -p 3000:3000 \
  -v $(pwd):/app \
  -w /app \
  kouleen/node:18-alpine \
  node app.js

⁠4. 作为基础镜像构建 Dockerfile

# 构建阶段（用 Node 18 打包前端）
FROM kouleen/node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build

# 运行阶段（用 Nginx 部署静态资源，可搭配 kouleen/nginx）
FROM kouleen/nginx:latest
COPY --from=builder /app/dist /usr/share/nginx/html

⁠环境信息

• 系统：Alpine Linux（轻量、安全）
• 编码：UTF-8，中文无乱码
• 时区：Asia/Shanghai（北京时间）
• npm/yarn：对应 Node 版本的官方稳定版
• 默认源：已配置国内 npm 镜像，加速依赖下载
• 工作目录：/app

⁠常用管理命令

# 查看 Node 版本
docker run -it --rm kouleen/node:18-alpine node -v

# 查看 npm 版本
docker run -it --rm kouleen/node:18-alpine npm -v

# 进入容器交互式环境
docker run -it --rm kouleen/node:18-alpine sh

# 运行本地 Node 脚本
docker run -it --rm -v $(pwd):/app -w /app kouleen/node:18-alpine node script.js

⁠适用场景

• 前端项目（Vue/React/Angular）构建打包
• Node.js 后端服务、API 接口部署
• 遗留 Node 8/14 项目容器化迁移
• CI/CD 自动化构建流水线
• 开发/测试/生产环境统一 Node 环境
• 低资源服务器部署 Node 服务

⁠版本选择指南

⁠常见问题

⁠Q1：为什么选择 kouleen/node 而不是官方镜像？

基于 Alpine 构建，体积更小、启动更快，内置国内源优化，国内使用体验更好，完全兼容官方功能。

⁠Q2：不同版本可以同时使用吗？

完全可以，通过标签区分，互不干扰，适合多版本项目并行开发。

⁠Q3：支持 npm/yarn/pnpm 吗？

支持，所有 Node 版本均内置对应版本的 npm，可自行安装 yarn/pnpm。

⁠Q4：可以用于公网生产环境吗？

完全可以，无后门、无数据收集，稳定安全，适合生产部署。

⁠作者信息

🐳 Docker Hub: kouleen⁠ 📦 镜像地址: kouleen/node⁠

⁠💡 觉得好用？欢迎点个 ⭐ Star 支持一下！

直接全选复制，粘贴到 Docker Hub 仓库的 Full Description 里即可，精准对应你现有的 3 个版本标签，专业完整！