zenith/node

zenith/node 镜像文档

镜像概述

zenith/node 是一个基于 Node.js 10 的 Docker 镜像，预安装了 Express 4 框架，旨在提供快速部署 Node.js Web 应用的基础环境。该镜像配置了 NPM 日志级别，并暴露 3000 端口，适用于开发和运行小型到中型的 Node.js Express 应用。

核心功能与特性

• 基础环境：基于官方 Node.js 10 镜像，提供稳定的 Node.js 运行环境
• 预安装依赖：已全局安装 Express 4 框架，无需手动安装核心 Web 框架
• 端口配置：默认暴露 3000 端口，便于 Web 服务访问
• NPM 配置：设置 NPM 日志级别为 info，平衡日志详细度与性能
• 生产环境支持：通过 docker-compose 配置可轻松设置生产环境变量

使用场景

• 快速开发和测试 Node.js Express Web 应用
• 部署小型 Web 服务或 API 接口
• 作为基础镜像构建更复杂的 Node.js 应用容器

使用方法

直接运行容器

通过 docker run 命令启动容器，需挂载本地应用代码目录：

bash
docker run -d \
  -p 80:3000 \
  -v /path/to/your/app:/home/node/app \
  -e NODE_ENV=production \
  --user node \
  --workdir /home/node/app \
  docker.xuanyuan.run/zenith/node \
  npm start

使用 docker-compose 部署

创建 docker-compose.yml 文件，配置如下：

yaml
version: '3'

services:
    node:
        image: docker.xuanyuan.run/zenith/node
        user: "node"
        working_dir: /home/node/app
        environment:
            - NODE_ENV=production  # 设置生产环境
        volumes:
            - ./:/home/node/app  # 挂载本地应用代码到容器内
        ports:
            - 80:3000  # 映射主机80端口到容器3000端口
        command: "npm start"  # 启动应用命令

启动服务：

bash
docker-compose up -d

应用代码结构示例

package.json

json
{
    "name": "socket-chat-example",
    "version": "0.0.1",
    "description": "my first socket.io app",
    "dependencies": {
        "express": "^4.17.1"  // 依赖Express框架（与镜像预装版本兼容）
    },
    "scripts": {
        "start": "node index.js"  // 启动脚本，需与docker-compose command匹配
    }
}

index.js（应用入口文件）

javascript
const app = require('express')();
const http = require('http').createServer(app);

// 定义根路由
app.get('/', (req, res) => {
  res.send('<h1>Hello world</h1>');
});

// 监听3000端口（需与镜像暴露端口一致）
http.listen(3000, () => {
  console.log('listening on *:3000');
});

配置说明

环境变量

端口映射

镜像默认暴露 3000 端口，建议在运行时通过 -p 参数映射到主机端口（如 80:3000）。

目录挂载

建议将本地应用代码目录挂载到容器内 /home/node/app 路径，确保容器能访问最新代码。