自有在线PDF处理工具服务！还支持OCR！NAS部署Stirling-PDF

作为一名深度折腾威联通 NAS 的玩家，这几年我在 Docker 里跑过不少服务，密码管理器、自托管云盘、下载器基本都折腾过一遍。但最近装上的 Stirling-PDF，还是让我有了一种久违的"眼前一亮"。

我一开始关注它，原因其实很简单：PDF 处理必须安全自控。现在市面上的 PDF 工具很多，功能强的不少，但往往要把文件上传到第三方服务器；强调隐私的产品也有，但要么功能单一、要么部署门槛高。Stirling-PDF 吸引我的地方，就在于它把这些看似难以兼顾的点整合进了同一套系统里：所有操作在本地完成、文件绝不外发、功能却一点不少。

它不是传统意义上的在线 PDF 转换器，更多的还是一套围绕需求构建起来的个人文档处理中心。拆分、合并、转换、OCR、添加水印、压缩——50 多种 PDF 操作都能一站式搞定，而且核心控制权始终握在自己手里。更难得的是，这个项目从诞生到现在，社区非常活跃，目前已经在 GitHub 上收获了近 30000 颗星。对于 NAS 用户来说，这套思路非常对味。

关于Stirling-PDF

🔺什么是Stirling-PDF？Stirling-PDF能做什么？

Stirling-PDF 是一款开源、可本地部署的 PDF 处理工具。它通过模块化的功能整合，把 页面操作、格式转换、安全权限设置、OCR 识别、压缩对比、电子签名 等数十种能力统一进同一套 PDF 处理系统中。文件默认在本地处理，支持离线使用，也支持用户自行部署服务端，实现团队内部共享或通过对象存储进行任务流转。

简单来说，它最大的特点就是：把原本需要多个软件才能完成的 PDF 操作，统一到一个入口里。

以前你可能要单独打开 Adobe Acrobat 做页面编辑，用 Illustrator 调整布局，用在线工具压缩 PDF，用另一款软件添加水印和密码，再用专门的 OCR 工具识别文字，还要找转换器把 PDF 转成 Word……现在，这些操作都可以在 Stirling-PDF 里一站式完成——合并拆分、旋转裁剪、添加注释、加页码、去水印、PDF 转图片、图片转 PDF、HTML 转 PDF、设置权限、签署文档、检测空白页、修复损坏文件、提取图片、自动重命名、PDF/A 归档……不说了，这实在是太强了！

项目地址：

https://github.com/Stirling-Tools/Stirling-PDF

🔺Stirling-PDF

威联通Container Station安装Stirling-PDF教程

Stirling-PDF 的安装和使用相对来说比较简单，使用 Docker 就可以直接安装，但是环境变量和配置文件有点多，新手的话看着有点头晕。

对于没有技术背景的同学而言，你也不用担心安装问题，我之前写过的一篇关于Docker安装Yantr应用商店的教程里提供了一键部署的应用模板，点一下鼠标即可完成部署，非常丝滑。

🔺如果你想快速部署一个 Stirling-PDF 工具箱，又不想陷入繁琐的安装和配置过程，可以试试Yantr。

直接打开 Stirling-PDF 应用模板，然后点击右下角的 “安装应用”，就可以一键安装了。

不过我还是建议用YAML方式安装，这样的可控性比较强。

🔺先打开NAS的文件管理器，在 docker 目录中（威联通默认为Container文件夹），创建一个新文件夹【Stirling-PDF】，然后在 Stirling-PDF文件夹中再分别新建四个子文件夹trainingData、extraConfigs、customFiles、logs。

🔺然后打开：

Container Station → 应用程序 → 创建

把下面这段 YAML 粘贴进去：

version: '3.9' services: stirling-pdf: image: frooodle/s-pdf:latest container_name: Stirling-PDF ports: - "8080:8080" volumes: - /opt/trainingData:/usr/share/tessdata # OCR 语言支持 - /opt/extraConfigs:/configs - /opt/customFiles:/customFiles/ - /opt/logs:/logs/ environment: DOCKER_ENABLE_SECURITY: true # 启用内部安全功能 SECURITY_ENABLELOGIN: true # 启用登录功能 SECURITY_INITIALLOGIN_USERNAME: baobaozi # 登录账户 SECURITY_INITIALLOGIN_PASSWORD: baobaozi # 登录密码 UI_APPNAME: "Baozi PDF" # 导航页标题（含空格需加引号） INSTALL_BOOK_AND_ADVANCED_HTML_OPS: false SYSTEM_DEFAULTLOCALE: zh_CN # 默认中文

这里简单说一下几个关键项：

8080:8080 中，左侧的8080 是映射到 NAS 上的访问端口，可以按自己习惯修改。

restart: unless-stopped 表示 NAS 重启后容器会自动恢复运行。

安装完成后，通过 NAS 的 IP 加端口访问即可。

🔺等着它自动部署结束。

🔺安装完之后，你可以看到有一个程序已经在运行了。

🔺点进去看看端口，打开你的NAS网址加这个端口号，比如我的就是http://192.168.192.141:8080。

🔺登录进去的时候会显示你需要账户密码，记得回去看看那个YAML文件，我设置的默认的账户是baobaozi，密码baobaozi，输入之后直接点登录。

stirling-pdf能干什么？为什么我会觉得它值得装？

第一，统一处理PDF，省去了每台都装PDF处理软件的问题

stirling-pdf没有复杂的本地软件，也没有什么在线服务注册要求。它的逻辑很直接：所有的处理任务都直接在NAS上完成，我手里的好几台电脑就完全没必要每一台都装PDF处理软件了。只需要在一台NAS上装stirling-pdf，那么内网所有的设备都可以用同一个设备去处理PDF。

🔺这种设计最大的好处，就是减少了多设备文件处理的成本。很多时候，真正拖慢效率的不是处理文件，而是先汇总。stirling-pdf把这个动作简化了，你先上传，系统再通过统一的管理自动组织内容。对于平时碎片化PDF文件比较多的人来说，这种体验很轻松。

第二，客户端加密，让人更安心

这是我最看重的一点。stirling-pdf的核心思路是：在文件离开浏览器之前，就已经完成加密。

🔺也就是说，你在前端看到的是明文，但服务端、容器卷、备份文件里保存的，其实都是加密后的密文。即便你通过反向代理暴露到公网，或者有人拿到了 Docker 存储卷文件，也无法直接读取你的内容。

🔺对于自托管用户来说，这种安全感非常重要。毕竟很多人折腾 NAS，不只是为了“能用”，更是为了把数据主权重新掌握在自己手里。

stirling-pdf整体体验明显偏向离线优先。日常使用时，读写、编辑、搜索都很顺畅，不会有那种“每一步都在等云端返回”的割裂感。即便网络状态一般，或者临时断网，基础记录和查看依然不受太大影响。

对于经常切换设备、切换网络环境的人来说，这一点非常实用。

第三，所有功能都免费开放

🔺在日常工作中，我经常需要处理包含敏感信息的 PDF 文件，并且要在多台设备（电脑、平板、手机）之间协同编辑与管理。Stirling-PDF 作为一套完整的本地 PDF 工具集，完美解决了我的需求：

🔺页面级精细操作

通过内置的 PDF.js 可视化界面，我可以对多页 PDF 进行缩略图预览、排序、搜索、注释、绘制及文字/图片添加，无需安装任何桌面软件。

🔺完整的交互式 GUI 支持合并、拆分、旋转、移动页面，还能按百分比缩放、调整对比度、裁剪页面，甚至自动拆分扫描文档中的物理分隔页。

🔺多页布局、页面重组、批量删除或提取页面等功能，让我能快速从一份长文档中抽取出关键章节。

多格式转换与协同流转

依托 LibreOffice 引擎，我可以将任何通用文件（Word、Excel、PPT）一键转为 PDF，反之也能将 PDF 导出为 Word 或 PowerPoint，方便团队成员在不同设备上继续编辑。

支持 HTML、URL、Markdown 直接转 PDF，便于将网页快照或笔记归档为统一格式，并且还能进行合并。

基本上我涉及到文档保存处理的场景，都能用到它。

🔺图像与 PDF 的相互转换功能，可以在扫描件与图片之间自由切换。

🔺安全与权限管控

所有处理均在本地网络完成，敏感文件不会上传至任何第三方云服务，符合保密要求。

可添加/移除密码、设置文档权限（禁止打印、复制等）、添加水印、数字签名或认证。

🔺自动编辑文本、清理元数据、拼合 PDF 等高级安全功能，确保我对外分享前彻底移除隐藏信息。

🔺自动化与辅助工具

OCR 识别（OCRMyPDF）让扫描版 PDF 变为可搜索、可复制的文档，并支持 PDF/A 长期归档。这个功能直接让我就不用去花钱开一些PDF软件的会员了。

🔺压缩 PDF 体积、检测并删除空白页、比较两个 PDF 的文本差异、提取图像、添加页码等操作一应俱全。

🔺自动根据 PDF 标题文本重命名文件，导出全文档信息为 JSON，方便与其他系统对接。

实际用下来，它适合谁？

部署完成之后，Stirling-PDF给我的第一感觉就是：我终于不用把每一台电脑里面都装PDF处理软件，并且还跟弹窗斗智斗勇了。

没有复杂层级，没有太多分散注意力的入口，核心就是PDF处理。页面看起来简单，但这种简单并不是功能少，而是把重点放回到功能本身。如果你平时就有下面这些需求，那Stirling-PDF会很适合你：

你想把数据安全，文件处理和分发放到同一个系统里；

你在意数据隐私，不想把核心内容默认放在第三方云端处理；

你本身就有 NAS，已经习惯在威联通上跑各种 Docker 服务；

你希望工具足够轻、足够快，不想被复杂结构拖慢使用效率。对我来说，Stirling-PDF不是那种功能堆得特别夸张的软件，但整体体验非常顺：记录顺、搜索顺、管理顺，隐私边界也更让人安心。

结语

Stirling-PDF 给我的整体感觉，可以概括成一句话：

它不是在做一个PDF处理服务，而是在做一套更符合自托管思路的个人加密信息系统。

它把笔记、文件、照片统一进一套逻辑里，让原本分散在多个设备中的内容重新聚合到一起；同时又通过客户端加密、离线优先、P2P 同步和 S3 备份，把数据控制权尽量保留在用户自己手里。

如果你本来就有 NAS，也习惯在上面跑 Docker 服务，那么 ZeroNote 确实值得你亲自装起来试试。对于在意 隐私、统一管理和数据主权 的人来说，它会是一种很有意思的选择。

如果你想看更多 NAS、自托管Docker等相关玩法，也欢迎继续关注。没写过的内容，也可以评论区留言交流。

本篇就到这里，我们下篇再见。