philiplehmann/pdftk

pdftk node包装器 Docker镜像

概述

该Docker镜像是pdftk的Node.js包装器，提供HTTP API接口用于处理PDF文件，支持加密、解密、压缩、解压缩、表单数据提取及表单填充等操作，便于通过网络请求快速处理PDF文档。

核心功能

• PDF加密与解密
• PDF压缩与解压缩
• 提取PDF表单字段（JSON格式）
• 提取PDF文件信息（JSON格式）
• 提取PDF表单字段（FDF格式）
• 填充PDF表单

使用场景

适用于需要通过API接口处理PDF文件的场景，如Web应用后端服务、自动化文档处理流程、批量PDF处理系统等。

使用方法

运行镜像

bash
docker run -p 3000:3000 --rm --name pdftk philiplehmann/pdftk:latest

说明：-p 3000:3000映射容器3000端口到宿主机，--rm容器退出后自动删除，--name指定容器名称

压缩PDF文件

bash
curl -X POST \
  -H 'content-type: application/x-www-form-urlencoded' \
  --data-binary "@path/to/my/uncompressed.pdf" \
  'http://localhost:3000/compress'

说明：将本地未压缩的PDF文件发送至API，返回压缩后的PDF文件

解压缩PDF文件

bash
curl -X POST \
  -H 'content-type: application/x-www-form-urlencoded' \
  --data-binary "@path/to/my/compressed.pdf" \
  'http://localhost:3000/uncompress'

说明：将本地压缩的PDF文件发送至API，返回解压缩后的PDF文件

加密PDF文件

bash
curl -X POST \
  -H 'content-type: application/x-www-form-urlencoded' \
  --data-binary "@path/to/my/file.pdf" \
  'http://localhost:3000/encrypt?password=1234&userPassword=asdf&allow=Printing'

参数说明：

• password - 字符串（必填）：所有者密码
• userPassword - 字符串：用户密码（可选）
• allow - 枚举值：允许的操作权限（可选）
  • Printing（打印）
  • DegradedPrinting（低质量打印）
  • ModifyContents（修改内容）
  • Assembly（文档组装）
  • CopyContents（复制内容）
  • ScreenReaders（屏幕阅读器）
  • ModifyAnnotations（修改注释）
  • FillIn（填写表单）
  • AllFeatures（所有权限）

解密PDF文件

bash
curl -X POST \
  -H 'content-type: application/x-www-form-urlencoded' \
  --data-binary "@path/to/my/encrypted.pdf" \
  'http://localhost:3000/decrypt?password=1234'

说明：password为必填参数，需提供加密时使用的所有者密码

提取PDF表单字段（JSON格式）

返回PDF表单字段信息（JSON格式）

bash
curl -X POST \
  -H 'content-type: application/x-www-form-urlencoded' \
  --data-binary "@path/to/my/pdf-form.pdf" \
  'http://localhost:3000/data/fields'

提取PDF文件信息（JSON格式）

返回PDF文件元信息（JSON格式）

bash
curl -X POST \
  -H 'content-type: application/x-www-form-urlencoded' \
  --data-binary "@path/to/my/file.pdf" \
  'http://localhost:3000/data/dump'

提取PDF表单字段（FDF格式）

返回PDF表单字段信息（FDF格式）

bash
curl -X POST \
  -H 'content-type: application/x-www-form-urlencoded' \
  --data-binary "@path/to/my/pdf-form.pdf" \
  'http://localhost:3000/data/fdf'

填充PDF表单

填充PDF表单字段并返回处理后的PDF

bash
curl -X POST \
  -H 'content-type: application/x-www-form-urlencoded' \
  --data-binary "@path/to/my/pdf-form.pdf" \
  'http://localhost:3000/form/fill?field1=value1&field2=value2'

参数说明：

• flag - 枚举值：
  • need_appearances（默认，确保表单字段外观正确）
  • flatten（展平表单，使字段不可编辑）
  • replacement_font（指定替换字体，需配合fontName参数）
• fontName - 字符串：指定字体名称（当flag=replacement_font时使用）
• 表单字段：通过URL参数传递，格式为字段名=值（如field1=value1）

端口

• 容器暴露端口：3000（HTTP）

代码仓库

https://github.com/philiplehmann/container/tree/main/apps/pdftk