一、Stirling-PDF介绍

1.1 Stirling-PDF简介

Stirling-PDF 是一款功能强大的开源 PDF 处理平台，支持桌面客户端、浏览器界面及私有服务器等多种部署方式，让用户在确保数据隐私与安全的前提下，全面掌控文档的编辑、签名、转换与自动化处理。

1.2 Stirling-PDF主要特点

• 全场景灵活部署：支持作为个人桌面应用、浏览器端工具或私有服务器运行，满足不同环境下的使用需求。
• 海量 PDF 工具集：内置 50 多种实用工具，涵盖编辑、合并、拆分、签名、加密、OCR 识别及压缩等全方位操作。
• 智能自动化工作流：提供无代码流水线功能与 API 接口，支持批量处理和自动化任务，轻松应对海量文档。
• 企业级安全管控：具备单点登录（SSO）、操作审计及灵活的本地化部署能力，完美契合企业级安全与合规要求。
• 开发者友好平台：为几乎所有工具提供 RESTful API，便于开发者将其无缝集成到现有的业务系统与自动化流程中。
• 全球化多语言支持：用户界面已支持超过 40 种语言，方便全球各地的用户无障碍使用。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下安装安装PDF编辑器Stirling-PDF。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Sun 2026-05-31 23:17:28 CST; 1 month 29 days ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 945 (dockerd)
      Tasks: 117
     Memory: 787.7M (peak: 1018.4M swap: 11.8M swap peak: 12.6M)
        CPU: 58min 1.415s
     CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

root@jeven:~# docker -v
Docker version 28.5.0, build 887030f

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven:~# docker compose version
Docker Compose version v2.39.4

四、拉取Stirling-PDF镜像

4.1 Github地址

• Github项目地址：https://github.com/Stirling-Tools/Stirling-PDF

4.2 拉取镜像

• Stirling-PDF原镜像： docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest

• 国内个人仓库镜像：registry.cn-hangzhou.aliyuncs.com/jeson/stirling-pdf:latest

拉取 Stirling-PDF镜像：当原镜像拉取缓慢或者失败时，可以使用registry.cn-hangzhou.aliyuncs.com/jeson/stirling-pdf:latest镜像。

docker pull registry.cn-hangzhou.aliyuncs.com/jeson/stirling-pdf:latest

五、部署Stirling-PDF服务

5.1 创建Stirling-PDF容器

我们直接使用docker-cli方式快速创建Stirling-PDF容器，如下所示：

 docker  run -d -p 7080:8080 registry.cn-hangzhou.aliyuncs.com/jeson/stirling-pdf

5.2 查看Stirling-PDF容器状态

检查Stirling-PDF容器运行状态，确保Stirling-PDF容器正常启动。

root@jeven:~# docker ps
CONTAINER ID   IMAGE                                                  COMMAND                   CREATED     STATUS                    PORTS                                           NAMES
2f501ed4be81   registry.cn-hangzhou.aliyuncs.com/jeson/stirling-pdf   "tini -- /scripts/in…"   32 seconds ago   Up 32 seconds (healthy)   0.0.0.0:7080->8080/tcp, [::]:7080->8080/tcp     nostalgic_kirch

5.3 检查Stirling-PDF容器日志

检查容器运行日志，确认 Stirling-PDF 服务是否正常启动并运行。请注意，执行命令前需将 《容器ID》 替换为当前容器的实际 ID。

docker logs 《容器ID》

六、访问Stirling-PDF服务

6.1 访问初始页

浏览器地址： http://<个人的服务器IP>:7080，访问Stirling-PDF初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

6.2 登录与修改密码

• 登录Stirling-PDF：使用登录页提高的默认账号密码登录。

• 修改密码：初次登录后，需要修改密码后，重新登录。

6.3 上传PDF文件

上传您的 PDF 文件后，即可在线直接打开并浏览。您还可以利用 Stirling-PDF 右侧提供的丰富工具集，对上传的 PDF 文件进行编辑、批注、转换等多种处理操作。

七、总结

本次实践通过Docker容器化技术，成功在本地环境中快速搭建并运行了开源PDF处理平台Stirling-PDF。整个过程涵盖了从环境检查、镜像拉取到容器部署与状态验证的完整流程，操作简便且易于维护。部署完成后，用户可通过浏览器便捷地访问服务，进行登录验证及各类PDF文件的上传与处理。借助这一私有化工具，我们能够在确保数据隐私与安全的前提下，高效完成日常的PDF编辑与管理任务。