eidolons/node

Node.js 镜像文档

镜像概述

Node.js镜像是基于JavaScript的运行时环境，允许在服务器端执行JavaScript代码。它构建在Chrome的V8 JavaScript引擎之上，提供了一个高效、轻量的平台，适用于开发各种服务器端应用和网络服务。

核心功能和特性

• 非阻塞I/O模型：采用事件驱动架构，能够高效处理并发请求，适合构建高性能网络应用
• 跨平台支持：可在Windows、Linux、macOS等多种操作系统上运行
• 丰富的生态系统：通过npm（Node Package Manager）提供海量第三方库和工具
• 统一的开发语言：前后端均使用JavaScript，降低开发复杂度
• 内置API：提供文件系统、网络、加密等核心模块，无需额外依赖

使用场景和适用范围

• 服务器端API开发：构建RESTful API、GraphQL服务等
• 实时通信应用：开发聊天应用、实时协作工具（基于WebSocket）
• 微服务架构：作为微服务节点，处理特定业务逻辑
• 命令行工具开发：构建自动化脚本和开发工具
• 前端构建工具：支持Webpack、Babel等前端工程化工具运行

使用方法和配置说明

基本使用（docker run）

bash
# 运行Node.js交互式终端
docker run -it --rm node:latest node

# 运行本地Node.js应用
docker run -it --rm -v "$(pwd)":/app -w /app node:latest node app.js

构建并运行应用示例

1. 创建简单Node.js应用（app.js）：

javascript
const http = require('http');
const port = process.env.PORT || 3000;

const server = http.createServer((req, res) => {
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain');
  res.end('Hello World from Node.js Docker container!\n');
});

server.listen(port, () => {
  console.log(`Server running on port ${port}`);
});

2. 运行容器并映射端口：

bash
docker run -d -p 3000:3000 -v "$(pwd)":/app -w /app --name node-app node:latest node app.js

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  node-app:
    image: node:latest
    ports:
      - "3000:3000"
    volumes:
      - ./app:/app
    working_dir: /app
    environment:
      - NODE_ENV=production
      - PORT=3000
    command: node app.js

注意事项

• 生产环境建议使用特定版本标签（如node:20-alpine）而非latest，确保版本稳定性
• 使用Alpine版本（node:x.x-alpine）可显著减小镜像体积
• 敏感配置建议通过环境变量或Docker Secrets管理，避免硬编码在代码中