合并、拆分、加水印、OCR、压缩、旋转……所有 PDF 操作再也不用开会员！一条命令，把「全能 PDF 工具箱」装进自己服务器。

一、Stirling-PDF 是什么

官网：https://stirlingpdf.com

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

定位：开源、免费、离线的 PDF 瑞士军刀，100+ 功能全覆盖，支持中文 OCR。

亮点：– 零依赖 WebUI，手机/电脑即开即用；– 纯本地处理，文件不上传云端，敏感资料放心交；– 支持批量、压缩、加密、解密、页码、签名、图片互转等硬核功能；– 内置 Tesseract 中文识别，扫描件秒变可搜索 PDF。

二、前置条件

任意装有 Docker 的主机（Linux / macOS / Windows）。

空闲端口 8080（或自定义）。

三、方式 A：镜像拉取 + 一条命令启动（60 秒）

创建持久目录

mkdir -p ~/stirling/data && cd ~/stirling

拉取官方镜像并启动

docker run -d --name stirling \  -p 8080:8080 \  -v "$PWD"/stirling/data:/data \  -e DOCKER_ENABLE_SECURITY=false \  frooodle/s-pdf:latest 

参数说明：-v 把配置、缓存、OCR 语言包持久化；DOCKER_ENABLE_SECURITY=false 关闭登录页，局域网直接用（生产建议开启）。

查看日志

docker logs -f stirling

出现Stirling-PDF started on port 8080即成功。

浏览器访问http://<你的IP>:8080→ 首页功能菜单秒开，中文界面已内置。

四、方式 B：docker-compose（推荐长期运行）

新建 compose 文件

cat > docker-compose.yml <<'EOF'version: "3.8"services:  stirling:    image: frooodle/s-pdf:latest    container_name: stirling    restart: unless-stopped    ports:      - "8080:8080"    volumes:      - ./stirling-data:/data      - ./extraFonts:/usr/share/fonts/extra  # 可选：放自定义字体    environment:      - DOCKER_ENABLE_SECURITY=false      - LANGS=zh_CN,en_US                   # 开启中文 OCREOF 

一键拉起

docker compose up -ddocker compose ps          # 确认 STATUS=Up 

后期升级

docker compose pull && docker compose up -d 

五、验证：3 步完成「扫描 PDF → 可搜索文本」

点击顶部「OCR」→ 上传一份中文扫描件（图片或 PDF 均可）。

语言包选chi_sim+eng→ 开始识别，等待进度条完成。

下载输出文件，用浏览器打开「选中文字」能复制即代表 OCR 成功，部署验证完毕 ✅

六、常见问题 30 秒速查

• 端口冲突：把 compose 里8080:8080改成9090:8080即可。

• 中文 OCR 失败：确认LANGS=zh_CN且容器能联网下载语言包；离线可手动把.traineddata扔进./stirling-data/tessdata。

• 内存暴涨：批量超大文件时加-e SYSTEM_MAX_SIZE=50限制单次上传 50 MB。

至此，你的「离线 PDF 工作站」已在线！合并合同、加水印、批量转图片全都拖拽搞定，再也不用给在线工具交月费。快把第一条 PDF 拖进去，让 Stirling-PDF 帮你秒速处理吧 🎉