Docker一键部署Stirling-PDF:从零搭建本地专属PDF编辑器
2026/8/24 13:49:43 网站建设 项目流程

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.3

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 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.service

3.2 检查Docker版本

检查Docker版本

root@jeven:~# docker -vDocker version28.5.0, build 887030f

3.3 检查docker compose 版本

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

root@jeven:~# docker compose versionDocker 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容器,如下所示:

dockerrun-d-p7080:8080 registry.cn-hangzhou.aliyuncs.com/jeson/stirling-pdf

5.2 查看Stirling-PDF容器状态

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

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

5.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编辑与管理任务。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询