> 📌 **项目地址**:[Stirling-Tools/Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF) | ⭐ 84,918 颗星 | 🔧 TypeScript | 📜 未标注

处理PDF的在线工具很多,但敏感文件传别人服务器不放心;桌面软件功能够,换台电脑就得重装,团队协作全是手动传来传去。Stirling-PDF 走的是第三条路:你自己跑个Web服务,所有操作在本机或内网完成,浏览器打开就用。GitHub 上 84918 个 star,说明大家确实需要这个。

## 一分钟部署,没有注册和广告

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

这条命令来自项目 README 的 Quick Start。运行后打开 `http://localhost:8080`,直接看到工具界面。没有注册页面,没有付费弹窗,连“先看教程”的引导都没有,就是一个工具列表。如果不想用 Docker,官方也提供桌面客户端(Windows/macOS/Linux)和 Kubernetes 部署方案,详见[文档指南](https://docs.stirlingpdf.com/#documentation-guid)。

我用一台 2 核 4G 的 VPS 部署,同时跑几个操作没觉得卡。如果团队并发多,建议给容器分 4GB 以上内存。

## 50 多个工具,哪些常用

左侧按功能分组,名字直白,没有二次翻译的困惑。

– **组织**:合并、拆分、旋转、删除页面、重新排序、调整页面尺寸。合并时支持拖拽调整顺序,操作很顺手。
– **安全**:加密(AES 256)、解密、数字签名、涂黑(redact)、设置密码。密码直接在工具里输入,不用额外配置。
– **转换**:PDF ↔ Word / Excel / PowerPoint / 图片 / HTML / Markdown / EPUB。中文文档转 Word 时排版基本保留,标题和表格不会乱。
– **OCR**:基于 Tesseract,默认带英文语言包。需要处理中文或别的语言,得自己下载对应训练数据放到容器里。步骤在工具页面里有提示,不算复杂。
– **压缩**:低/中/高三档可选。我试过扫描件从 20MB 压到 4MB,肉眼几乎看不出区别。高档压缩会把文字边缘压糊,一般用中档就够了。
– **PDF Multi Tool**:在一个页面里完成合并、转换、重排、拆分、删除,适合批量处理,省去来回切换的时间。

工具数量超过 50 个,覆盖了绝大多数日常需求:加水印、提取页面、旋转、裁剪、添加页码、Flatten 表单等等。每个工具都是独立界面,没有复杂的全局配置。

## 自动化工作流:把重复操作存成模板

Stirling-PDF 内置 Pipelines(工作流)功能,在 UI 里拖拽就能串联操作步骤。举个例子:先拆分一个多页 PDF,每一页跑 OCR,然后把结果合并成一个可搜索的 PDF。整个流程在浏览器里配好,保存成模板。以后每周处理类似文件,直接点运行。

配合 REST API,可以写脚本自动执行。API 文档在 [Scalar 页面](https://registry.scalar.com/@stirlingpdf/apis/stirling-pdf-processing-api/)(README 提供的官方链接)。比如每天凌晨自动合并一批合同,压缩、加密,再存到指定目录。API 覆盖了几乎全部工具,能集成到现有系统里。

## 安全部署与企业功能

默认情况下,Stirling-PDF 无认证。谁访问你的服务器 8080 端口都能用。这不是 bug,是设计,方便快速试用。但面向公网必须开启认证。通过环境变量可以启用登录,支持 OAuth2、OpenID、LDAP、SAML。配置方法在文档的 System and Security 部分。我试了 LDAP 对接,跟着文档半小时搞定。开启后还能审计日志(企业版功能),记录每次操作的用户、时间、工具、文件名。

项目采用 open-core 许可。社区版免费,核心功能齐全。SAML 2.0、高级审计、高可用集群等是企业付费版特性。[付费页面](https://docs.stirlingpdf.com/Paid-Offerings)有价格和对比。

## 社区与贡献

项目有活跃的 [Discord 社区](https://discord.gg/HYmhKj45pU),bug 报告走 [GitHub Issues](https://github.com/Stirling-Tools/Stirling-PDF/issues)。贡献代码需要看 CONTRIBUTING.md,构建任务使用 Taskfile(跨平台命令运行器),运行 `task dev` 启动编辑器,`task` 查看常用命令。翻译新增语言有专门的指南(devGuide/HowToAddNewLanguage.md)。

## 实际用下来的感受

界面支持 40 多种语言,中文翻译完整,没有明显漏翻。暗黑模式默认跟随系统。并行下载功能支持同时跑多个任务,不用干等。

几点需要注意:

– **默认无认证**:第一次部署到公网环境,记得先配认证,否则服务就是裸奔。
– **OCR 中文**:默认只有英文。如果主要处理中文扫描件,需要手动下载 `chi_sim.traineddata` 放到容器 `/usr/share/tesseract-ocr/4.00/tessdata/` 目录下(参考文档)。新手可能第一次找路径费点时间,但社区有人踩过坑,网上搜便知。
– **转换字体**:中文文档转 Word 时,部分特殊字体(如方正)会回退成宋体,排版稍有偏移,但内容可读。频率不高的话可以接受。

我的建议:如果你有自建服务器,或者团队需要内部 PDF 处理中心,Stirling-PDF 值得花 10 分钟部署。它解决了“在线工具不安全,桌面工具不共享”的矛盾。偶尔用一次在线功能,没必要自己搭;但一旦涉及敏感数据或批量处理,自己控服务是更踏实的选择。

## 资源

– 文档:https://docs.stirlingpdf.com
– API 文档:https://registry.scalar.com/@stirlingpdf/apis/stirling-pdf-processing-api/
– 社区(Discord):https://discord.gg/HYmhKj45pU
– 提 Bug:https://github.com/Stirling-Tools/Stirling-PDF/issues

这篇文章对你有帮助吗?

发表回复