medtrics/highcharts-export-server

Highcharts Node.js 导出服务器 Docker 镜像

镜像概述

本镜像为 Highcharts Node.js 导出服务器的 Docker 化部署版本，基于 Node.js 环境构建。该服务器能够将 Highcharts 图表配置（JSON 格式）转换为多种图像格式文件，无需依赖前端浏览器环境，适用于服务器端批量生成、自动化报表集成等场景。

核心功能与特性

支持的导出格式

• 光栅图像：PNG、JPEG
• 矢量图像：SVG
• 文档格式：PDF

调用方式

• 命令行模式：直接通过容器内命令行工具处理图表配置文件
• HTTP API 模式：启动 HTTP 服务，通过 RESTful API 接收图表配置并返回导出结果

其他特性

• 支持自定义字体、样式和主题
• 可配置请求超时时间与资源限制
• 支持图表动画效果渲染（需配置启用）
• 轻量级 Node.js 基础镜像，部署便捷

使用场景

1. 服务器端批量图表生成：定期生成业务数据可视化图表，用于报告存档
2. 动态报表系统集成：在后端服务中嵌入，根据用户请求实时生成个性化图表
3. 自动化文档构建：与 CI/CD 流程结合，自动生成包含最新数据图表的文档
4. 无前端环境的图表渲染：在纯后端服务或嵌入式系统中生成 Highcharts 图表

使用方法

基本运行方式

1. 命令行模式导出

通过容器命令行直接处理本地图表配置文件（需挂载主机目录）：

bash
# 将当前目录下的 chart-config.json 导出为 PNG 格式，输出到当前目录
docker run --rm -v $(pwd):/workdir highcharts/node-export-server \
  /bin/sh -c "highcharts-export-server --infile /workdir/chart-config.json --outfile /workdir/chart.png --type png"

2. HTTP API 模式运行

启动 HTTP 服务，通过 API 接口提供导出能力：

bash
# 启动服务并映射端口 7801 到主机
docker run -d -p 7801:7801 --name highcharts-export-server highcharts/node-export-server

服务启动后可通过以下 API 调用：

• POST /：提交图表配置（JSON 格式），返回导出文件
• GET /health：检查服务健康状态

API 请求示例（使用 curl）：

bash
curl -X POST http://localhost:7801 \
  -H "Content-Type: application/json" \
  -d '{
    "infile": {
      "title": { "text": "示例图表" },
      "series": [{ "data": [1, 3, 2] }]
    },
    "type": "png"
  }' --output chart.png

环境变量配置

Docker Compose 配置示例

yaml
version: '3'
services:
  highcharts-export:
    image: highcharts/node-export-server
    ports:
      - "7801:7801"
    environment:
      - PORT=7801
      - LOG_LEVEL=warn
      - TIMEOUT=60000
    volumes:
      - ./custom-fonts:/usr/share/fonts/custom  # 挂载自定义字体
    restart: unless-stopped

配置参数说明

命令行参数

HTTP API 请求参数（POST /）