陈易铭平时我处理PDF文件的场景挺多的，从合并几十份合同到给扫描件加页码，再到把客户发来的图片型PDF转成可编辑Word，几乎每周都要折腾几次。以前图省事，直接搜在线工具，但用久了就发现两条路都不太好走：在线网站免费额度少、上传速度慢、还有文件泄露的顾虑；商业软件价格不低，破解版又实在不敢用。直到朋友推荐了这个完全开源免费的PDF处理工具——Stirling PDF，实测了一段时间，感觉它是目前把“开源免费、功能全面、部署简单”三者平衡得最好的方案，支持PDF编辑转换、拆分合并、添加水印、OCR识别、加密解密等几十项功能，个人和公司内网部署都很合适。这篇文章就把我从下载到部署、从配置到实际使用中踩过的坑和验证过的操作，全部分享出来。
1. 为什么我最终放弃了在线工具和商业软件
1.1 在线PDF网站的坑，很多人可能还没意识到
在线PDF工具最大的问题是文件安全，虽然大多数小众站点没有恶意，但你根本不知道文件上传到了哪台服务器、会被存储多久、会不会被用于其他用途。有一次我要处理一份带有客户手机号和身份证扫描件的材料，本来想用免费在线工具压缩一下，同事直接提醒我，这种信息一旦传出去，泄露责任说不清楚。从那次之后，凡是涉及隐私数据的文件，我坚决不上传任何在线服务。
除了安全，在线工具的免费限制也很让人头疼。相信用过的人都懂，免费用户往往会遇到文件大小限制、页数限制、每天转换次数限制，最关键的是输出文件会带水印或需要等待很长的队列时间。即使你只是简单地把两页PDF合并成一个新文件，某些网站也要求注册才能下载，这种体验非常差。
商业软件方面，Adobe Acrobat Pro虽然功能强大，但订阅价格对个人用户不友好，公司批量采购又是一笔预算。开源方案最直接的好处是：软件本体免费，部署在自己可控的服务器或本地电脑上，文件数据不出内网，彻底解决隐私和成本这两座大山。
1.2 免费开源不代表随便拿，选型要看这几项硬指标
很多人一听到“开源”就认为等于“随便用”，这是误解。开源项目的许可证决定了你能怎么用它。如果是个人试用，几乎什么许可证都无所谓；但如果要在公司内部署，甚至基于它做二次开发集成到自己的系统里，许可证就是红线。
Stirling PDF 用的是 Apache License 2.0，这个许可对公司商用场景非常友好：你可以自由使用、修改、分发，甚至把它集成进商业系统，不需要开源你自己新增的代码。相比之下，如果某个工具用的是 GPL 协议，而你又想把它嵌入到闭源商业产品里，就会有比较严格的传染性限制，容易埋下合规风险。
选择开源项目时，我还习惯看三个指标：GitHub 上的 Star 数量和更新频率、Issue 区是否有人维护跟进、Docker 镜像是否长期持续发布。选型时切忌只看 Star 数，很多项目 Star 很高但作者弃坑已久，安全漏洞没人修，反而比商业软件更危险。Stirling PDF 在这方面表现不错，社区活跃、更新频率高，这也是我决定深入使用它而不是选择其他开源 PDF 项目的原因。
1.3 同类开源PDF工具横向对比
给同样喜欢自部署的朋友做一个简单对比，便于选型：
| 工具 | 核心定位 | 许可证 | 部署难度 | 适合场景 |
|---|---|---|---|---|
| Stirling PDF | 全功能PDF处理工具箱（转换、合并、OCR、水印） | Apache 2.0 | 低（Docker秒级启动） | 个人/公司内网，需要一站式解决方案 |
| PDFsam Basic | 专注PDF拆分、合并、旋转、提取 | AGPL | 中（桌面应用为主） | 只需要拆分合并的轻量需求 |
| OCRmyPDF | 纯OCR识别并生成可搜索PDF | Apache 2.0 | 中（命令行工具） | 需要批量处理扫描件等高级用户 |
| pdfarranger | 可视化页面级编辑 | GPL | 低（桌面应用） | 手动调整PDF页面顺序 |
Stirling PDF 的优势在于提供Web操作界面，所有人用浏览器就能访问，不需要在每台电脑上安装客户端。对于公司内部员工来说，打开浏览器即用，体验门槛最低。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Stirling PDF的核心能力拆解与部署准备
2.1 它能做什么，不仅仅是你想象中的“PDF编辑”
初看你可能以为这就是个“合并PDF、拆分PDF”的小工具，实际部署完打开界面后，你会被它的功能列表惊到。Stirling PDF 把功能分成了几个大板块：转换、安全与权限、页面操作、文本与图形、OCR识别、压缩优化等，总计二三十项常用操作。它内部并没有从零再造一套PDF解析引擎，而是集成了多个成熟开源组件。
具体来说，PDF页面拆分合并依赖的是 Apache PDFBox，这是Java生态里非常成熟的PDF处理库；文件格式转换则依赖 LibreOffice 做底层转换；OCR识别调用的是