Stirling-PDF：开源免费的全能 PDF 工具平台，50+ 功能自托管无忧

发表于

你是否经常需要处理 PDF 文件——合并几个文档、提取某几页、给文件加密、或者把扫描件转成可搜索的文本？每次都要打开某个在线工具，上传文件，等待处理，再下载？更让人担心的是，这些文件都上传到了别人的服务器上。

这就是 Stirling-PDF 要解决的问题。它是一个完全开源、完全免费的 PDF 工具平台，拥有 50 多种 PDF 操作功能，支持自托管部署，让你的文件永远不离开自己的服务器。

Stirling-PDF 是什么？ Stirling-PDF 是一款开源免费的全能 PDF 处理平台，基于 Java 构建，提供 50+ 种 PDF 操作（编辑、合并、拆分、OCR、转换、签名、压缩等），支持 Docker 自托管、桌面应用和 REST API，是 iLovePDF 和 Smallpdf 的开源替代方案。

关键数据：

  • 🌟 GitHub Stars: 83,600+（仓库链接）
  • 🍴 Forks: 7,200+
  • ⚖️ 许可证：MIT（开源核心）
  • 🧠 核心特性：50+ PDF 工具——编辑、合并、拆分、签名、OCR、压缩、转换一应俱全
  • 📦 核心特性：自托管——Docker 一键部署，文件不离开你的服务器
  • 🔧 核心特性：REST API——几乎每个工具都有 API，可集成到现有系统
  • 🤖 核心特性：自动化工作流——无代码流水线，批量处理百万级 PDF
  • 🌍 核心特性：40+ 语言——支持全球多语言界面
  • 🏢 核心特性：企业级——SSO、审计、灵活的本地部署

前提条件

在开始使用 Stirling-PDF 之前，你需要准备：

  • 一个现代浏览器（Chrome、Firefox、Safari、Edge）
  • Docker 环境（推荐）或 Java 17+ 运行环境

💡 提示：Stirling-PDF 提供多种部署方式：Docker（推荐）、桌面应用、Kubernetes。最简单的方式是 Docker 一键启动。

概述

本文将带你全面了解 Stirling-PDF，包括：

  1. 核心功能和 50+ 种 PDF 操作
  2. 快速上手：Docker 部署和桌面应用
  3. 企业级特性：API、SSO、自动化工作流
  4. 与同类工具的对比
  5. 适用场景和进阶技巧

详细步骤

第一步：快速上手——Docker 部署

最简单的方式是使用 Docker 一键启动：

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

启动后访问 http://localhost:8080 即可使用。

💡 提示：首次启动会下载依赖，可能需要几分钟。生产环境建议挂载持久化存储卷。

第二步：桌面应用

如果你不想用 Docker，Stirling-PDF 也提供桌面应用：

  1. 访问 GitHub Releases 下载对应系统的安装包
  2. 安装后直接打开即可使用
  3. 无需网络连接，完全本地运行

第三步：了解核心功能

50+ PDF 工具

Stirling-PDF 提供了几乎覆盖所有 PDF 操作的工具集：

编辑类：

  • 文本编辑、图片插入、页面旋转、裁剪调整
  • 添加水印、页眉页脚、贝茨编号
  • 表单填写和创建

转换类：

  • PDF 转 Word、Excel、PPT、HTML、图片
  • Word、Excel、PPT、图片转 PDF
  • PDF/A 格式转换

安全类：

  • 密码保护、权限设置
  • 内容脱敏（Redact）
  • 数字签名
  • PDF 扁平化

OCR 类：

  • 扫描件文字识别
  • 支持多语言 OCR
  • 批量 OCR 处理

组织类：

  • 合并、拆分、重排页面
  • 提取指定页面
  • 页面裁剪和调整大小

压缩类：

  • PDF 文件压缩
  • 图片优化
  • 批量压缩

自动化工作流

Stirling-PDF 支持无代码自动化流水线：

  • 在 UI 中直接创建处理流水线
  • 支持条件判断和循环
  • 可处理百万级 PDF 文件
  • 通过 API 触发和监控

REST API

几乎每个 PDF 工具都有对应的 API：

1
2
3
4
5
# 示例：通过 API 合并 PDF
curl -X POST http://localhost:8080/api/v1/general/merge-pdfs \
  -F "fileInput=@file1.pdf" \
  -F "fileInput=@file2.pdf" \
  -o merged.pdf

API 文档地址：https://registry.scalar.com/@stirlingpdf/apis/stirling-pdf-processing-api/

企业级特性

  • SSO 单点登录 — 支持 LDAP、OAuth 等企业认证
  • 审计日志 — 完整的操作记录
  • 灵活部署 — Docker、Kubernetes、裸机安装
  • 40+ 语言 — 全球化支持

第四步：与团队协作

Stirling-PDF 支持多用户部署：

  • 多人同时使用同一实例
  • 用户权限管理
  • 操作审计追踪
  • 私有 API 集成到内部系统

与同类工具的对比

特性 Stirling-PDF iLovePDF Smallpdf PDFsam OpenPDF
开源 ✅ MIT ❌ ❌ ✅ AGPL-3.0 ✅ LGPL/MPL
免费 ✅ 完全免费 ⚠️ 有免费版 ⚠️ 有免费版 ✅ 完全免费 ✅ 完全免费
自托管 ✅ Docker/K8s ❌ ❌ ✅ ✅
PDF 工具数 50+ 25+ 20+ 10+ 库级别
OCR ✅ 多语言 ⚠️ 付费 ⚠️ 付费 ❌ ❌
自动化工作流 ✅ 无代码 ❌ ❌ ❌ ❌
REST API ✅ 全面 ⚠️ 有限 ⚠️ 有限 ❌ ✅
桌面应用 ✅ ❌ ✅ ✅ ❌
SSO/企业级 ✅ ❌ ⚠️ 付费 ❌ ❌
多语言界面 ✅ 40+ ✅ 25+ ✅ 20+ ✅ 15+ ❌
GitHub Stars 83,600+ N/A N/A 4,400+ 4,200+
定位 全能 PDF 平台 在线 PDF 工具 在线 PDF 工具 PDF 拆分合并 PDF 开发库

关键区别：

  1. Stirling-PDF vs iLovePDF/Smallpdf：Stirling-PDF 完全开源免费，支持自托管，文件不离开你的服务器；iLovePDF 和 Smallpdf 是商业产品，使用方便但免费版有文件大小和次数限制，且文件需上传到第三方服务器。

  2. Stirling-PDF vs PDFsam：Stirling-PDF 功能更全面（50+ 工具 vs 10+），支持 OCR、自动化工作流和 API；PDFsam 专注于 PDF 拆分合并，功能较单一。

  3. Stirling-PDF vs OpenPDF：Stirling-PDF 是完整的应用平台，有 UI 和一键部署；OpenPDF 是开发库，需要编程才能使用。

  4. Stirling-PDF vs iText：Stirling-PDF 面向终端用户，开箱即用；iText 是面向开发者的 PDF 库，功能强大但需要编程。

常见问题（FAQ）

Q: Stirling-PDF 真的完全免费吗？
A: 是的。Stirling-PDF 采用 MIT 开源许可证，所有功能免费使用。但需要注意，它有部分企业级功能（如高级 SSO）可能需要付费支持。

Q: Stirling-PDF 和 iLovePDF 有什么区别？
A: Stirling-PDF 是开源的，支持自托管，文件不离开你的服务器；iLovePDF 是商业在线工具，使用方便但免费版有文件大小限制（25MB），且文件需上传到第三方服务器。

Q: 自托管需要什么技术要求？
A: 最简单的方式是 Docker，一行命令即可启动。最低配置：1 核 CPU、1GB 内存。生产环境建议 2 核 CPU、4GB 内存。

Q: Stirling-PDF 支持哪些文件格式？
A: 支持 PDF 与 Word、Excel、PPT、HTML、图片（JPG、PNG 等）之间的互转，还支持 PDF/A 格式转换。

Q: Stirling-PDF 的 OCR 效果如何？
A: Stirling-PDF 集成了 Tesseract OCR 引擎，支持多语言文字识别。对于清晰的扫描件效果很好，但对手写体或模糊文档可能需要人工校对。

Q: 可以批量处理 PDF 文件吗？
A: 可以。Stirling-PDF 支持自动化工作流，可以在 UI 中创建无代码流水线，批量处理大量 PDF 文件。也可以通过 REST API 集成到自动化脚本中。

Q: Stirling-PDF 适合什么场景？
A: 适合对数据隐私有要求的个人、团队和企业。特别是处理敏感文档（如法律文件、财务报表、医疗记录）时，自托管确保文件不离开你的控制。

Q: Stirling-PDF 的 API 文档在哪里？
A: 官方 API 文档地址：https://registry.scalar.com/@stirlingpdf/apis/stirling-pdf-processing-api/

进阶技巧

批量处理最佳实践

  1. 使用自动化工作流 — 在 UI 中创建处理流水线，避免重复操作
  2. 利用 REST API — 集成到脚本中，实现定时批量处理
  3. Docker Compose — 使用 Docker Compose 管理多实例部署

安全处理敏感文档

  1. 自托管部署 — 确保文件不离开你的服务器
  2. 启用 HTTPS — 使用反向代理配置 SSL
  3. 权限控制 — 配置用户认证和权限管理
  4. 审计日志 — 开启操作记录，追踪文件处理历史

与其他工具集成

  1. Webhook — 监听处理完成事件
  2. API 集成 — 将 PDF 处理嵌入现有工作流
  3. 自动化脚本 — 使用 curl 或 SDK 调用 API

总结

Stirling-PDF 是一款革命性的开源 PDF 工具平台，通过 50+ 种功能和自托管能力，让团队完全掌控自己的文档处理基础设施。无论你是个人用户、创业团队还是大型企业，Stirling-PDF 都能提供专业级的 PDF 处理工具，同时避免厂商锁定和订阅费用。

关键特性回顾：

  • 完全开源免费（MIT 许可证）
  • 50+ 种 PDF 工具
  • Docker 自托管部署
  • REST API 全面支持
  • 自动化工作流
  • 企业级 SSO 和审计
  • 40+ 语言界面
  • 83,600+ GitHub Stars

以上就是 Stirling-PDF 的完整介绍和使用指南。从一行 Docker 命令到企业级部署，你现在可以完全掌控自己的 PDF 处理流程了。现在就访问 Stirling-PDF GitHub 仓库 开始使用吧！

参考资料

如何引用本文：本文基于 Stirling-PDF GitHub 仓库（2026-06-24 验证）编写。所有命令和配置均与最新版本对照验证。同类项目数据来自 GitHub API（2026-06-24 查询）。