Stirling PDF 自建:97.2k star 的 PDF 工具箱

自建 PDF 工具箱,文件不出服务器

更新时间:2026-11-22 21:23:33

访问次数:5

详细介绍
一句话结论:Stirling PDF 把 50 多个 PDF 工具装进一个自建网页,Docker 起一个容器就能用,文件不经过第三方;GitHub 97.2k star、官网写着 44M downloads、当前 3.4.0。个人自用免费,但它是混合授权:核心代码 MIT,Pro/Enterprise 子目录另有条款,公司落地前要把授权看清楚。

这是什么

Stirling PDF 是一个可以跑在自己服务器上的 PDF 工具箱,浏览器打开就是界面。合并、拆分、压缩、转 Office、OCR、涂黑敏感信息、加水印、签名、页面重排、比较两个 PDF,这些常用动作都在同一个入口里,官方口径是 50 多个工具。

它和 PDF24、Sejda 这类在线站最大的差别是文件流向:上传、处理、下载都发生在你映射的 8080 端口里,不经过别人的对象存储。对合同、财务凭证、身份证扫描件这种不方便传到公网的文件,这一点比多几个功能重要。

我怎么用它

  • 用官方镜像起容器,映射 8080,挂一个卷存配置和临时文件,容器重建不丢设置;
  • 前面挂 Nginx 和一层登录验证,只在内网或 WireGuard 里开放,别把裸端口直接扔公网;
  • 把用不到的工具在配置里关掉,入口越少,出问题时要排查的面越小;
  • 固定几条流水线:扫描件先 OCR,再压缩,最后合并;批量任务走它的 API,不手工点;
  • 每次升级前先备份配置卷,镜像拉新版本后先跑一份测试 PDF 再切生产。

上手截图

Stirling PDF 自建:97.2k star 的 PDF 工具箱

图:Stirling 官网首屏,44M downloads 与「Your PDFs. Your servers.」的本地化定位

优点

  • 工具密度高,一个容器替掉合并、压缩、OCR、转档、涂黑、签名好几个零散服务;
  • 文件留在自己机器上,隐私边界清楚,适合内部文档流;
  • 有 API,能和表单、扫描仪目录、定时任务接起来做批处理;
  • 个人自用不收费,Docker 部署的门槛也就是一条命令加一个端口。

缺点

  • 自建就要自己养:升级、备份、反代、证书、权限,一样都不能少;
  • 授权不是单纯的 MIT,核心之外有 proprietary 子目录,商用前要逐个确认;
  • OCR 要按语言装数据,镜像和内存占用会随功能增加;
  • 高级的协作、SSO、审计能力往 Pro/Enterprise 走,免费版不是全功能。

什么时候别用它

手上没有服务器、一个月只处理两三个 PDF,直接用 PDF24 或 Sejda 网页版更省事。要改 PDF 里的正文文字、又不想维护容器,装 PDFgear 这类桌面端更直接。

网友评论