maxird/server-info

Node服务器状态导出工具镜像

镜像概述

本镜像为基于Node.js的应用程序镜像，主要功能是实时获取、导出并展示服务器核心状态信息（如CPU使用率、内存占用、磁盘空间、网络连接等）。通过轻量级设计和简单配置，帮助用户快速实现服务器状态监控与记录。

核心功能与特性

• 全面的状态数据收集：支持获取CPU使用率、内存占用、磁盘空间、网络I/O、进程列表等核心服务器状态数据
• 多格式数据导出：支持JSON、文本、HTML等多种数据格式导出，满足不同场景需求
• 灵活的导出配置：可自定义数据采集间隔、导出范围及输出方式（HTTP接口/文件存储）
• 轻量级设计：基于Node.js精简版基础镜像，资源占用低，启动速度快
• 即开即用：无需复杂依赖配置，支持一键部署运行

使用场景

• 服务器实时监控：部署于生产/测试环境，通过HTTP接口实时查看服务器运行状态
• 系统状态记录：定期导出状态数据至文件，用于系统日志分析和历史状态回溯
• 开发调试辅助：在应用开发过程中，快速获取服务器环境状态，辅助定位与环境相关的问题
• 自动化运维集成：作为监控系统的数据源，为自动化运维平台提供服务器状态数据

使用方法与配置说明

基本部署（docker run）

通过以下命令快速启动容器，默认配置下可通过HTTP接口访问服务器状态：

bash
docker run -d \
  -p 3000:3000 \
  --name server-state-exporter \
  --restart always \
  node-app-dump-server-state

环境变量配置

支持通过环境变量自定义应用行为，常用配置如下：

示例：自定义采集间隔和导出格式

bash
docker run -d \
  -p 3000:3000 \
  -e EXPORT_INTERVAL=30 \
  -e EXPORT_FORMAT=html \
  -e OUTPUT_PATH=/data/state \
  -v /host/data:/data/state \
  --name server-state-exporter \
  node-app-dump-server-state

访问状态信息

HTTP接口访问

默认通过容器3000端口提供HTTP接口，访问路径：

• http://<容器IP>:3000/state：获取当前服务器状态数据（格式由EXPORT_FORMAT指定）
• http://<容器IP>:3000/history：获取历史状态记录（最多MAX_HISTORY条）

文件输出访问

若配置了OUTPUT_PATH，状态数据将定期保存至指定路径，文件名格式为state-<时间戳>.<format>（如state-1620000000.json）。

docker-compose配置示例

创建docker-compose.yml文件，简化部署流程：

yaml
version: '3'
services:
  server-state-exporter:
    image: node-app-dump-server-state
    container_name: server-state-exporter
    ports:
      - "3000:3000"
    environment:
      - PORT=3000
      - EXPORT_INTERVAL=30
      - EXPORT_FORMAT=json
      - OUTPUT_PATH=/data/state
      - MAX_HISTORY=20
    volumes:
      - ./state-data:/data/state
    restart: always

启动命令：docker-compose up -d

注意事项

• 容器需具备足够权限以获取服务器状态数据（部分系统信息可能需要--privileged权限，视宿主系统而定）
• 若通过文件导出状态数据，建议挂载宿主机目录（如示例中的-v ./state-data:/data/state），避免数据丢失
• 高频率采集（如EXPORT_INTERVAL<10秒）可能轻微增加服务器资源占用，建议根据实际需求调整采集间隔