paralect/pdf-service

paralect/pdf-service 镜像说明

镜像概述

本镜像为Paralect服务栈中的PDF服务后端，是基于Koa框架开发的轻量HTTP服务器，用于将HTML内容或目标URL转换为PDF文件。通过Docker容器运行可避免本地安装wkhtmltopdf依赖。

核心功能

1. 处理POST /pdf请求，支持两种生成方式：
   • 提供html字段：直接使用HTML代码生成PDF
   • 提供url字段：从指定网页URL抓取内容生成PDF（若同时提供两者，优先使用URL）
2. 支持传入wkhtmltopdfOptions配置选项（参考wkhtmltopdf npm包文档）

使用场景

• 自动化生成报表、合同等PDF文档
• 从网页内容生成PDF存档
• 集成到需要HTML转PDF功能的应用系统中

配置说明

镜像构建与运行

1. 构建镜像（在服务根目录执行）：

bash
docker build ./

2. 运行容器（映射主机3000端口到容器3000端口）：

bash
docker run -d -p 3000:3000 [镜像ID]

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '2'
services:
  pdf-service:
    image: paralect/pdf-service
    ports:
      - "4444:3000"

执行启动命令：

bash
docker-compose up -d

请求示例

通过Fetch API生成PDF（HTML方式）：

javascript
fetch('http://localhost:3000/pdf', {
  method: 'POST',
  body: JSON.stringify({
    wkhtmltopdfOptions: {},
    html: '<h1>测试PDF</h1>'
  }),
  headers: { 'Content-Type': 'application/json' },
  responseType: 'blob'
});

通过URL生成PDF：

javascript
fetch('http://localhost:3000/pdf', {
  method: 'POST',
  body: JSON.stringify({
    wkhtmltopdfOptions: {},
    url: "https://example.com"
  }),
  headers: { 'Content-Type': 'application/json' },
  responseType: 'blob'
});

已知问题

若请求中包含output选项，可能生成空白HTML（其他部分选项也可能存在类似问题）。