9.3万Star,GitHub第一PDF神器,一条Docker命令就能私有化

一句话介绍

Stirling PDF——GitHub 上星标最高的 PDF 应用，9.3 万 star。 55+ 个 PDF 工具打包成一个自托管平台，编辑、合并、拆分、签名、脱敏、转换、OCR、压缩全都有。一条 docker run 就跑起来，文件永远不出你的服务器。 还有桌面客户端、REST API、无代码自动化流水线，甚至给 AI 助手准备的 MCP Server。

开篇：晚上十一点，你又卡在了 PDF 上

客户催着要签字，你要把三份 PDF 合一份、加上签名、再压到 5MB 以内发出去。

你打开某个在线转换站。上传。转圈。然后弹出一行小字：

免费用户每日限 2 次，且输出带水印。

你咬牙想开会员——突然停住了：这份合同里有报价、有客户名单、有身份证号。

你要把公司的合同，传到一个不知道在哪的服务器上？

换个思路，装 Adobe Acrobat：订阅制、几百 MB、还顺手给你装一堆后台进程。

而真正优雅的答案是：自己搭一个。

docker run -p 8080:8080 docker.stirlingpdf.com/stirlingtools/stirling-pdf

打开 http://localhost:8080，全套工具都在，文件一步都没离开你的机器。

它是什么：一个被 9 万人投票的 PDF 平台

Stirling PDF 的自我介绍相当硬气：

#1 PDF Application on GitHub that lets you edit PDFs on any device anywhere.

数据（2026 年 9 月）：92,829 star、9,124 fork，2023 年开源，前端 TypeScript + 后端 Java，最新版本 v2.14.3（8 月 6 日）。官网 stirling.com，文档站 docs.stirlingpdf.com。

它不是"某个 PDF 小工具的开源实现"，而是把 55+ 个工具整成了一个平台——而且有三个形态：

55+ 个工具，到底能干什么

随便列一些你会真的用上的：

整理类：合并、拆分、按页数/书签/大小拆分、旋转、重排、删除页面、提取页面、扫描件拆分

转换类：PDF ↔ Word / Excel / PPT / 图片 / HTML / Markdown / XML；图片 → PDF；Office 文档 → PDF（底层靠 LibreOffice）

安全类：加解密、改权限、加水印、脱敏（redact）、扁平化、清除元数据

签名与表单：手写签名、图片签名、填写表单、导出表单数据

OCR 与识别：扫描件文字识别（Tesseract），生成可搜索 PDF

其他：压缩、修复损坏文件、加页码、加目录、比对差异、去除密码、提取图片

不夸张地说，你能想到的 PDF 操作，它基本都有对应入口。

最不一样的一点：有状态的工作区

这是 Stirling PDF 和"一堆独立工具页面"的根本区别。

大多数在线 PDF 站的逻辑是：上传 → 处理 → 下载。想做第二步？重新上传一次。

Stirling PDF 是 Stateful Workspace：上传一次，多个工具链式串联，而且全程支持 撤销 / 重做。

合完并、发现顺序错了？撤销。加水印加错了？撤销。想再加个页码？直接接着来，不用重传。

这种体验上的差距，用一次就回不去了。

不只是给你点着用：它是给机器用的

这一块才是它从"工具集合"升级成"平台"的地方。

• • REST API：几乎所有工具都有对应 API，能直接接进你现有的系统
• • Pipelines（流水线）：在 UI 里无代码搭出处理流程——比如"监听文件夹 → OCR → 加页码 → 压缩 → 输出到指定目录"，官方说这套能稳定处理数百万份 PDF
• • Folder Scanning（文件夹扫描）：盯着一个目录，扔文件进去就自动处理
• • MCP Server：给 AI 助手用的接口——这意味着你可以直接跟 Claude、Cursor 说"把这个目录下所有 PDF 合并并压缩"，它替你调 Stirling PDF

企业级管控也齐：SSO（OAuth2 + SAML）、用户管理、细粒度权限、审计日志、外部数据库、高级监控。

三种镜像，按需挑

docker run -d \  -p 8080:8080 \  -v ./stirling-data:/configs \  docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest

不想用 Docker？下载 Stirling-PDF.jar，装 Java 25+，再配上 LibreOffice（Office 转换）和 Tesseract（OCR），直接跑 JAR 就行。K8s 部署也有官方指引。

配置方式也灵活：UI 里改，或者用环境变量和 settings.yml 全量驱动——便于纳进 IaC。

和其他方案比

一句话：既要"打开就能用"的门槛，又要"文件不出内网"的底线，还要能挂进自动化流程——目前只有它同时满足。

两个必须说清楚的注意事项

1. 它是 open-core，不是纯 MIT。

仓库 LICENSE 的正文是 MIT，但明确划分了例外目录：app/proprietary/、app/saas/、engine/、frontend/editor/src/proprietary/、frontend/editor/src/desktop/、frontend/editor/src/saas/、frontend/editor/src/cloud/ 等目录下的内容各自适用其自己的授权。

日常自用、内部部署没问题；要二次分发或做商业产品，务必先读一遍 LICENSE 和付费说明（部分企业特性如外部数据库、Google Drive 集成、高级监控、优先支持属于 Team / Enterprise 方案）。

2. "处理位置"要看清楚。

官方说得很坦白：自托管的工具在你自己的实例上跑；桌面端在本地后端跑；但被路由到 Stirling Cloud 或你所连接的服务器的工具，会把输入文件送到那里去。

如果你处理的是高敏感文档，部署时记得确认哪些工具走了云端路由。

常见问题

必须联网吗？

自托管和桌面端离线可用（OCR 之类的依赖本地装好即可）。部分高级工具会走云端路由，前面说过了。

中文 OCR 准吗？

Tesseract 需要装对应的语言包；用 latest-fat 镜像字体更全，转换质量更好。扫描件质量是决定因素。

V1 用户怎么升 V2？

官方有专门的迁移指南（docs.stirlingpdf.com/Migration），写清了 V2 的新变化和升级步骤，建议升级前先看。

能给我们全公司用吗？

可以。Docker + K8s 部署、SSO 登录、权限分级、审计日志都有，官方还有一份《生产部署指南》覆盖安装→配置→安全→监控。

需要什么配置？

标准镜像很轻，latest-ultra-lite 更轻。但要跑 Office 转换和高质量 OCR，建议上 latest-fat 并预留内存。

总结

Stirling PDF 击中了一个所有人都遇到过、但很少被认真解决的痛点：PDF 是最通用的文件格式，处理它却要付费、要联网、要交出隐私。

它的解法简单粗暴——把 55+ 个工具开源，让你自己跑一份。简单到一条 Docker 命令，完整到能进企业的生产环境。

更聪明的是它没停在"工具集合"：有状态工作区解决体验，API 和流水线解决规模化，MCP Server 直接接进 AI 工作流——你在浏览器里点得动的东西，机器也能调得动。

下次再看到"免费用户每日限 2 次"，想想那条 docker run。

项目地址：https://github.com/Stirling-Tools/Stirling-PDF官网 / 文档：https://stirling.com · https://docs.stirlingpdf.com起服务：docker run -p 8080:8080 docker.stirlingpdf.com/stirlingtools/stirling-pdf数据：92,829 star · 9,124 fork · v2.14.3 · 55+ 工具 · 40+ 界面语言