Stirling-PDF 使用教程
从入门到精通的完整指南
Stirling-PDF 简介
Stirling-PDF是开源的自托管PDF工具箱，基于Java和Spring Boot构建，提供超过40种PDF操作功能。用户可以通过Web界面完成PDF合并、拆分、压缩、转换、加密、水印、OCR识别等常见操作，所有处理均在本地服务器完成，文档不会上传到外部服务。Stirling-PDF支持Docker一键部署，界面简洁直观，支持多语言和暗色主题。该工具特别适合对数据安全有要求的企业和组织，能够替代多种在线PDF工具，既保护了文档隐私，又提供了强大的处理能力。项目在GitHub上拥有超过5万Star，是目前最受欢迎的开源PDF处理工具之一，采用AGPL-3.0许可证。
详细功能介绍
【工具简介】Stirling-PDF是开源自托管PDF工具箱，提供40余种PDF处理功能，所有操作在本地完成保障数据安全。
【核心功能】
①PDF格式转换：支持PDF与Word、Excel、图片、HTML等多种格式互转，基于LibreOffice和OCR引擎实现高质量转换。
②页面操作管理：提供PDF合并、拆分、旋转、裁剪、重排页面等功能，支持按页码范围或书签进行批量处理。
③安全与权限控制：支持PDF加密解密、添加水印、数字签名、设置权限密码，保护敏感文档安全。
④OCR文字识别：集成Tesseract OCR引擎，可将扫描版PDF转换为可搜索和编辑的文本PDF，支持100多种语言。
⑤批量并行处理：支持同时上传多个文件进行批量操作，利用多线程加速处理，提升大量文档的处理效率。
【适用场景】
企业内部部署PDF处理服务，替代在线PDF工具避免敏感文件外传，满足合规和数据安全要求；行政部门批量处理合同、报表等文档，利用合并拆分和水印功能提高工作效率；档案数字化项目中使用OCR功能将大量扫描文档转为可搜索的电子档案。
【快速入门】
①安装部署：使用Docker命令一键启动，执行docker run -d -p 8080:8080 frooodle/s-pdf即可访问Web界面。
②选择功能：在首页浏览或搜索所需功能，如合并PDF、PDF转图片、添加水印等。
③上传处理：拖拽或选择文件上传，配置处理参数后点击执行，等待处理完成。
④下载结果：处理完成后自动下载结果文件，也可在历史记录中重新下载。
【优缺点分析】
优点：完全自托管保障数据隐私，文档不离开本地服务器；功能全面覆盖日常PDF处理需求，可替代多个在线工具；Docker部署简单，界面友好支持多语言。
缺点：OCR和格式转换依赖底层引擎，部分复杂排版转换效果有限；大文件处理时内存占用较高，需要合理配置服务器资源；不具备在线协作编辑能力，定位为工具而非文档平台。
【适合人群】
注重数据安全的企业和组织，需要在内网环境中处理PDF文档；行政和文秘人员，日常需要大量处理合同、报告等PDF文件；IT运维人员，为团队搭建统一的文档处理服务平台。
1Stirling-PDF 入门教程：自托管的全能 PDF 工具箱
入门10分钟
Stirling-PDF 是开源的自托管 PDF 工具箱，基于 Java 构建，提供超过 40 种 PDF 操作功能，所有处理均在本地完成，文档不会上传外部服务，特别适合注重数据安全的企业。
一、快速开始
1. 确保已安装 Docker，运行 docker --version 确认环境就绪。
2. 一行命令启动：docker run -d -p 8080:8080 -v ./data:/usr/share/tessdata frooodle/s-pdf:latest。
3. 浏览器访问 http://localhost:8080，即可看到功能齐全的操作界面。
4. 无需注册账号，打开即用。如需中文界面，点击右上角语言切换选择简体中文。
二、核心功能演示
功能1：PDF 合并与拆分
合并：点击首页的「合并 PDF」，上传多个 PDF 文件，拖拽调整顺序，点击合并即可生成一个完整文件。拆分：选择「拆分 PDF」，可以按页码范围拆分（如1-5页、6-10页），也可以在指定页码处切割成多个文件，操作简单直观。
功能2：PDF 格式转换
点击「PDF 转换」相关功能，支持 PDF 转 Word、PDF 转图片、图片转 PDF、PDF 转 HTML 等多种格式互转。上传文件后选择目标格式，系统自动完成转换并提供下载链接。转换质量在同类开源工具中属于上乘。
功能3：PDF 加密与水印
选择「加密 PDF」可为文件添加密码保护，设置打开密码和权限密码。选择「添加水印」可以插入文字或图片水印，自定义水印的位置、大小、透明度和旋转角度，有效保护文档版权。
三、实际使用案例
案例1：合同签署前的文档处理
HR 部门需要将多份合同扫描件合并为一个 PDF，添加公司水印，再加密后发送给签署方。使用 Stirling-PDF 可以在一个界面内依次完成合并、加水印、加密三步操作，全程文档不离开本地服务器，确保合同内容安全。
案例2：批量格式转换
市场部门收到一批产品图片需要制作成产品手册 PDF，同时把供应商提供的 PDF 规格书转成 Word 进行编辑。通过 Stirling-PDF 的批量转换功能，可以一次性处理多个文件，无需逐个操作，大幅节省时间。
四、常见问题 FAQ
Q1：文件大小有限制吗？
A：默认支持上传最大 100MB 的文件，可以在环境变量中调整 MAX_FILE_SIZE 参数来修改限制。处理大文件时建议确保服务器内存充足。
Q2：OCR 识别功能怎么用？
A：需要先下载语言包（tessdata）放到数据目录中，然后使用「OCR PDF」功能即可对扫描件进行文字识别。中文识别需要下载 chi_sim.traineddata 中文语言包。
Q3：多人可以同时使用吗？
A：可以，Stirling-PDF 支持多用户并发访问，但同时处理大量文件时可能影响性能。如需用户权限管理，可以部署企业版或在前端加装 Nginx 认证。
五、小贴士
1. 使用 Docker Compose 部署更方便管理，可以配置数据持久化和自动重启，避免容器更新后数据丢失。
2. 如果经常使用某个功能，可以将常用工具添加到收藏夹，首页会优先显示，提升操作效率。
3. 处理敏感文档时，建议在 docker-compose.yml 中关闭健康检查上报功能，确保所有数据完全在内网环境中处理。