NAS本地部署Stirling PDF，实现PDF文件免费编辑和OCR识别

今天分享一个免费 PDF 编辑器，支持在 NAS 上 Docker 部署。

这个项目名字叫 Stirling-PDF，是个 8.6 万星的开源项目，有 60 多个全免费的 PDF 处理功能。

文件都在 NAS 本地处理，隐私友好。

Stirling-PDF 还内置了 MCP 接口，可以直接连到任意 AI Agent，让 AI 助手帮我们操作。

主界面非常清晰简单。

在 NAS 上部署后，就可以使用了。

目录：

○ Stirling-PDF 能干什么？ ○ 通过 Docker Compose 部署到 NAS ○ 实现 OCR 识别和 PDF 文本编辑 ○ 通过 MCP 服务接入 AI Agent

Stirling-PDF 能干什么？

我们工作中难免对 PDF 文件进行添加、删除、拆分等操作，但又不是天天做。

几个最常用的功能：

（1）页面操作：

合并多个 PDF、拆分单页、提取指定页面、旋转、裁剪。这基本上覆盖日常工作中需要的场景了。

（2）格式转换：

PDF 与 Word/Excel/PPT/图片相互转换。我试了把 Hermes Studio 的帮助文件 PDF 转为 Word。

（3）OCR 文字识别和 PDF 文字编辑：

扫描版 PDF、图片 PDF 转换为能修改文本的 PDF 文件。可以直接在 Stirling-PDF 中编辑文本，也可以识别后转换为 Word 文档。

这个功能配置稍微麻烦些，具体配置方法下面详说。

（4）编辑和标注：

加文字、加图片、加水印、加页码、加签名。合同盖章不用再打印出来签完再扫描了，直接在 PDF 上签名就行。

（5）安全和压缩：

加密解密、加密码、压缩体积。有些 PDF 动辄几十 MB，压缩一下几 MB 搞定，微信发起来也快。

（6）其他功能：

我看到 Stirling-PDF 几乎支持所有 PDF 文件编辑功能，已经算是非常全面的 PDF 编辑工具了。

我们日常用到的可能也就 10 来个功能，但现在这 60 多个功能都放在那，需要的时候心里不慌。

这种安心感是花钱才能买到的。现在免费提供。

通过 Docker Compose 部署到 NAS

NAS 本地部署非常简单。绿联 NAS 支持 Docker Compose，把下面这段粘进去就行：

version: '3.3' services: stirling-pdf: image: stirlingtools/stirling-pdf:latest container_name: stirling-pdf restart: unless-stopped ports: - "8750:8080" # 冒号前面的前端端口随便改 volumes: - ./trainingData:/usr/share/tessdata - ./extraConfigs:/configs - ./customFiles:/customFiles - ./logs:/logs environment: - SYSTEM_DEFAULT_LOCALE=zh-CN - DOCKER_ENABLE_SECURITY=false

点"部署"，等镜像拉取完，浏览器打开 NAS_IP:端口号 就能看到界面了。

首次打开，用默认用户名 admin 和密码 stirling 登陆。

登陆后会要求修改密码。

实现 OCR 识别和 PDF 文本编辑

Stirling-PDF 的 OCR 功能用的是 Tesseract 引擎，使用前需要手动下载。

打开 设置-高级，在下载更多 tessdata 语言中选择图中的几个语言包，点击 下载所选语言，就会出现下载连接，我们点击这些连接逐个下载。

下载后，把文件放在 trainingData 目录下。

我们选择一个扫描版的 PDF （没有文本对象）试试效果，在右侧设置好语言，点击处理OCR并预览。

处理过后，我们就得到一个含有文本对象的 PDF，接下来，我们就可以用PDF文本编辑器功能进行文本编辑了

转换需要一些时间，稍等片刻。

转换过后，可以直接对 PDF 文件进行文本编辑了，效果非常不错。

通过 MCP 服务接入 AI Agent

这个工具还可以接入 AI Agent。

（1）打开 MCP 服务器，鉴权形式改为 API Key

在左边栏右下角打开 设置-MCP Server，选中 Enable MCP Server。

鉴权模式默认是 OAuth，但是需要额外部署 OAuth 服务器，比较麻烦，还吃资源。

所以个人用户建议直接选 API Key 模式。在 Authentication mode 一栏选择 API Key。

修改后需要重启容器，去 Docker 管理器手动重启一下，再刷新页面。

（2）获得 API Key

AI Agent 需要通过 API 来与 Stirling PDF 对接。

在 设置-API密钥 中，找到 API Key，点击 复制。或者你也可以点击 刷新 换一个随机秘钥。

（3）与 AI Agent 通信

把 MCP 地址（ http://NAS_IP:端口号/mcp ）和 API Key 告诉 AI Agent，他们就能建立连接了。

让 Hermes 把 MCP 接入 config 后，需要重启 Hermes 服务。

重启后 Hermes 就可以调用 Stirling-PDF 的服务了。

真实感受

试用了 Stirling-PDF，我觉得已经满足了我对 PDF 文件编辑的所有需求。

整个工具没有广告、不需付费、可以完全本地跑、界面简洁、中文界面完成度在 90%以上。

我现在日常 PDF 处理，比如两分钟内能搞定的合并、拆分、添加页面、删减页面、压缩、OCR这种活全交给它，不值得为这种事另外花钱。