yunnysunny/node-xtransit

Node.js 系列 Docker 镜像文档

镜像概述与主要用途

本系列镜像由 https://github.com/whyun-docker/node 维护，基于 Node.js 官方 LTS 版本构建，提供多样化的 Node.js 运行环境及监控解决方案。主要用途包括：提供基础 Node.js 运行环境、支持原生模块编译、集成性能监控客户端（xtransit）及部署监控平台服务（easy-monitor），满足 Node.js 应用开发、部署及性能监控全流程需求。

核心功能与特性

1. 基础镜像：yunnysunny/node

• 核心功能：提供纯净的 Node.js 运行环境，预装 yarn、pnpm 包管理器。
• 特性：默认配置阿里 npm 源，加速国内环境下的依赖安装；基于官方 18+ LTS 版本构建，确保稳定性与安全性。

2. 编译镜像：yunnysunny/node-compile

• 核心功能：基于 yunnysunny/node 扩展，提供原生 Node.js 模块（addon）编译环境。
• 特性：集成 gcc、make、python 等编译工具链，支持通过 node-gyp 编译原生依赖。

3. 监控客户端镜像：yunnysunny/node-xtransit

• 核心功能：基于 yunnysunny/node，集成 xtransit 客户端环境，对接 easy-monitor 监控平台。
• 特性：内置 xprofiler 性能分析插件，支持性能数据采集、错误日志分析、磁盘/内存占用监控；可通过环境变量灵活配置监控参数。

4. 监控平台镜像：yunnysunny/easy-monitor

• 核心功能：集成 easy-monitor 全家桶服务，包括 xprofiler-console（控制台）、xtransit-manager（管理服务）、xtransit-server（WebSocket 服务）。
• 特性：支持接收客户端上报的性能数据，提供可视化监控界面；依赖 MySQL 存储应用/用户数据，Redis 缓存临时数据，支持多服务端口自定义配置。

使用场景与适用范围

详细使用方法与配置说明

1. 基础镜像：yunnysunny/node

拉取镜像

bash
# 拉取指定版本（x.y.z 格式，如 18.18.0）
docker pull docker.xuanyuan.run/yunnysunny/node:18.18.0

# 拉取 x.y 版本（自动指向该系列最新补丁版本）
docker pull docker.xuanyuan.run/yunnysunny/node:18.18

# 拉取 x 主版本（自动指向该系列最新 LTS 版本）
docker pull docker.xuanyuan.run/yunnysunny/node:18

基础使用示例

bash
# 验证 Node.js 版本
docker run --rm -it docker.xuanyuan.run/yunnysunny/node:18 node -v

# 作为基础镜像构建应用（Dockerfile 示例）
FROM docker.xuanyuan.run/yunnysunny/node:18
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm install  # 自动使用阿里源加速
COPY . .
CMD ["node", "server.js"]

2. 编译镜像：yunnysunny/node-compile

拉取镜像

bash
docker pull docker.xuanyuan.run/yunnysunny/node-compile:18  # 版本规则同基础镜像

编译原生模块示例（Dockerfile）

dockerfile
FROM docker.xuanyuan.run/yunnysunny/node-compile:18
WORKDIR /app
COPY package.json ./
# 编译原生依赖（如 bcrypt）
RUN npm install bcrypt  # 自动调用 node-gyp 编译
COPY . .
CMD ["node", "app.js"]

3. 监控客户端镜像：yunnysunny/node-xtransit

环境变量配置

Docker 部署示例

1. 基础运行命令

bash
docker run -d \
  --name node-app-monitor \
  -e XTRANSIT_SERVER=ws://easy-monitor:9190 \
  -e EZM_APP_ID=app_123 \
  -e EZM_APP_SECRET=secret_456 \
  -e EZM_DISKS=/root,/data \
  -e EZM_ERRORS=/app/logs/error.log \
  -v /host/app:/app \
  -v /host/logs:/app/logs \
  docker.xuanyuan.run/yunnysunny/node-xtransit:18 \
  node /app/main.js

2. docker-compose 配置

yaml
version: '3'
services:
  node-app:
    image: docker.xuanyuan.run/yunnysunny/node-xtransit:18
    container_name: node-app-monitor
    environment:
      - XTRANSIT_SERVER=ws://easy-monitor:9190
      - EZM_APP_ID=app_123
      - EZM_APP_SECRET=secret_456
      - EZM_DISKS=/root,/data
      - EZM_ERRORS=/app/logs/error.log
      - EZM_LOG_DIR=/app/xprofiler-logs
    volumes:
      - ./app:/app
      - ./logs:/app/logs
      - ./xprofiler-logs:/app/xprofiler-logs
    command: node /app/main.js

4. 监控平台镜像：yunnysunny/easy-monitor

环境变量配置

Docker 部署示例（docker-compose）

yaml
version: '3'
services:
  # MySQL 数据库（用户/应用数据 + 日志数据）
  mysql:
    image: docker.xuanyuan.run/mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=monitor_root_pwd
      - MYSQL_DATABASE=xprofiler_console
      - MYSQL_USER=monitor_user
      - MYSQL_PASSWORD=monitor_pwd
    volumes:
      - mysql-data:/var/lib/mysql
    ports:
      - "3306:3306"
    restart: always

  # Redis 缓存服务
  redis:
    image: docker.xuanyuan.run/redis:6-alpine
    volumes:
      - redis-data:/data
    ports:
      - "6379:6379"
    restart: always

  # easy-monitor 监控平台
  easy-monitor:
    image: docker.xuanyuan.run/yunnysunny/easy-monitor:18
    depends_on:
      - mysql
      - redis
    environment:
      - CONSOLE_MYSQL_HOST=mysql
      - CONSOLE_MYSQL_PORT=3306
      - CONSOLE_MYSQL_USER=monitor_user
      - CONSOLE_MYSQL_PASSWORD=monitor_pwd
      - CONSOLE_MYSQL_DATABASE=xprofiler_console
      - LOGS_MYSQL_HOST=mysql
      - LOGS_MYSQL_PORT=3306
      - LOGS_MYSQL_USER=monitor_user
      - LOGS_MYSQL_PASSWORD=monitor_pwd
      - LOGS_MYSQL_DATABASE=xprofiler_logs
      - REDIS_SERVER=redis:6379
      - CONSOLE_BASE_URL=http://192.168.1.100:8443  # 替换为实际可访问地址
      - CONSOLE_PORT=8443
      - MANAGER_PORT=8543
      - WSS_PORT=9190
    ports:
      - "8443:8443"   # 控制台端口
      - "8543:8543"   # 管理服务端口
      - "9190:9190"   # WebSocket 端口
    volumes:
      - easy-monitor-logs:/app/logs
    restart: always

volumes:
  mysql-data:
  redis-data:
  easy-monitor-logs:

版本说明

• 版本号规则：采用 x.y.z 格式，推送时自动级联推送 x.y（ minor 版本）和 x（主版本）标签，例如推送 18.18.0 时，自动更新 18.18 和 18 标签指向该版本。
• Node.js 版本支持：仅支持 18+ LTS 版本，低于 18 的版本不提供推送。版本更新与官方 LTS 版本同步，确保兼容性与安全性。