🔧 Stirling-PDF：一个功能强大的开源 PDF 编辑平台离线PDF万能瑞士军刀

📌 还在为处理一份PDF需要同时打开好几个网站而烦恼吗？📌 还在担心将公司合同、私人简历上传到那些来路不明的在线工具会泄露隐私吗？今天，给大家介绍一款在GitHub上狂揽 74k+ Star 的神器——Stirling-PDF。它就像一把全功能的瑞士军刀，而且是放在你自己口袋里（服务器上）的那种。

🤔 什么是 Stirling-PDF？

Stirling PDF 是一个功能强大的开源 PDF 编辑和处理平台。你可以把它想象成一个可以完全离线运行的“I Love PDF”或“Smallpdf”，但它比这些工具更强大、更自由、更安全。

📦 核心亮点：一个 Docker 镜像集成了合并、拆分、旋转、OCR（识别文字）、添加水印、格式转换等 50 多个功能。

🔒 推荐理由：完全本地运行，不经过任何云端服务器。支持通过宝塔面板一键部署，是家庭服务器/VPS 的装机必备。您可以将其作为个人桌面应用程序在浏览器中运行，也可以将其部署在您自己的服务器上并使用私有 API。无需将文档发送到外部服务，即可编辑、签名、编辑、转换和自动化处理 PDF 文件。

它最初可能只是一个简单工具集合，但现在已发展成一个包含企业级功能（如两步验证2FA、SSO单点登录）的完善平台。

✨ 核心亮点：为什么是“万能瑞士军刀”？

Stirling-PDF 的功能多到令人发指，但我们可以把它们整理成几个大类，方便你理解它的强大：

🔪 基础页面操作

✂️ 合并与拆分：支持按页数、按章节、按奇偶页智能拆分多个PDF，或者将多个文档无缝合并。
🔄 旋转与裁剪：调整页面方向，裁剪多余的白边（甚至可以自动裁剪检测到的边框）。
📌 重排与提取：像玩扑克一样重新排列页面顺序，或者提取出你需要的特定页面。

🔄 格式转换

📄 Office 互转：PDF ↔ Word、PowerPoint、Excel。
🖼️ 图片互转：PDF ↔ 各种图片格式 (JPG, PNG等)。
🌐 网页 & 电子书：HTML、Markdown、甚至EPUB、MOBI等电子书格式，都可以轻松转换为PDF。

🔐 安全与保护

🔑 权限控制：为PDF添加或移除打开密码，限制他人打印、编辑。
💧 数字水印：添加文字或图片水印，保护你的版权。
🚫 敏感信息脱敏 (Redaction)：这是企业级功能！可以手动或自动地永久擦除文档中的敏感信息（比如身份证号、银行账号），这可不是简单用黑条盖住，而是彻底删除。
🖋️ 数字签名：用证书给你的文档签名，确保其真实性和完整性。

🚀 高级编辑与增强

📝 OCR文字识别：这是最受欢迎的功能之一！它能识别扫描件或图片型PDF中的文字，生成可搜索的文本层。支持40多种语言，当然也包括简繁中文。
🏷️ 元数据编辑：修改或清除文档的作者、标题等信息。
🔍 比较文档：并排比较两个PDF文件的差异。
🎨 颜色处理：替换或反转PDF的颜色，对于深色模式阅读或节省打印机墨水很有用。

⚡ 自动化与最新功能

⚙️ 自定义管道 (Pipeline)：你可以设定一个工作流，比如“扫描PDF → OCR识别 → 压缩 → 添加水印”，然后一键执行，无需手动操作每一步。
📱 手机扫描联动：最新版本支持手机扫描二维码直接上传照片进行边缘检测和纠偏，然后生成PDF。
🔐 双因素认证 (2FA)：如果你把它部署在公网，现在可以开启2FA，安全性拉满。

🆚 同类工具对比：它强在哪？

市面上的PDF工具很多，Stirling-PDF凭什么脱颖而出？我们来简单对比一下：

🛠️ 工具	✅ 优势	❌ 劣势
Stirling-PDF	完全免费、开源、本地部署隐私第一、功能超50+、Docker一键部署、支持自动化。	对现有文本的直接编辑能力较弱（主要是添加而非修改）、某些功能（如OCR）需要额外配置。
🌐 在线工具 (如 iLovePDF)	方便快捷，无需部署。	严重隐私风险，文件需上传至他人服务器，有大小限制，付费解锁更多功能。
💼 Adobe Acrobat Pro	功能最强，编辑能力无可匹敌。	价格昂贵，闭源，对普通用户来说性能过剩。
🧩 PDF24 / Sejda	功能强大，有桌面版。	桌面版功能可能不如在线版全，部分高级功能需付费。
📐 LibreOffice Draw	免费开源，集成在办公套件中。	界面老旧，处理复杂排版时可能错乱，启动慢。
✂️ PDFSam Basic	专注于拆分合并，简单好用。	功能单一，缺乏编辑、OCR等高级功能。

结论：如果你对隐私有极高要求，或者需要自动化处理PDF任务，Stirling-PDF是目前开源社区里几乎唯一的选择。它的优势不在于精美的UI，而在于“我的数据我做主”的安全感和不断扩展的功能广度。

🎯 哪些用户适合此软件？

👤 注重隐私的个人用户：不想把自己的简历、银行账单、扫描的身份证上传到不明网站的人。
🛠️ 极客和家庭实验室玩家：喜欢在自己的NAS或树莓派上捣鼓各种服务，享受“私有化部署”乐趣的爱好者。
🏢 中小企业/工作室：需要处理内部合同、发票等敏感文档，但又没有预算购买昂贵的Adobe全家桶。可以把它部署在内网服务器上，供整个团队使用。
👩‍💼 频繁与PDF打交道的办公人员：需要合并报告、拆分合同、转换格式，一个工具搞定所有，不用再求人安装软件。
🧑‍💻 开发者：需要通过API将PDF处理功能集成到自己的应用中。

🚀 下载、安装与部署（超详细版）

Stirling-PDF 提供了多种安装方式，从最简单的桌面版到最灵活的服务器版，这里给大家一一介绍。
项目地址：https://github.com/Stirling-Tools/Stirling-PDF
官方网站：https://www.stirling.com/

💻 方法一：直接下载桌面版（最简单，适合单机用户）

如果你想在自己的Windows或Mac电脑上像普通软件一样使用它，可以直接下载桌面版。

🔗 访问项目的 Releases 页面。
⬇️ 下载对应系统的安装包，例如 Stirling-PDF-win-installer.exe (Windows) 或 .dmg (Mac)。
🖱️ 双击安装，一路“下一步”即可。安装后会在本地启动一个服务，并自动打开浏览器访问它。

🐳 方法二：Docker 部署（最推荐，适合服务器/NAS/长期使用）

这是Stirling-PDF官方最推荐的部署方式，也是发挥其全部威力的最佳途径。无论你是用群晖NAS、威联通，还是安装了宝塔面板的VPS，只要支持Docker，就可以轻松搞定。

📋 第一步：准备工作
确保你的系统已经安装了 Docker 和 Docker Compose。

📝 第二步：创建 docker-compose.yml 文件
在你喜欢的地方创建一个文件夹（例如 stirling-pdf），然后在里面新建一个文件，命名为 docker-compose.yml，将以下内容复制进去：

version: '3.3'
services:
  stirling-pdf:
    image: docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest
    container_name: Stirling-PDF
    ports:
      - "8080:8080" # 左边的8080可以改成你喜欢的任何未占用端口，比如 8888
    volumes:
      - ./trainingData:/usr/share/tessdata:rw # 挂载OCR语言包目录
      - ./extraConfigs:/configs:rw             # 挂载配置文件目录
      - ./logs:/logs:rw                         # 挂载日志目录
    environment:
      - DOCKER_ENABLE_SECURITY=false            # 是否开启登录功能，false为关闭
      - SECURITY_ENABLELOGIN=false              # 与上面对应
      - SYSTEM_MAXFILESIZE=100                   # 允许上传的最大文件大小（MB）
    restart: unless-stopped

▶️ 第三步：启动容器
打开终端，进入 docker-compose.yml 所在的目录，运行命令：

docker-compose up -d

Docker 会自动拉取镜像并启动服务。

🌐 第四步：访问使用
在浏览器中输入 http://你的服务器IP:8080 (或者你修改的端口)，就能看到Stirling-PDF那简洁明了的操作界面了！🎉

⚙️ 高级配置：

🔒 开启登录和HTTPS：如果你想把服务暴露在公网，强烈建议修改 environment，将 SECURITY_ENABLELOGIN 设为 true，并配合Nginx反向代理配置HTTPS证书。最新版还支持2FA，让你的服务固若金汤。

🌏 添加OCR中文支持：默认容器只有英文OCR包。要支持中文，可以进入容器或通过挂载卷手动下载中文包：

# 进入容器（假设容器名是 Stirling-PDF）
docker exec -it Stirling-PDF wget https://github.com/tesseract-ocr/tessdata_fast/raw/main/chi_sim.traineddata -P /usr/share/tessdata

然后重启容器。

🧩 方法三：通过宝塔面板一键部署

如果你是宝塔面板用户，可以在面板的“Docker”界面中，直接搜索 stirling-pdf 镜像，然后创建容器，设置好端口映射和目录挂载即可，操作非常直观。

💡 使用技巧与进阶玩法

🌐 切换中文界面：登录后，点击右上角的⚙️设置图标，在“Language”下拉菜单中选择“中文 (简体)”即可。
🔍 OCR识别：上传一个扫描件PDF，在左侧导航栏找到“OCR”功能。选择你需要的语言（如果你已经添加了中文包），点击“应用OCR”即可。处理完成后下载的文件就是带可搜索文本层的PDF了。
📦 批量处理：大部分功能都支持批量上传文件，比如合并、转换图片等，大大提高效率。
🤖 利用Pipeline自动化：如果你每天都有固定的PDF处理流程，一定要研究一下“Pipeline”功能。它可以帮你省下大量重复劳动的时间。
📡 通过API调用：开发者可以访问 /swagger-ui/index.html 查看API文档，将Stirling-PDF的强大功能无缝集成到你自己的系统中。

🏁 总结

Stirling-PDF 不仅仅是一个工具，它代表了一种“隐私优先”的软件使用理念。它用开源的方式，将原本需要付费或冒着风险才能使用的功能，安全、自由地交到了每个用户手中。

无论你是为了保护个人隐私，还是为了提升团队协作的效率，花上几分钟部署一个 Stirling-PDF，绝对是一笔值得的“投资”。赶紧去你的服务器上试试吧！