日常办公与文档处理场景中，PDF 操作需求长期存在，合并扫描文件、压缩合同附件、转换论文格式、加密机密资料都是高频操作。市面上多数在线文档处理平台存在明显隐私隐患，上传的文件会留存至第三方服务商服务器，涉及身份证、财务报表、商业合同时极易造成信息泄露。付费商业软件存在订阅成本高、设备绑定限制多的问题，轻量免费工具功能单一，无法覆盖批量处理、OCR 文字识别、文档涂黑脱敏等进阶需求，大量用户长期缺少兼顾安全、完整功能与零成本的替代方案。

StirlingPdf 的出现补齐了私有化 PDF 处理工具的市场缺口，项目核心优势在于所有文件仅在本地内存临时处理，任务完成后自动清除临时文件，不会向外发送追踪或统计请求。项目整合六十余种文档处理功能，同时提供网页端可视化操作、桌面客户端、程序调用 API 三种使用途径，适配个人电脑、家庭服务器、企业内网等多种部署环境，无需专业开发能力即可完成搭建，平衡了易用性、数据安全与功能完整性，解决不同群体文档处理的各类痛点。

简介

StirlingPdf 是由 StirlingTools 团队开发的基于 Spring Boot 构建的本地网页端 PDF 处理程序，项目托管在 Github 仓库地址为
https://github.com/stirling-tools/stirling-pdf，采用 MIT 许可证，允许个人与企业无限制修改、分发与商用部署，不存在版权约束。项目底层封装 LibreOffice、Tesseract、Ghostscript、qpdf 等成熟文档工具，将复杂命令行操作整合为可视化交互界面，核心定位是打造一套完全自主可控、全功能覆盖的私有化文档工具箱，当前仓库累计 Star 数量突破六万，是全球范围内热度靠前的 PDF 自托管应用项目。

项目内置六十余项独立文档处理工具，功能划分为页面管理、格式互转、安全加密、内容编辑、批量自动化五大类别。页面管理支持合并、拆分、旋转、裁剪、重新排序、提取指定页面；格式互转实现 PDF 与 Word Excel PPT 图片 HTML 双向转换，附带 PDF/A 归档格式生成；安全模块包含文档加密解密、自定义水印、电子签名、敏感文字涂黑脱敏；内容编辑支持 OCR 多语言文字识别、文本批注、图片插入、破损 PDF 修复；特色流水线功能可串联多步操作形成固定工作流，同时配套完整 REST API 接口，支持与业务系统自动化对接，还提供深色模式、多主题自定义、用户权限管控、单点登录等配套企业级能力。

该项目适配多类真实应用场景，个人用户可部署在本地电脑处理简历、扫描证件、电子书转换，无需上传文件至外网；中小企业可搭建在内网服务器，批量处理合同、发票、财务报表，规避商业数据外泄风险；教育行业适用于论文格式转换、课件合并、扫描试卷文字提取；法律与医疗领域可完成涉密文档脱敏、隐私信息涂黑，满足数据合规要求；开发者可调用 API 将 PDF 处理逻辑集成进 ERP、自动化脚本、CI/CD 流水线，实现文档操作无人值守执行，离线内网环境同样能够完整运行全部功能。

使用

StirlingPdf 提供三种主流部署方案，Docker 容器部署为推荐方式，操作最简且跨平台兼容，下文以 Linux 服务器环境为例完整演示部署、初始化与文档实操流程，Windows 与 Mac 本地电脑可选用桌面客户端简化操作。

第一步，环境前置检查，服务器需提前安装 Docker 与 Docker Compose，执行以下命令验证环境状态

若未安装容器环境，Ubuntu 系统可执行安装指令

第二步，创建持久化配置目录，用于保存程序配置、用户账号与流水线模板，避免容器重建后数据丢失

第三步，单条命令快速拉取镜像并启动容器，标准镜像包含全部功能，适合绝大多数用户使用

资源受限设备可选用 ultra-lite 轻量化镜像，占用存储空间更低

第四步，容器启动完成后，浏览器访问地址 http://服务器IP:8080 进入操作页面，开启登录鉴权的镜像默认账号 admin，密码 stirling，首次登录强制修改登录密码，可通过环境变量自定义初始账号密码。

第五步，基础 PDF 合并实操演示，进入首页 Merge PDFs 工具，点击上传区域拖拽多个 PDF 文件，页面内支持拖拽调整文档顺序，完成排序后点击底部下载按钮，直接获取合并完成的新文件，全程文件仅在服务器内存处理，无持久留存。

第六步，进阶 OCR 文字识别操作，选择 OCR PDF 工具上传扫描版无文字图层文档，勾选所需识别语言，中文处理需提前挂载中文字库目录，执行识别后生成可复制文本的可检索 PDF，识别完成自动清理临时扫描缓存。

第七步，流水线自动化配置，首页打开 Pipelines 功能，依次添加拆分、压缩、加水印多步操作保存为模板，后续上传文件可一键执行整套流程，适合重复性批量文档处理工作。

第八步，程序调用 API 使用，访问地址
http://IP:8080/swagger-ui/index.html 查看全部接口文档，配置专属 API Key 后可通过 curl 命令远程触发文档处理，示例基础调用格式

Windows 本地个人使用无需容器，直接下载官方桌面安装包，双击安装后打开客户端，本地离线处理所有 PDF，无需依赖浏览器与服务器环境，功能与网页端完全同步，支持双击本地 PDF 文件直接唤起程序编辑。

总结

StirlingPdf 整合了市面上绝大多数 PDF 处理需求，依靠本地文件处理机制建立核心安全壁垒，覆盖从基础页面调整到企业级权限管控、自动化流水线、程序接口调用的全层级能力。项目摒弃商业软件的付费门槛与在线工具的数据泄露风险，同时兼顾轻量化部署与丰富功能，多镜像版本适配低配主机与生产服务器，可视化界面降低操作门槛，普通办公人员无需命令行基础即可独立完成各类文档操作，底层依托成熟开源工具保证处理稳定性，OCR、格式转换、文档修复等功能处理效果达到主流商业软件同等水平。

该项目拥有广泛长期的应用拓展价值，个人群体可永久免费搭建私有文档处理工具，彻底摆脱各类在线平台的文件上传限制与隐私焦虑；企业单位可在内网私有化部署，构建符合数据合规标准的内部文档处理服务，无需采购昂贵商用授权；技术开发者可依托开放 API 搭建自动化文档处理链路，嵌入业务系统实现报表、合同自动格式化归档。持续更新的迭代版本不断补充新工具与适配优化，社区提供完善文档与交流渠道，是兼顾安全、成本、功能的通用 PDF 处理解决方案，具备长期替代付费商业软件与第三方在线工具的实用价值。