labun/pdf-generation-service

PDF生成服务

基于PhantomJS的PDF生成服务，封装自https://github.com/marcbachmann/node-html-pdf%E5%8C%85%EF%BC%8C%E6%8F%90%E4%BE%9BHTTP%E6%8E%A5%E5%8F%A3%E5%AE%9E%E7%8E%B0HTML%E5%88%B0PDF%E7%9A%84%E8%BD%AC%E6%8D%A2%E3%80%82

镜像概述

本镜像提供了一个轻量的PDF生成服务，通过POST请求接收HTML内容和配置参数，快速生成符合需求的PDF文件。支持Prometheus监控指标采集，可无缝集成到Docker和Kubernetes环境中。

核心功能

1. HTML转PDF：接收HTML内容（base64编码或原始文本）生成PDF文件
2. 自定义配置：支持设置PDF方向、边框、页脚等参数（参考node-html-pdf的options）
3. 监控支持：提供Prometheus metrics接口，统计请求次数及状态码
4. 容器化部署：支持Docker直接运行和Kubernetes集群部署

使用场景

• 生成报表、发票、合同等结构化文档
• 网页内容的PDF导出功能
• 自动化生成PDF格式的业务单据

配置说明

通过POST请求的config参数传入JSON格式的配置，支持的参数参考https://github.com/marcbachmann/node-html-pdf#options%EF%BC%8C%E4%BE%8B%E5%A6%82%EF%BC%9A

• orientation：PDF方向（landscape/portrait）
• border：页面边框设置（top/bottom/left/right）
• footer：页脚内容及高度设置

部署示例

Docker运行

bash
# 拉取镜像
docker pull labun/pdf-generation-service
# 启动服务（映射3000端口）
docker run -d -p 3000:3000 labun/pdf-generation-service

生成PDF示例

bash
# 将HTML文件编码为base64
HTML=$(base64 -w 0 your_html_file.html)
# 发送POST请求生成PDF
curl -o output.pdf -X POST -H "Content-Type: application/json" -d "{\"html\":\"$HTML\"}" http://localhost:3000/

Kubernetes部署

bash
# 应用部署文件（需提前准备deploy目录下的YAML文件）
kubectl apply -f ./deploy/

监控指标

访问http://localhost:3000/metrics获取Prometheus监控数据，包括请求总数、状态码分布等。