3分钟部署Stirling-PDF：Windows/Linux/macOS跨平台安装对比指南
项目地址: https://gitcode.com/gh_mirrors/st/Stirling-PDF 你是否还在为不同操作系统上部署PDF工具而烦恼？本文将对比Windows、Linux和macOS三大平台的Stirling-PDF部署方案，通过Docker与原生安装两种方式，帮助你快速搭建这款功能强大的本地PDF处理工具。
项目概述
Stirling-PDF是一款开源本地部署的PDF全功能处理工具，支持50+种PDF操作，包括合并、拆分、转换、压缩、OCR识别等。所有文件处理均在本地完成，确保数据安全性。官方文档：README.md，项目主页截图：
核心功能模块：
- PDF操作核心：app/core/src/main/java/stirling/software/SPDF/
- 公共工具类：app/common/src/main/java/stirling/software/common/util/
- 配置文件：exampleYmlFiles/
跨平台部署方案对比
准备工作
所有平台部署前需确保：
- Git已安装：用于克隆仓库
- JDK 17+：原生部署需要，Docker方式无需
- Docker环境：推荐使用，简化依赖管理
克隆项目仓库：
git clone https://gitcode.com/gh_mirrors/st/Stirling-PDF
cd Stirling-PDF
Docker部署（推荐）
Docker方式实现跨平台一致部署，支持三种镜像版本：
- 完整版：包含所有功能
- Ultra-Lite：仅基础PDF操作
- Fat：预安装额外字体和库
Linux/macOS Docker部署
使用官方示例配置文件：exampleYmlFiles/docker-compose-latest.yml
docker-compose -f exampleYmlFiles/docker-compose-latest.yml up -d
Windows Docker部署
需使用WSL2后端，运行命令：
docker-compose -f exampleYmlFiles/docker-compose-latest.yml up -d
访问 http://localhost:8080 即可使用，默认界面：
原生部署
Linux原生部署
- 安装依赖：
sudo apt update && sudo apt install -y openjdk-17-jdk libreoffice qpdf tesseract-ocr
- 构建运行：
./gradlew clean build
./gradlew bootRun
macOS原生部署
- 安装依赖：
brew install openjdk@17 libreoffice qpdf tesseract
- 构建运行：
./gradlew clean build
./gradlew bootRun
Windows原生部署
- 安装JDK 17和LibreOffice
- 设置环境变量：
JAVA_HOME指向JDK安装路径 - 执行命令：
gradlew clean build
gradlew bootRun
部署方式对比表
| 部署方式 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| Docker | 环境一致、依赖少、升级方便 | 资源占用较高 | 服务器部署、多平台兼容 |
| 原生部署 | 资源占用低、自定义性强 | 依赖复杂、易出环境问题 | 开发调试、资源受限设备 |
高级配置
安全设置
启用登录认证功能，使用安全版配置文件：exampleYmlFiles/docker-compose-latest-security.yml，部署后登录界面：
OCR语言包配置
默认仅安装英文OCR语言包，添加其他语言：HowToUseOCR.md
Debian/Ubuntu系统：
sudo apt install -y tesseract-ocr-chi-sim # 安装中文简体
Windows系统需手动下载语言包并配置：
system:
tessdataDir: C:/Program Files/Tesseract-OCR/tessdata
性能优化
修改配置文件调整最大文件大小和内存限制：
system:
maxFileSize: "100" # MB
maxDPI: 300 # 图片转换DPI
常见问题解决
服务启动失败
检查端口占用情况，修改配置文件中的server.port参数。日志文件路径：logs/application.log
OCR功能不工作
确认Tesseract安装正确：HowToUseOCR.md
tesseract --list-langs
Docker权限问题
Linux系统需添加用户到docker组：
sudo usermod -aG docker $USER
总结
Stirling-PDF提供了灵活的跨平台部署方案，推荐优先使用Docker方式以获得最佳兼容性。对于不同操作系统，部署步骤略有差异但核心流程一致。通过本文介绍的配置方法，可快速搭建适合自身需求的PDF处理服务。更多高级功能配置请参考：DATABASE.md和devGuide/DeveloperGuide.md。
项目支持40+种语言，包括简体中文（91%完成度），欢迎参与翻译贡献：devGuide/HowToAddNewLanguage.md。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
