Stirling-PDF：PDF 那些破事，别再上传到别人的服务器

合同、发票、简历、说明书、扫描件。PDF 这东西从来不缺，缺的是"想改一个字"的时候。

在线工具很多，但你上传的每一份文件都经过了别人的服务器。合同、身份证、工资单——你真的愿意吗。

Stirling-PDF 把这一整套搬到本地。9.5 万 star，地址：

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

五十多个功能，全是网页上点几下的事。你的文件从上传到下载，全程没离开过自己的机器。

装：一个容器

应用中心搜 Stirling-PDF，或者：

services:
  stirling-pdf:
    image: stirlingtools/stirling-pdf:latest
    container_name: stirling-pdf
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./configs:/configs
      - ./trainingData:/trainingData
      - ./pipeline:/pipeline
    environment:
      - TZ=Asia/Shanghai
      - LANGS=zh_CN

docker compose up -d

打开 http://NAS地址:8080。

三个卷各管一件事：

• configs：配置和用户设置；
• trainingData：OCR 要用的语言包，第一次用 OCR 会下载，之后就在这儿；
• pipeline：自动化流水线的脚本目录，进阶用。

LANGS=zh_CN 让界面默认中文。不改也行，右上角能切。

最常用的八个功能

1. 合并 / 拆分 把十个 PDF 合成一个，或者按页码拆成十个。拖进去，选范围，下载。

2. 压缩 扫描件动辄几十兆，压到几兆发微信不卡。选「推荐压缩」，或者手动调 DPI。

3. PDF 转图片 / 图片转 PDF 发票、截图拼成一份文档，反过来把 PDF 每页导成 PNG。

4. OCR（图片文字识别） 扫描件变成可以搜索、可以复制的文字。这是它最值钱的功能——中文识别要装 chi_sim 语言包，第一次用会下载几百兆。

5. 加水印 / 页码 / 页眉页脚 批量给文件打"内部资料 请勿外传"，或者补上页码。支持位置、透明度、字体大小。

6. 签名 / 盖章 手写签名图片贴上去，或者画一个。日常够用，法律效力另说。

7. 格式转换 PDF ↔ Word / Excel / PPT / 图片。转换质量取决于原文件，别期待完美还原复杂排版。

8. 修复 / 线性化 / 权限 打不开的 PDF 试试修复；去掉密码；设置禁止打印、禁止复制。

中文 OCR 怎么弄

默认只有英文。要识别中文：

1. 进「设置」→「OCR 语言」，勾上 chi_sim（简体）和 eng；
2. 保存后回首页用 OCR，第一次会下载语言包；
3. 下载慢的话，手动把 .traineddata 文件放进 trainingData/tessdata/ 目录。

识别质量取决于扫描清晰度。手机拍的斜的、暗的，出来就是一堆错字——先摆正、调亮，再 OCR。

自动化：一次处理一批

顶部有个「流水线」（Pipeline）功能，可以把多个操作串起来：比如"压缩 → 加水印 → 加页码 → 输出"。

写成一个步骤文件放进 pipeline/ 目录，之后上传文件就会按这个流程走。适合每月固定处理一批发票、合同的场景。

几个实际会遇到的坑

上传大文件失败 默认上传限制比较保守。几百兆的扫描件会被挡，改 configs/settings.yml 里的上传大小限制，然后重启容器。

OCR 一直转圈 语言包没下完。看容器日志，是不是卡在下载；国内网络建议手动放语言包。

转 Word 出来格式全乱 PDF 本质是"排好版的纸"，不是结构化文档。复杂表格、多栏排版转出来一定乱，这不是工具的问题。

打开很慢 容器刚启动要初始化，等十几秒；之后正常。内存给 1–2 GB 就够。

中文字体缺失导致水印变方块 镜像里中文字体不全。把 ttf 文件挂进容器字体目录，或者在配置里指定字体路径。

它适合谁

• 经常处理合同、发票、报表的；
• 手上有扫描件，想变成能搜索的文字的；
• 在意文件不外传的——这条是它最大的理由。

不适合：一年用两次 PDF 的人。那种情况在线工具更省事，别为了一年两次装个服务。

一个提醒

它是本地服务，但默认没有登录。谁访问到 http://NAS:8080 谁就能用。

内网里问题不大，但如果通过反代或隧道开到公网，一定要在前面加一层验证（Cloudflare Access、或者反代的基础认证）。不然别人可以拿你的机器当免费 PDF 处理站，还能看到你传过的文件。

最后

这类工具平时想不起来，用的时候找不到替代——特别是那种"明天就要交、文件还在扫描仪里"的时刻。

装一次，以后都在。

有问题留言。