Stirling-PDF：自托管 PDF 工具箱，文档不用上传给别人

处理 PDF 这件事有个不太被注意的隐私问题。

合并一下、拆一下、转个格式、加个水印——这些操作本身没什么技术含量，但大多数人是把文件上传到某个在线工具网站完成的。那个文件可能是合同、是简历、是财务报表、是身份证扫描件。

上传之后就很难说清了：服务器留没留副本、留多久、会不会被索引。绝大多数网站的服务条款在这件事上写得很模糊。

Stirling PDF 解决的就是这个。它的定位是：强大的开源 PDF 编辑平台。可以作为个人桌面应用运行、在浏览器里用、或者部署在自己的服务器上并提供私有 API。官方强调 —— 编辑、签署、脱敏、转换和自动化 PDF，全程不把文档发送到外部服务。

方便，但文件要上传给别人

三种形态，覆盖不同需求

这一点做得比很多同类工具灵活：

桌面客户端——单人使用最省事，装完就用，文件完全不出本机。

浏览器 UI——自己部署后通过浏览器访问，适合小团队。

自托管服务器 + 私有 API——面向需要集成进现有系统的场景。

三种形态共用同一套能力，迁移成本低。

能力范围

官方给出的数字是 50+ PDF 工具。README 里的关键能力描述包括：编辑、合并、拆分、签署、脱敏、转换、OCR、压缩等。

几个值得单独说的：

OCR。扫描件没有文本层，搜索和复制都做不到。内置 OCR 能力意味着历史资料的数字化不用再找额外工具。

脱敏（Redact）。这是法律和合规场景的高频需求——起诉书、合同、医疗记录要发给对方之前，必须把敏感信息涂掉。在线工具做这个的风险尤其大，因为脱敏前和脱敏前的版本都经过别人服务器。

自动化与工作流。官方描述是：在 UI 里做无代码流水线，同时提供 API 来处理百万级 PDF。

这句话把两种用户都照顾到了——不懂代码的用可视化流程，开发者走 API 批量处理。

开发者平台：官方说明几乎所有工具都提供 REST API，可以集成进现有系统。

企业级能力：SSO、审计、灵活的内网部署。

SSO 和审计这两项说明它对企业场景是认真准备的，不是简单的小工具。

多语言界面：40+ 种语言。

部署：一条命令

README 给的快速开始非常简洁：

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

然后访问 http://localhost:8080。

一条 docker 命令跑起来，对自托管工具来说门槛算是很低了。完整的安装方式（包括桌面版和 Kubernetes）在官方文档里。

有一个必须先说清的授权问题

README 的最后一行写着：

License: Stirling PDF is open-core.

open-core（开放核心） 是一个需要认真对待的授权模式。它意味着：一部分功能开源，另一部分（通常是企业级功能）是闭源或付费的。

这和纯粹的 MIT / Apache 2.0 项目有本质区别。对个人用户通常没影响，但如果你的场景涉及：

  • 商业使用，尤其是对外提供服务
  • 企业内部大规模部署
  • 基于它做二次开发或产品集成

那么必须先读清楚 LICENSE 和官方关于付费版本的说明，确认哪些功能在开源范围内、哪些需要付费授权。

README 里也确实提到了 "Server Plan & Enterprise"（服务器计划与企业版）和 "Paid Offerings"（付费项目）的文档入口。

我不是说 open-core 不好——这是一种能支撑项目长期维护的可持续模式，很多成熟项目都这么做。但选型时必须明确知道自己在用哪个部分，而不是想当然地以为"开源项目功能全都能白用"。

本地处理 vs 在线网站

和在线网站的真实差别

上图的对比要说得客观一点：

在线网站的优势是零部署成本、随时可用、不用维护。偶尔用一次，或者处理的文件不敏感，在线工具确实更省事。

自托管的优势主要是三点：文件不出内网、没有免费版的次数或文件大小限制、可以内网离线使用。

第三条对某些环境是刚需——内网隔离的环境根本无法访问在线工具。

选择的关键其实就一个问题：你要处理的文件敏不敏感，以及使用频次高不高。低频 + 不敏感，用在线工具；高频或者文件敏感，自托管更合适。

适合谁用

需要频繁处理 PDF 的个人用户。桌面版装一次，之后所有操作都在本地。

处理敏感文档的岗位。法务、财务、人力、医疗——这些岗位经手的 PDF 大多不适合上传到第三方网站。

内网/隔离环境的团队。自托管是唯一可行的方案。

要把 PDF 处理集成进业务系统的开发者。几乎所有工具都有 REST API，加上支持 Docker 和 Kubernetes 部署。

不太适合：

  • 偶尔用一两次的用户。部署成本大于收益，直接用在线工具。
  • 需要把开源版用于商业产品的公司。必须先确认 open-core 的授权边界。
  • 完全不接受任何运维投入的个人。虽然有桌面版可选，但服务器版仍需维护。

项目地址： https://github.com/Stirling-Tools/Stirling-PDF 官方文档： https://docs.stirlingpdf.com 官网： https://stirling.com

本文依据项目官方仓库 README 整理编写。项目采用 open-core 授权模式，商业使用或二次开发前请务必阅读官方 LICENSE 与付费说明。