hasitha2kandy/html-to-pdf-converter

puppeteer_html-to-pdf

镜像概述和主要用途

puppeteer_html-to-pdf是一个基于Node Express.js构建的API服务镜像，通过Puppeteer实现HTML文档到PDF文件的转换功能。该镜像提供简单易用的HTTP接口，允许用户通过POST请求传递HTML内容及配置参数，快速生成PDF文件。

核心功能和特性

• 简单API接口：基于Express.js构建，提供直观的HTTP接口
• HTML转PDF：使用Puppeteer处理HTML渲染并生成高质量PDF
• 可配置参数：支持设置纸张格式、打印方向等PDF生成参数
• 轻量部署：可通过Docker容器快速部署，也支持传统Node.js环境运行

使用场景和适用范围

• 动态生成PDF报告或文档
• 网页内容导出为PDF格式
• 需要将HTML模板转换为PDF的应用集成
• 快速搭建HTML到PDF转换服务的开发或生产环境

使用方法和配置说明

Docker构建与运行

构建镜像

bash
docker build . -t export_html_to_pdf

运行容器

bash
docker run -itd --name export_html_to_pdf -p 80:80 export_html_to_pdf

• 参数说明：
  • -itd：以交互模式在后台运行容器
  • --name export_html_to_pdf：指定容器名称
  • -p 80:80：将容器的80端口映射到主机的80端口

普通方式构建与运行

项目构建

bash
npm install

运行项目

bash
node index.js

• 默认运行在80端口

API使用方法

请求端点

POST http://localhost:80/api/generate/pdf

请求头

Content-Type: application/json

请求体参数

使用示例

使用curl

bash
curl --location --request POST 'http://localhost:80/api/generate/pdf' \
--header 'Content-Type: application/json' \
--data-raw '{
    "Html": "<h1>Your pdf html string comes here</h1>"
}'

使用HTTP请求

http
POST /api/generate/pdf HTTP/1.1
Host: localhost:80
Content-Type: application/json
Content-Length: 68

{
    "Html": "<h1>Your pdf html string comes here</h1>",
    "Format": "A4",
    "Orientation":"Portrait"
}