Stirling-PDF 概览与指南：本地与私有化部署的全能 PDF 平台

是什么

Stirling-PDF 是一款开源且采用开放核心（Open-Core）模式的软件平台，专为查看、编辑、格式转换以及自动化处理 PDF（Portable Document Format）文件而设计。该平台的核心目标是让个人与组织拥有对自身文档处理流程的完全控制权。用户无需将敏感记录、法律合同或私人文件上传至第三方云端工具，Stirling-PDF 直接在本地设备或私有化部署的基础设施中处理各类文件。

根据项目 README 的介绍，Stirling-PDF 是一套多合一的 PDF 编辑环境，支持在多种环境下灵活部署：它既能作为独立桌面客户端运行在个人工作站上，也能通过常规网页浏览器直接访问，还可以作为集中式的私有化服务器运行并提供专属 API（应用程序编程接口）。通过在私有环境中运行该软件，个人和团队无需将机密材料发送给外部服务，即可安全地完成编辑、签署、脱敏涂黑以及格式转换等操作。

能做什么

该平台拥有极为丰富的文档处理工具集。其项目 README 中列出了 50 多个 PDF 工具，官方文档更详细说明了 60 多种独立操作。这些功能覆盖了日常的常规文档修改、高级排版以及大规模自动化数据流水线。

在日常页面管理方面，用户可以将多份文档合并为单一文件，把大文件拆分成多个片段，还可以调整页面顺序、旋转页面方向或直接删除多余页面。此外，软件还提供了内容阅读与批注、交互式电子表单填写、双 PDF 文档并排对比查看差异，以及文档压缩以节省存储空间等功能。针对纸质文件，它还提供了移动扫描工具，方便将纸质材料快速录入为电子文档。

在格式转换方面，Stirling-PDF 支持 PDF 与多种格式相互转换，例如将 PDF 文档转换为漫画档案格式（PDF 转 CBR），并通过集成 LibreOffice 来处理常见的办公文档格式。平台还具备光学字符识别（OCR）功能——这项技术可以扫描印刷体或手写文本的图片，将其转换为可搜索、可选中的数字化文字，并支持多种语言的文字识别。

在安全性与脱敏功能方面，软件允许用户在分发文档前永久抹除或涂黑敏感文字与图像。用户还可以添加数字签名与基于证书的签名，以验证文档的完整性与真实性。

面对更高吞吐量的业务场景，Stirling-PDF 提供了名为 Stirling Processor 的自动化流水线工具。团队无需编写代码，直接在网页界面中即可配置自动化处理流程，实现对成千上万乃至数百万份文档的批量录入、分类、标准化、安全加固与定向分发。同时，平台还融入了现代人工智能（AI）功能，不仅包含 AI 助手，还能对接外部 AI 模型供应商，并支持检索增强生成（RAG，一种让 AI 系统引用外部文档来精准回答问题的技术）。借助其提供的模型上下文协议（MCP，Model Context Protocol）服务器，像 Claude、GPT 这样的自主 AI Agent 能够直接调用 Stirling-PDF 的各类工具执行文档操作。

针对企业级管理需求，该平台支持基于 OAuth、OpenID Connect（OIDC）或 SAML 的单点登录（SSO），允许员工使用集成的企业凭证统一登录。此外，它还配备了详尽的审计日志、服务端请求伪造（SSRF）防护、Fail2Ban 安全监控、服务器集群部署能力、用量监控，并支持与 Google Drive、本地监控处理文件夹以及 Telegram 机器人等外部存储与服务进行集成。其操作界面已翻译为 40 多种语言。

怎么开始

根据个人需求与基础设施条件的不同，Stirling-PDF 提供了多种上手方式。官方文档总结了三种主要的开始途径：

1. 云端使用：用户无需安装本地依赖，也无需维护服务器基础设施，直接通过网页浏览器访问 Stirling Cloud 即可使用。
2. 桌面客户端：用户可以在 Windows、macOS 或 Linux 电脑上安装桌面版编辑器。该版本完全在离线环境下运行，确保所有文件严格保留在本地设备上。
3. 服务器私有化部署：组织机构可将 Stirling-PDF 托管在自有的基础设施中，支持从容器化系统到物理裸机安装等多种部署方式。

对于使用 Docker（一种将应用程序打包至标准化、隔离容器中的软件平台）进行服务器部署的用户，项目 README 提供了一条快速启动命令：

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

容器启动运行后，打开网页浏览器并访问以下地址即可进入用户界面：

http://localhost:8080

在更大规模的生产环境中，官方文档提供了使用 Kubernetes 进行容器编排部署，或者在物理裸机服务器上直接运行独立 JAR（Java 归档）文件的详细指引。如果开发者希望参与代码贡献或在本地编译项目，可以使用该项目采用的命令运行工具 Task：执行 task dev 即可启动编辑器开发环境，执行 task 则会列出常用的构建与开发命令。社区交流活跃在其 Discord 服务器中，问题与缺陷报告可通过 GitHub Issues 提交。

价格与门槛

Stirling-PDF 采用开放核心模式运作，其核心应用代码遵循开源条款发布在代码仓库中。此外，项目也提供了商业化方案，包括 Stirling Cloud 云服务方案、团队计费方案，以及专为需要托管部署与技术支持的成长型机构打造的专用 Server Plan 与 Enterprise 企业方案。

由于订阅层级、商业功能及授权选项可能会随时间调整，具体价格与方案请以官方页面为准。读者可以访问 Stirling PDF 官方文档 站点获取最新详情。

运行环境门槛取决于所选的安装方式。桌面客户端可在主流的现代操作系统（包括 Windows、macOS 和 Linux）上直接本地运行；自建服务器环境则需要能够运行 Docker 容器、托管 Kubernetes 集群或执行基于 Java 的 JAR 文件。根据所启用的具体功能，管理员可能还需要配置外部数据库、挂载本地共享目录或接入 Google Drive 等云存储账户，并安装 LibreOffice 依赖项以支持文档格式转换。

适合谁

Stirling-PDF 适合各类追求文档处理灵活性与数据掌控权的用户与组织：

• 个人用户与注重隐私的人群：日常需要频繁查看、批注、合并、拆分或签署 PDF 文件，且倾向于在离线或私密界面中操作，不愿将私人文件上传至公共在线转换工具的用户。
• 企业与受监管行业机构：对数据隐私有严苛要求、必须依靠本地私有化部署、单点登录（SSO）认证与审计日志来满足内部安全合规规范的公司、律所及各类机构。
• 运营与流程管理团队：需要处理大量输入文件，并希望通过无代码流水线快速实现文档分类、标准化排版与高效分发的团队。
• 软件开发者：希望通过 REST API 和处理流水线 API，在自有应用程序中集成 PDF 编辑、内容提取或格式转换能力的工程师。
• AI 开发者与 Agent 集成者：正在构建自主 AI Agent，并希望将 Claude、GPT 等模型连接至私有模型上下文协议（MCP）服务器以自动化执行文档任务的开发者。

替代品

PDF.js 是一款由开源社区驱动的项目平台，专为在网页浏览器中解析和渲染 PDF 文件而设计。

qpdf 是一款开源的命令行工具与 C++ 函数库，主要用于在保持文档内容完整的前提下对 PDF 进行结构性转换。

来源

• Stirling-Tools/Stirling-PDF
• Stirling PDF Documentation
• PDF.js
• qpdf