Docker 每日一库:Stirling-PDF
PDF 处理大概是那种“平时不觉得,一需要就到处找在线工具”的典型场景。合并、拆分、压缩、OCR、格式转换,在线站用起来确实方便,但把合同、证件、内部文档上传到一个来路不明的服务器,总归不太踏实。Stirling-PDF 解决的就是这个矛盾:把一套完整的 PDF 工具箱跑在你自己的 Docker 里,浏览器打开就能用,文件从头到尾不出你的网络。
为什么是 Stirling-PDF
在 GitHub 上,Stirling-PDF 目前是 PDF 类项目中 star 数最高的一个(约 95.5k),定位很直接——“#1 PDF Application on GitHub”。它不是一个单功能小工具,而是一个可自托管的 Web 平台,覆盖了绝大多数人处理 PDF 时会用到的操作:编辑、合并、拆分、签名、涂黑、转换、OCR、压缩,官方列出的工具数量在 50 个以上。
选它来写“每日一库”,理由有三条:
隐私可控。 文件在你的服务器内存中临时处理,任务结束后自动清理,不存在“上传到第三方后不知道被拿去干什么”的问题。
部署极简。 一条 docker run 就能跑起来,熟悉 Compose 的话写四五行业务配置,从零到可用用不了五分钟。
功能密度高。 合并拆分、PDF 转图片/Word、OCR、添加水印、签名、密文保护,日常高频操作基本都被覆盖了,还附带 REST API,可以接入自动化流程。
部署:一条命令起步,Compose 收尾
最简启动只需要:
bash
docker run -p 8080:8080 docker.stirlingpdf.com/stirlingtools/stirling-pdf
浏览器访问 http://你的服务器IP:8080 就能看到界面。但这只是“能跑”,真要长期用,还是建议用 Docker Compose,把持久化和中文界面一并配好:
yaml
services:
stirling-pdf:
image: docker.stirlingpdf.com/stirlingtools/stirling-pdf
container_name: stirling-pdf
ports:
- "8080:8080"
environment:
- SYSTEM_DEFAULTLOCALE=zh-CN
volumes:
- ./data:/data
restart: unless-stopped
SYSTEM_DEFAULTLOCALE=zh-CN 会把界面默认语言设为简体中文;挂载 ./data 是为了让配置、字体等数据在容器重建后不丢。如果你的 8080 端口已经被占,把左边换成任意空闲端口即可,容器内始终是 8080。
一个小提醒:Stirling-PDF 处理大文件时会吃内存,如果主要跑 OCR 或压缩大体积 PDF,建议宿主机留出 2GB 以上的可用内存,并避免在低配机器上同时跑太多其他重型容器。
它到底能做什么
打开界面后,工具按类别分组,不需要一个个记。几个高频能力值得单独说:
合并与拆分几乎是刚需。把多个 PDF 拖进去,调整顺序,一次输出;拆分则支持按页码、按固定页数、按书签层级等多种方式。
OCR(光学字符识别) 让它从一个“操作 PDF 的工具”变成了“让扫描件变得可搜索的工具”。纸质文件扫描成 PDF 后,跑一遍 OCR,输出的是带文字层的 PDF,之后在任意阅读器里都能检索内容。
格式转换方向很全:PDF ↔ 图片、PDF → Word、HTML → PDF、Markdown → PDF,甚至 Office 文档互转也在覆盖范围内。日常被格式问题卡住时,不用再凑一堆在线站拼凑流程。
签名与密文是偏“正经办公”的功能。手写签名、图片签名、数字签名都支持;密文(redaction)可以真正把敏感内容从文件里移除,而不是画个黑框了事。
API 与自动化是开发者会喜欢的部分。绝大多数工具都有对应的 REST API,你可以把“合并+压缩+水印”串成一条无代码工作流,也可以从自己的脚本或后端服务里调用。这意味着它不只是一个浏览器里的工具站,还可以作为 PDF 处理微服务嵌进现有系统。
适用场景
如果你有一台常开的 NAS、家庭服务器,或者一台 2 核 4G 以上的云主机,Stirling-PDF 的性价比很高:它占用的资源可控,但换来的是一个团队共用的私有 PDF 工具箱。小团队内网办公、法务/行政处理合同、开发团队需要把 PDF 操作脚本化,这几个场景它都很对路。
如果只是偶尔用一次、处理的是完全公开的文件,在线站当然更省事。但一旦涉及合同、证件、内部文档,把工具跑在自己的 Docker 里,是更省心的长期选择。
一句话收尾
Stirling-PDF 的价值不在于“又一个 PDF 工具”,而在于把“隐私”和“功能密度”同时拉满之后,仍然只需要一条 Docker 命令就能拥有。 如果你的服务器上还空着一个端口,给它不会错。
- 点赞
- 收藏
- 关注作者
评论(0)