Stirling-PDF 中文版

简介

Stirling-PDF 是一个开源的本地部署型 PDF 处理平台，把签名、转换、合并、编辑、OCR、脱敏等 55+ 项工具集中在一个网页界面里。它针对的问题很明确：把合同、报销单、财报这类文件上传到不知名的在线网站处理，等于把内容交给了第三方。Stirling-PDF 通过 Docker 容器化或桌面应用跑在自己的机器上，文档不外发。适合需要批量处理 PDF 的个人、自托管爱好者，以及想用 API 把文档处理接进工作流的团队；核心优势是隐私优先、可自部署、功能覆盖广且完全免费开源。

核心功能

• 编辑、签名、脱敏（redaction）、转换与自动化：GitHub 项目页的描述是“在不把文档发送到外部服务的前提下完成 Edit、sign、redact、convert、automate”。
• 官方文档列出 55+ 项工具，覆盖签名、转换、合并、编辑、OCR 与脱敏六大类，入口按功能分区排列在界面里。
• 基础页面操作：拆分、合并、重新组织页面顺序、插入图片、旋转、压缩，多篇中文教程都逐一验证过这些功能。
• OCR 文字识别：可从 PDF 中抽取文字，有教程专门针对中文辨识场景做过测试。
• 格式与视觉调整：PDF 转图片、调整页面对比度、添加水印、批次重命名文件。
• Stirling Processor：官方文档列出的能力，用于连接数据源并自动化文档处理流程。
• API 调用：有实战内容演示通过接口批量处理上万份 PDF，可把多个步骤串成流水线。

使用场景

• 自托管在 NAS 或家用服务器上处理含个人信息的合同、发票，文件全程留在自己的设备里，不经过外部网站。
• 办公归档：把分散的几份 PDF 合并成一份报送文件，或把厚文件按章节拆分后再分发给同事。
• 扫描件整理：先用 OCR 抽取中文文字，再配合旋转与对比度调整，让扫描页面变得可读、可检索。
• 批量出图与改名：把一批 PDF 转成图片用于插入文档，同时按规则批次重命名，减少手工操作。
• 团队自动化：用 API 把脱敏、转换、合并串成流水线，处理量可以到上万份文件的级别。
• 个人桌面使用：Windows 桌面版适合不熟悉命令行的同事，从开始菜单启动即可进入同一套工具界面。

安装与获取步骤

1. 先确定部署形态：官方文档提供自托管（self-hosted）与桌面应用（desktop）两种部署选项，按使用人数和机器条件选择。
2. Docker 自托管路径：在 NAS 或服务器的镜像仓库里搜索“s-pdf”，找到官方镜像后下载，版本标签选择 latest；也有教程改用“自定义拉取”入口，具体菜单位置以你所用设备的界面为准。
3. Windows 桌面版路径：下载 Stirling PDF Desktop Installer，运行安装包并按提示逐步确认，默认写入 C:\Program Files\Stirling-PDF，完成后从开始菜单启动。
4. 资源参考：有用户在 4 vCores / 8G RAM / 16G SSD、系统为 Alpine3 + Docker Compose 的虚拟机上运行这套服务，可作为容量起点，实际需求以官方页面为准。
5. 部署完成后用浏览器访问对应地址，从首页或左侧功能分区进入具体工具；项目仓库与官方文档地址为 https://github.com/Stirling-Tools/stirling-pdf 和 https://docs.stirlingpdf.com/ 。

与同类方案的区别

和在线 PDF 网站相比，差别在于文档要不要离开本机：在线工具必须先上传，而 Stirling-PDF 的项目描述明确写了“without sending documents to external services”，核心理念是隐私优先，适合处理不便外传的文件。

和单点小工具相比，它把 55+ 项功能放进同一个界面，合并、OCR、脱敏这类连续动作不必在多个网站之间来回切换；再加上 API 能力，可以把重复操作串成固定流程。和桌面收费软件相比，它是完全免费开源的，同时提供网页端与桌面端，网页端方便局域网内多人共用一套功能。

注意事项

• 功能数量在不同来源口径不一：社交帖写 50+，官方文档写 55+ 工具，具体清单以官方页面为准。
• 镜像搜索结果可能不止一个，认准官方镜像；latest 标签指向的内容会随官方发布变化，以官方页面为准。
• OCR 的中文识别准确率取决于扫描件清晰度与版式复杂度，先拿一页样张验证效果，再批量处理整批文件。
• 部署到公网之前，访问控制、账号权限与数据备份需要自行规划，官方给出的部署选项不等于安全配置。
• 桌面版默认写入 C:\Program Files\Stirling-PDF，重装或迁移到别的目录时留意该路径。
• 这个项目最初由 ChatGPT 完全开发并持续演进，遇到具体报错优先查仓库与官方文档 https://docs.stirlingpdf.com/ ，必要时以官方页面为准。