本地 PDF 瑞士军刀：用 Docker 5 分钟搭一个 PDF 工具箱，完全免费还保护隐私

PDF 是日常办公最常见的格式，但处理它往往要靠各种收费软件，或者把文件传到网上用在线工具——后者意味着你的隐私数据被别人看到了。

今天介绍一个开源工具叫 Stirling-PDF。你可以把它部署在自己的电脑或服务器上，处理 PDF 完全不用联网，数据永远不会离开你的机器。功能非常全面，合并、分割、压缩、加密、OCR 识别……几乎涵盖了日常用到的所有 PDF 操作。

Stirling-PDF 能做什么？

列举几个最实用的功能：

合并 / 分割 — 把多个 PDF 合成一个，或把一个 PDF 按页面拆开
压缩 — 减小 PDF 文件体积，方便发送
PDF 转图片 / 图片转 PDF — 格式互转
OCR 识别 — 扫描件图片转可搜索的文字 PDF
加水印 — 给 PDF 批量加文字或图片水印
加密 / 解密 — 给 PDF 加密码保护，或去掉密码
旋转 / 裁剪 — 调整页面方向和边距
签名 — 上传签名图片，拖到 PDF 上签名

完整功能列表可以去它的 GitHub 页面看，地址在最后。

开始安装

第一步：安装 Docker

Stirling-PDF 用 Docker 部署，一条命令搞定。如果你还没装 Docker，按系统来：

macOS：

brew install --cask docker

Windows：

去 Docker 官网下载 Docker Desktop，安装后运行。

Linux（Ubuntu / Debian）：

sudo apt update
sudo apt install docker.io docker-compose -y
sudo systemctl start docker
sudo systemctl enable docker

第二步：运行 Stirling-PDF

打开终端（macOS 找"终端"，Windows 找"PowerShell"），输入这条命令：

docker run -d -p 8080:8080   -v ./stirling-pdf-data:/app/stirling-pdf-data   --name stirling-pdf   --restart unless-stopped   frooodle/s-pdf:latest

解释一下每个部分：

-d — 后台运行
-p 8080:8080 — 把容器内的 8080 端口映射到电脑的 8080
-v ./stirling-pdf-data:/app/stirling-pdf-data — 把数据存在本地，删容器不会丢文件
--name stirling-pdf — 给容器起个名字，方便以后管理
--restart unless-stopped — 电脑重启后自动重启服务

回车，等一分钟左右拉取镜像并启动。

第三步：打开使用

浏览器地址栏输入：

http://localhost:8080

看到如下界面就成功了：

（图：Stirling-PDF 主界面截图）

左侧是全部功能分类，点击就能用。界面是中文的，零门槛。

进阶配置（可选）

开启登录功能

默认安装任何人都能使用。如果想加个登录界面，只允许自己访问，加一行环境变量：

docker run -d -p 8080:8080   -v ./stirling-pdf-data:/app/stirling-pdf-data   -e INSTALL_PRE_REGISTER=true   --name stirling-pdf   --restart unless-stopped   frooodle/s-pdf:latest

然后打开 http://localhost:8080/login 注册第一个账号，就是管理员。

自定义端口

8080 被占用了？改成别的，比如 9090：

-p 9090:8080

然后浏览器访问 http://localhost:9090。

开启 OCR（文字识别）

需要识别扫描件 PDF 里的文字，先确保系统装了 Tesseract OCR，然后加上这个环境变量：

docker run -d -p 8080:8080   -v ./stirling-pdf-data:/app/stirling-pdf-data   -e OCR_LANGUAGES=chi_sim+eng   --name stirling-pdf   --restart unless-stopped   frooodle/s-pdf:latest

chi_sim+eng 表示中文简体 + 英文双语识别，多种语言用 + 连接。

常用操作示例

合并多个 PDF

打开 Stirling-PDF，点击左侧"合并 / 分割（Merge & Split）"
点击"Multi-page merge"
上传多个 PDF 文件
拖拽调整页面顺序
点击"Merge"，下载合并后的文件

给 PDF 加水印

点击"Watermark"
上传 PDF 文件
填写水印文字，选位置和透明度
点击"Apply"下载

PDF 签名的方法

点击"Sign"
上传签名图片（提前用手机拍一张签名，透明背景 PNG 最佳）
拖动签名到你想要的位置
点击"Sign"保存

如何更新

Stirling-PDF 更新很频繁，想用新版本：

# 停止并删除旧容器
docker stop stirling-pdf
docker rm stirling-pdf

# 重新运行（镜像会自动拉取最新版本）
docker run -d -p 8080:8080   -v ./stirling-pdf-data:/app/stirling-pdf-data   --name stirling-pdf   --restart unless-stopped   frooodle/s-pdf:latest

数据都在 ./stirling-pdf-data 目录，更新不会丢失。

停止和卸载

# 停止服务
docker stop stirling-pdf

# 删除容器（数据还在）
docker rm stirling-pdf

# 彻底删除（包括数据）
docker stop stirling-pdf
docker rm stirling-pdf
rm -rf ./stirling-pdf-data

写在最后

Stirling-PDF 是一个可以长期服役的工具。部署一次，以后电脑上所有 PDF 相关的事务都可以在这里解决。数据完全保存在本地，不用担心隐私问题，也不用每个月交软件订阅费。

适合人群：经常处理 PDF 文件、对隐私有要求、或者单纯想减少软件订阅支出的人。

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

官方文档：https://docs.stirling-pdf.io