前言
在这个信息爆炸、效率至上的时代，我们总会遇到各种小需求：
👉 想合并几个 PDF 文件、
👉 想从扫描件中提取文字、
👉 或者只是单纯想把几张图转成 PDF。
这些操作本身并不复杂，但往往因为缺少合适的工具，我们就不得不去网上翻各种“在线神器”。
然后被一堆广告、验证码、登录弹窗、文件大小限制搞得心态爆炸。
于是我想说 —— 为什么不自己动手，搭建一个属于自己的在线 PDF 工具平台呢？
我只能说 —— 有手就行！
今天就带大家用 Docker 部署一个超好用的开源项目：Stirling-PDF，
支持几十种 PDF 操作，界面好看，功能强大，关键是：完全免费、无广告、部署简单、安全私密！
1.项目
Stirling-PDF 是一款功能强大、界面友好且完全开源的 PDF 管理工具，它可以部署在你自己的服务器上，确保所有操作都在本地完成，数据更安全，体验更自由。借助 Docker，我们可以用最简洁的方式快速搭建自己的在线 PDF 工具平台。
1.1项目介绍
🌟 核心功能
Stirling-PDF 支持几十种 PDF 处理功能，包括但不限于：
📄 PDF 编辑
- 拆分 PDF
- 合并 PDF
- 重排页面顺序
- 删除/旋转页面
🖊️ PDF 修改
- 添加文本、图像、水印
- 添加/编辑注释
- 给 PDF 添加密码保护
- 解锁受保护的 PDF
🎨 格式转换
- PDF 转图片（PNG/JPG）
- 图片转 PDF
- Word/Excel/PPT 转 PDF（需额外插件）
- HTML 转 PDF
- 扫描件优化（OCR）
🧠 智能处理
- OCR 文字识别（支持多语言）
- 自动整理页面顺序
- 自动裁剪边距
- 黑白处理、对比度调整
1.2项目展示
2.相关地址
gitHub开源项目：https://github.com/Stirling-Tools/Stirling-PDF
3.搭建环境
- 服务器：这里为了方便搭建项目使用的是莱卡云的境外香港云服务器。(国内用户连接建议使用国内的服务器(需备案域名或者IP+端口)延迟会更低)
- 莱卡云服务器促销活动性价比会更高。查看官网购买链接：https://www.lcayun.com
- 资源配置：2核2G 30G硬盘
由于国内服务器访问海外源较慢，这边为了方便演示直接使用海外服务器搭建。 - 服务器系统：Debian-12
- 【必需】安装Docker：安装好 Docker、Docker-compose
- 【非必需】域名一枚，可用于解析到服务器上使用域名访问
4.搭建视频
哔哩哔哩：https://www.bilibili.com/video/BV1GYtwz2Ebu/?spm_id_from=333.1387.homepage.video_card.click
5.搭建方式
5.1 安装docker和docker-compose
安装教程：服务器上安装docker和docker-compose教程
5.2 创建Stirling-PDF的docker文件
#在opt目录下创建Stirling文件夹
mkdir /opt/Stirling#打开Stirling文件
cd /opt/Stirling#编辑docker-compose.yml文件
vi docker-compose.yml5.3 安装Stirling-PDF镜像
services:
stirling-pdf:
image: frooodle/s-pdf # 使用官方镜像
container_name: stirling-pdf # 设置容器名称
ports:
- "8080:8080" # 映射端口（宿主机:容器）
volumes:
- ./tessdata:/usr/share/tessdata # OCR 字体挂载目录（本地目录 → 容器）
restart: unless-stopped # 开机自动重启，除非手动停止填完按esc键 输入 :wq 保存退出
5.4 运行Stirling-PDF的docker镜像
我们先启动docker
# 启动docker
docker compose up -d
# 重启docker
docker compose stop
docker compose start
# 升级docker
docker compose down
docker compose pull
docker compose up -d访问IP:8080端口就可以有界面出现了。
http://ip:8080
5.5 下载 OCR 中文识别语言包（可选）
#打开Stirling文件
cd /opt/Stirling#创建tessdata文件夹
mkdir -p tessdata#打开tessdata文件夹
cd tessdata#下载简体中文模型
wget https://github.com/tesseract-ocr/tessdata/raw/main/chi_sim.traineddata -P tessdata📌 说明：
chi_sim.traineddata是 Tesseract 的简体中文识别模型（Chi-nese SIM-plified）。- 下载路径必须与
docker-compose.yml中volumes映射的一致： yaml复制编辑volumes: - ./tessdata:/usr/share/tessdata
下载完成后，重启容器即可生效：
#重启docker
docker-compose restart6.结尾
Stirling PDF提供了其软件的企业版。这是一款同样出色的软件，但增加了功能、支持和舒适性。查看他们的文档：Enterprise docs
是不是有手就行！
经过以上步骤，我们成功用 Docker 快速搭建了属于自己的在线 PDF 转换与管理工具 —— Stirling-PDF。无论是日常办公处理，还是学习工作中的文档整理，都能大大提升效率，避免了依赖广告纷扰的第三方网站，也更好地保护了个人隐私。
