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）