最近在 GitHub Trending 上刷到一款宝藏项目，一周涨星直接冲上榜首——它就是 Stirling-PDF。一个完全开源、本地化部署的 PDF 全能编辑器，今天详细聊聊怎么把它装到 NAS 上，并且接入 AI 帮我们干活。
为了让阅读更轻松，先放个小目录，大家按需跳读：
- Stirling-PDF 到底能干啥？
- Docker Compose 一键部署到 NAS
- OCR 识别 + PDF 文本编辑实战
- 通过 MCP 协议接入 AI Agent
- 真实使用感受总结
部署完成后，从浏览器打开 NAS IP 加端口，上传、编辑、下载一气呵成，文件全程都在你自己的 NAS 硬盘里。
一、Stirling-PDF 到底能干啥？
日常办公中难免要改 PDF：合并几份报告、抽几页出来、转成 Word 改文字、压缩一下发微信……但这种活儿又不是天天有，专门买 Acrobat、WPS 会员，或者上传到某些在线网站处理，总觉得亏。
Stirling-PDF 刚好补上了这个空白。打开它的首页，右边栏整整齐齐排着 60 多个工具，按类别划分。我挑几个最高频的给大家过一遍：
1. 页面操作类
合并多个 PDF、拆成单页、抽取指定页码、旋转方向、裁剪边距——基本上日常工作 90% 的场景都能覆盖。
2. 格式转换类
PDF 与 Word、Excel、PPT、图片之间互转。我亲自试过把 Hermes Studio 的帮助手册 PDF 转成 Word，排版还原度相当惊喜。
3. OCR 文字识别 + 文本编辑
扫描版 PDF、图片型 PDF 经过 OCR 处理后，会变成"可复制、可编辑"的 PDF，可以直接在 Stirling-PDF 里改文字，也可以再转成 Word。这块配置稍微复杂一点，后面单独开一节讲。
4. 编辑与标注类
添加文字、插入图片、批量加水印、自动加页码、电子签名。合同要签字？直接在 PDF 上签名就行，再也不用打印 → 手签 → 扫描。
5. 安全与压缩
加密、解密、设置密码、压缩体积。几十 MB 的 PDF 压完往往就剩几 MB，发微信、传邮箱都利索多了。
6. 其他小工具
几乎你能想到的 PDF 操作它都囊括了。日常高频用到的也就十来项，但剩下那 50 多项"以备不时之需"的功能摆在那儿，心里就是踏实——这种安全感，是花钱才买得到的。现在它免费给到你。
二、Docker Compose 一键部署到 NAS
绿联 NAS（其他支持 Compose 的 NAS 同样适用）的 Docker 管理器自带 Compose 项目管理，部署非常省事。
打开 Docker → 项目 → 新建，把下面这段 Compose 配置粘进去：
version: '3.3'
services:
stirling-pdf:
image: stirlingtools/stirling-pdf:latest
container_name: stirling-pdf
restart: unless-stopped
ports:
- "8750:8080" # 8080 太常见，前端改为 8750 避免冲突
volumes:
- ./trainingData:/usr/share/tessdata # OCR 语言包目录
- ./extraConfigs:/configs # 配置文件目录
- ./customFiles:/customFiles # 用户文件目录
- ./logs:/logs # 运行日志目录
environment:
- SYSTEM_DEFAULT_LOCALE=zh-CN # 简体中文
- DOCKER_ENABLE_SECURITY=false # 关闭安全限制方便访问点 "部署"，等镜像拉取完成后，浏览器打开 NAS_IP:8750 就能看到界面。
首次登录使用默认账号：
- 用户名：
admin - 密码：
stirling
登录后第一件事：立刻改掉默认密码。
三、OCR 识别 + PDF 文本编辑实战
Stirling-PDF 的 OCR 引擎底层用的是 Tesseract，首次使用需要手动下载语言包。
1. 下载语言包
进入 设置 → 高级，在 "下载更多 tessdata 语言" 里勾选需要的中文、英文等语言包，点击下载，会生成下载链接。把这些 .traineddata 文件全部下载下来，统一放到 trainingData 目录。
2. 跑一遍 OCR
准备一份扫描版 PDF（纯图片、没有文本对象的那种），上传后在右侧设置识别语言，点 "处理 OCR 并预览"。
稍等片刻，输出的 PDF 就带上了文本对象，可以直接用 "PDF 文本编辑器" 功能修改文字了，效果出乎意料地好。
3. 与 PaddleOCR 简单对比
之前我也在 NAS 上跑过 PaddleOCR 单独搭 OCR 服务：
| 方案 | 识别精度 | 部署成本 | 适用场景 |
|---|---|---|---|
| Stirling-PDF 内置 OCR | 中等偏上 | 一个容器搞定 | 日常文档、追求省事 |
| PaddleOCR 独立服务 | 更高（手写体、复杂排版更稳） | 需要额外部署一个服务 | 高精度、复杂版面 |
如果只是普通办公文档，Stirling-PDF 自带 OCR 完全够用；要是处理手写体、古籍、复杂表格，再考虑单独搭 PaddleOCR。
四、通过 MCP 协议接入 AI Agent
这才是 Stirling-PDF 最让我惊艳的地方——它原生支持 MCP 协议，可以直接对接 AI 助手实现自动化处理。下面以 Hermes 为例演示。
1. 开启 MCP Server 并切换鉴权
进入 设置 → MCP Server，勾选 Enable MCP Server。
默认鉴权模式是 OAuth，但 OAuth 需要额外部署授权服务器，吃资源还麻烦。个人用户建议直接改成 API Key 模式：
- 在
Authentication mode一栏选择API Key - 修改后去 Docker 管理器手动重启容器，再刷新页面
2. 获取 API Key
重启后回到 MCP Server 设置页，系统会生成一个 API Key，复制保存好（只显示一次）。
3. 接入 AI Agent
把以下两个信息告诉 AI Agent：
- MCP 地址：
http://NAS_IP:8750/mcp - API Key：上一步拿到的密钥
以 Hermes 为例，在它的 MCP 配置里加上 Stirling-PDF 的配置项，重启 Hermes 服务后，它就能像调用本地工具一样，指挥 Stirling-PDF 处理 PDF 了。
想象一下：以后对 AI 说一句"帮我把桌面上那 3 个 PDF 合并成一个，再压缩到 5MB 以下，签上我的名字"，AI 自己就调 Stirling-PDF 跑完了。这就是 MCP 协议的威力。
五、真实使用感受总结
深度体验一周后，Stirling-PDF 已经基本承包了我所有的 PDF 处理需求：
- ✅ 无广告、个人使用完全免费
- ✅ 本地化运行，文件不出 NAS，隐私有保障
- ✅ 界面简洁，中文完成度 90%+
- ✅ 功能全面，60+ 工具基本覆盖全场景
- ✅ MCP 协议加持，可被 AI Agent 调用
现在凡是两分钟内能搞定的合并、拆分、增删页、压缩、OCR 这种活儿，我全都丢给它处理。为这种零星需求专门开会员？真的不值。
如果你也在找一个省心、私密、能白嫖的 PDF 工具，Stirling-PDF 真的可以无脑冲。赶紧上 NAS 部署一个，从此告别各种在线 PDF 网站和付费会员。