ARTICLE · 1079192
【GitHub】9.3万星的PDF神器:50个工具,但商用规则变了
改一份 PDF 就得把合同传到陌生网站？建议先收藏这篇。GitHub 上这个 9.3 万星的开源工具 Stirling-PDF，能把 PDF 处理全留在家里的机器上。
{一个容器，装下 50 多个工具}
它的定位一句话说得清，就是一个能自己部署的 PDF 工具箱。合并、拆分、压缩、加密、加水印、OCR、脱敏、数字签名、格式互转，50 多个功能全在一个网页界面里。
转换这块覆盖得挺全，PDF 能转 Word、Excel、PPT、图片、HTML、Markdown，反过来也行。界面支持 40 多种语言。
取用方式有三种，按你的习惯挑：
桌面客户端，Tauri 打包，Windows、macOS、Linux 都有，支持「打开方式」直接接管
浏览器加自托管服务器，一条 Docker 命令搞定
REST API，几乎每个工具都有对应接口
官方站点现在挂着 3000 万次以上的下载量，这个数字是他们自己的口径，当参考就好。
SSO、审计日志、灵活的本地部署这些，按官方文档站的付费说明页，属于企业档。社区版拿到的是那 50 多个工具本身。
{技术底子比想象中硬}
后端是 Spring Boot 4.0.6，构建工具链直接 pin 到 Java 25。做 PDF 解析渲染的是 Apache PDFBox 3.0.8，Office 格式转换交给无头 LibreOffice（unoserver），OCR 走 Tesseract，压缩加密补 qpdf 和 Ghostscript。
V2 之后前端整体重写成 React 加 TypeScript 的 SPA。另外还有个独立的 engine/ 目录，是 Python 服务，承接 OCR 和比较重的文档智能任务。
让我意外的是工程纪律。仓库里有 ArchUnit 做架构边界测试，防止开源核心的代码悄悄依赖闭源模块。还有依赖许可证报告流程和 allowed-licenses.json，主动审计每个进来的依赖是什么许可。
统一命令入口用的 Task，不是一堆散装脚本。
{9.3 万星是怎么来的}
说实话，PDF 这个领域不缺工具，缺的是「不上传」。iLovePDF、SmallPDF、Adobe 在线版都能干活，前提是你得先把文件交出去。
Stirling-PDF 踩中的就是这个点。一条 Docker 命令跑在本机，文件全程不出内网，需要的话还能部署到气隙环境。
落地场景也挺清楚。个人拿它处理简历、合同这类不想外传的东西，小团队在内网部署一个，登录后全员共用。
开发和财务那边更实用，用 API 把它接进报表归档、批量 OCR 的流水线里，省掉一轮轮手动上传下载。
对 Java 开发者来说还有一层意思。这几年开源爆款基本被 Go、Rust、Python 包了，它偏偏用最传统的 Spring Boot 单体架构拿下了 9.3 万星。
它的护城河是工程化能力，把 50 多个工具有条理地组织成一个能部署、有 API、有可观测性的产品。
{最该先看清的一条，open-core 的边界}
这里得纠正一个流传很广的说法。不少中文文章写「核心 MIT 协议免费开源，商用随你」，实际情况要复杂一些。
先看仓库根目录的 LICENSE。文件头是标准 MIT，版权方写的是 Copyright (c) 2025 Stirling PDF Inc.。但 MIT 之上叠了 10 个例外目录，各自适用自己目录下的许可。
这些目录包括 app/proprietary/、app/saas/、engine/，以及前端里的 proprietary/、desktop/、saas/、cloud/ 等。这也解释了 GitHub 的许可证字段为什么显示 NOASSERTION，一个文件里混着多种许可，检测器没法归类。
再看官方 v2.0.0 的发布说明。原文写着 open-core 许可将会被强制执行，个人用户和 5 人以内团队可以完全免费使用，超过 5 人的组织需要购买许可。
同版本还上线了不限席位的 SERVER 档，99 美元每月每服务器，或 1000 美元每年。存量用户被 grandfather，老用户不受影响。
这两处都建议自己去看原文再做决定。仓库根的 LICENSE 文件，以及文档站的 Paid-Offerings 页面。
自己家里用，或者五个人以内的小团队，这条线碰不到。但要是往公司内网批量铺，动手前先把上面两个页面读完。
{怎么跑起来}
docker run -p 8080:8080 docker.stirlingpdf.com/stirlingtools/stirling-pdf
打开 http://localhost:8080 就能用。这是官方 README 现在的写法，镜像地址已经换成他们自有 registry，不是 Docker Hub。
镜像分三档，按需选：
latest 首次登录的默认账号是 admin、密码 stirling，进去会被强制改密码。打算开在公网的话，强密码和 HTTPS 都别省。
每个工具都有对应的 REST API，应用内的 /swagger-ui 能看到完整接口文档，接自己的流水线很方便。不过网上流传的接口路径不少已经过期，以你自己那个版本跑出来的文档为准。
{两句实在话}
社区里最高票的需求是原生表单字段创建，issue #320 攒了 55 个赞，目前还没补齐。另外从 v2.14.3 的修复清单看，它迭代得很快，升级前记得备份 config 目录。
不愿意把合同随手传上网的人，去 GitHub 给它点个 Star 吧。五个人以上的团队部署前，先翻一遍 LICENSE。
#GitHub #开源 #PDF工具 #效率工具 #自托管 #隐私保护 #Docker #开源项目
Stirling-PDF
自托管 PDF 处理平台，50 多个工具，一条 Docker 命令跑起来
https://github.com/Stirling-Tools/Stirling-PDF
{ 感谢阅读 }
如果本文对您有帮助，欢迎 “点赞“，点“推荐”