2026 Stirling PDF 自建 PDF 工具箱：Docker 部署 30+ 种 PDF 处理工具合一

你有没有过这种经历：收到一个扫描件 PDF，想把其中几页单独提取出来另存为，或者想旋转一张歪了的扫描页，又或者想把几个 PDF 合并成一个文件发给别人。打开浏览器搜”PDF 工具”，出来的全是需要注册账号的在线网站——小A鸭 PDF、ILovePDF、PDF 24——上传文件到别人的服务器上处理完再下载回来。文件传到别人服务器上，内容安不安全你根本不知道。而且这些在线工具大部分有文件大小限制（超过 10MB 请升级会员）和每日使用次数限制（今天还剩 3 次），真要处理大量文件的时候根本不好使。

你可能想用桌面软件来搞定。Adobe Acrobat 功能齐全但价格不便宜，一年订阅要好几百。Foxit Reader 免费版功能有限制。而且不管哪种桌面软件，你都需要在不同电脑上分别安装——换了电脑或者用别人的电脑时又得回到在线工具的循环里。

Stirling PDF 就是来解决这些问题的。它是一个开源的 PDF 工具箱，Docker 一键部署到自己的服务器上，所有文件在本机处理，不需要上传到任何第三方服务器。支持合并、拆分、旋转、压缩、OCR 文字识别、PDF 转 Word、PDF 转图片、添加水印、电子签名等 30 多种功能——覆盖了你日常能遇到的大部分 PDF 操作场景。而且完全免费，没有使用次数限制，没有文件大小限制。任何一台能打开浏览器的设备（电脑、平板、手机），连上你的服务器就能用。

部署好之后它就在你的内网或者服务器上跑着。工作文档、合同扫描件、电子书——随便几个 G 的大文件也能处理，不需要担心在线工具那种”文件过大请升级会员”的提示。而且数据不出你的设备，隐私有保障。

一、Docker 部署#

一个 Compose 文件搞定。Stirling PDF 基于 Java，打包好的镜像大概 1GB 左右，第一次拉取需要一点时间。

1
services:
2
  stirling-pdf:
3
    image: stirlingtools/stirling-pdf:latest
4
    container_name: stirling-pdf
5
    restart: unless-stopped
6
    ports:
7
      - "8081:8080"
8
    volumes:
9
      - ./stirling/trainingData:/usr/share/tesseract-ocr/4.00/tessdata
10
      - ./stirling/extraConfigs:/configs
11
    environment:
12
      DOCKER_ENABLE_SECURITY: "false"

8081 是对外端口（容器内是 8080），trainingData 目录放 OCR 所需的语言数据文件，extraConfigs 放自定义配置。注意 Stirling PDF 的 Docker 镜像比较大（约 1GB），因为它内置了 Java 运行环境和 Tesseract OCR 引擎。第一次拉取可能有点慢，如果用的国内服务器可以配一下镜像加速。

1
docker compose up -d

启动后访问 http://你的IP:8081，你会看到一个简洁的网页界面——左侧是功能分类菜单，右侧是操作区域。界面默认就是中文的，不需要额外设置。不需要注册、不需要登录，直接拖文件进去就能处理。整个界面设计得很清爽，一个页面就是一个工具，用完返回再选下一个，没有广告，没有弹窗，没有会员升级提示。

二、核心功能速览#

功能分类	包含工具	适用场景
合并拆分	合并 PDF、拆分 PDF、提取页面、移除页面	把多个扫描件合成一个文档、从大文件里抽几页
转换格式	PDF 转 Word / 图片 / HTML、图片转 PDF	需要编辑 PDF 文字时先转成 Word
编辑操作	旋转、裁剪、调整大小、添加页码	歪了的扫描页转正、给文档加页码
安全	添加 / 移除密码、添加水印、电子签名	给敏感文件加密
OCR	PDF 文字识别、图片 OCR	扫描件的文字提取和搜索
其他	压缩、对比、修复、元数据编辑	减小文件体积、查看文档信息

常用的几个场景：把三个分开的 PDF 合同合并成一个文件、给一份扫描件做 OCR 变成可搜索的文字 PDF、把 PDF 转成 Word 方便修改文字内容——全部在浏览器里拖拽完成，不需要安装任何桌面软件。而且在任意设备上都能用——你在办公室电脑上处理了一半的文件，回家在笔记本上打开同一个页面接着处理，进度不中断。对比桌面软件只能在一台电脑上用，方便太多了。

具体到每个功能的使用方法：进入页面后在左侧点你要的功能分类，右侧就会出现对应的操作面板。大多数功能都是”上传文件→选参数→点开始→下载结果”四步流程，不需要任何说明书。界面支持中文，菜单清晰明了。

合并拆分#

合并 PDF：选多个 PDF 文件，调一下顺序，点合并。几秒后下载一个合并好的文件。拆分 PDF：上传一个多页 PDF，可以按页数拆（每 3 页一个文件）或者按范围拆（第 1-5 页、第 6-10 页）。提取页面：从大文件里抽几页，其他不变。这个功能在处理合同或者报告时特别常用。

转换格式#

PDF 转 Word 是最常用的功能之一——收到一份不能编辑的 PDF，转成 Word 然后修改。转图片的话可以指定分辨率，适合做预览图。图片转 PDF 适合把手机拍的文件照片合成一个正式的 PDF 文档。

OCR 文字识别#

把扫描版 PDF 变成可搜索的文字版。后文有详细配置说明。

三、OCR 中文识别配置#

Stirling PDF 默认不带中文 OCR 数据。如果需要识别扫描件里的中文字，需要额外下载中文语言包。

在 docker-compose.yml 里映射的 trainingData 目录中放中文 OCR 数据文件：

1
# 下载简体中文 OCR 数据
2
cd ./stirling/trainingData
3
wget https://github.com/tesseract-ocr/tessdata/raw/main/chi_sim.traineddata

重启容器后，在 Stirling PDF 界面的 OCR 功能里就能选中文了。把扫描件上传，选”chi_sim”作为识别语言，点开始。处理完成后下载到的 PDF 文字就可以搜索和复制了——扫描件变成了可编辑的电子文档。OCR 识别的准确性取决于扫描分辨率和文字清晰度。300 DPI 以上的扫描件效果最好，手写体和艺术字的识别率会低一些。如果识别结果不理想，可以在 OCR 之前先用”调整对比度”或”去偏斜”功能预处理一下。

四、进阶配置#

开启登录验证： 如果不想让所有人都能用你的 Stirling PDF（比如你暴露到公网了），可以开启登录验证。把 DOCKER_ENABLE_SECURITY 改成 "true"，然后重启容器。首次启动会自动生成一个管理员账号，用 docker compose logs 查看初始密码。你也可以通过环境变量 SECURITY_USERNAME 和 SECURITY_PASSWORD 自定义登录名和密码。

限制文件大小： 默认不限制上传文件的大小。如果你的服务器硬盘空间有限，可以在环境变量里加 MAX_FILE_SIZE 来限制。比如 MAX_FILE_SIZE: "200MB" 限制最大上传 200MB 的文件。这个对家庭自部署用户不是必须设置，但如果你把 Stirling PDF 分享给朋友使用，建议设个上限避免有人上传超大文件把硬盘塞满。

自定义首页： Stirling PDF 支持替换首页的 Logo 和颜色主题，在 extraConfigs 目录里放自定义的 CSS 和图片文件就行。不过默认界面已经足够清爽，大多数人不需要折腾这个。

配合 Tailscale 使用： 如果只给自己和家人用，推荐用 Tailscale 组网访问，不暴露到公网。PDF 操作涉及文件内容，内网使用最安全。

五、常见问题#

Q：文件处理速度慢？ Stirling PDF 所有处理都在本地 CPU 上完成，大文件处理时确实需要等几秒到几十秒。文件越大、操作越复杂（比如 OCR），耗时越长。这跟在线的”秒处理”不同——在线工具实际上是上传到服务器提前处理好的，你上传的文件可能被他人访问到。Stirling PDF 是实时处理，没有缓存，但数据不出你的服务器。如果嫌慢，给服务器换个好点的 CPU 是最直接的解法。

Q：OCR 识别不准？ OCR 的质量取决于扫描件的清晰度。300 DPI 以上的扫描件识别效果最好。如果文字模糊或者倾斜，识别率会下降。可以先用 PDF 编辑功能里的”调整对比度”或者”去偏斜”处理一下再 OCR。

Q：支持批量处理吗？ 单个操作一次只支持一个文件上传处理。但你可以多开几个浏览器标签页，每个标签页处理不同的文件——反正跑在你自己的服务器上，资源都是你的，不会有人限你的并发数。如果经常有批量处理需求，Stirling PDF 提供 REST API，配合 n8n 工作流就能做自动化批量操作。

延伸阅读#

Docker 换源避坑指南 — 部署前的必备准备
Nginx Proxy Manager 反代面板 — 统一管理所有服务的访问入口
Stirling PDF 自建 PDF 工具箱 — 30多种PDF处理工具合一

Stirling PDF 的价值在于：你不需要为了一个偶尔的 PDF 操作去搜在线工具、注册账号、担心文件泄露到别人的服务器上。部署一次，所有 PDF 功能随时用，不限次数、不限大小、文件不出你的服务器。跟自部署的其他服务配合使用效果更好——配合 Tailscale 组网可以在外面安全地访问自己服务器的 PDF 工具箱，配合 NPM 反代可以给家人朋友一个方便的 PDF 在线工具入口。有时候同事急着要一个合并好的合同文件或者你收到一份需要转成 Word 的扫描稿，直接在浏览器里打开你的 Stirling PDF，拖进去处理完发给他，前后不到一分钟。比去找在线工具注册上传下载快太多了，也不用担心文件传到别人的服务器上有安全风险。

推荐指数：⭐⭐⭐⭐⭐（自部署用户的 PDF 瑞士军刀）

音乐

广告