Docker一键部署Stirling-PDF从零搭建本地专属PDF编辑器一、Stirling-PDF介绍1.1 Stirling-PDF简介1.2 Stirling-PDF主要特点二、本次实践规划2.1 本地环境规划2.2 本次实践介绍三、本地环境检查3.1 检查Docker服务状态3.2 检查Docker版本3.3 检查docker compose 版本四、拉取Stirling-PDF镜像4.1 Github地址4.2 拉取镜像五、部署Stirling-PDF服务5.1 创建Stirling-PDF容器5.2 查看Stirling-PDF容器状态5.3 检查Stirling-PDF容器日志六、访问Stirling-PDF服务6.1 访问初始页6.2 登录与修改密码6.3 上传PDF文件七、总结一、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。hostnameIP地址操作系统版本Docker版本部署项目备注jeven192.168.3.88Ubuntu 24.04.2 LTS28.5.0Stirling-PDF版本2.14.32.2 本次实践介绍1.本次实践部署环境为个人测试环境生产环境请谨慎2.在Docker环境下安装安装PDF编辑器Stirling-PDF。三、本地环境检查3.1 检查Docker服务状态检查Docker服务是否正常运行确保Docker正常运行。rootjeven:~# systemctl status docker● docker.service - Docker Application Container Engine Loaded: loaded(/usr/lib/systemd/system/docker.service;enabled;preset: enabled)Active: active(running)since Sun2026-05-3123:17:28 CST;1month29days ago TriggeredBy: ● docker.socket Docs: https://docs.docker.com Main PID:945(dockerd)Tasks:117Memory:787.7M(peak:1018.4M swap:11.8M swap peak:12.6M)CPU: 58min1.415s CGroup: /system.slice/docker.service3.2 检查Docker版本检查Docker版本rootjeven:~# docker -vDocker version28.5.0, build 887030f3.3 检查docker compose 版本检查Docker compose版本确保2.0以上版本。rootjeven:~# docker compose versionDocker Compose version v2.39.4四、拉取Stirling-PDF镜像4.1 Github地址Github项目地址https://github.com/Stirling-Tools/Stirling-PDF4.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容器如下所示dockerrun-d-p7080:8080 registry.cn-hangzhou.aliyuncs.com/jeson/stirling-pdf5.2 查看Stirling-PDF容器状态检查Stirling-PDF容器运行状态确保Stirling-PDF容器正常启动。rootjeven:~# docker psCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 2f501ed4be81 registry.cn-hangzhou.aliyuncs.com/jeson/stirling-pdftini -- /scripts/in…32seconds ago Up32seconds(healthy)0.0.0.0:7080-8080/tcp,[::]:7080-8080/tcp nostalgic_kirch5.3 检查Stirling-PDF容器日志检查容器运行日志确认 Stirling-PDF 服务是否正常启动并运行。请注意执行命令前需将《容器ID》替换为当前容器的实际 ID。dockerlogs 《容器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编辑与管理任务。