菜单

概述

相关源文件

Stirling-PDF 是一款功能强大的本地托管网页版 PDF 处理工具,允许用户对 PDF 文件执行全方位的操作。它通过用户友好的网页界面提供 50 多种 PDF 处理功能,所有处理均在本地进行,以确保文件隐私和安全。

本文档提供了 Stirling-PDF 系统架构、关键组件和功能组织的概述。有关具体配置的信息,请参阅配置系统;有关详细部署说明,请参阅部署

系统架构

Stirling-PDF 是一个 Spring Boot 应用程序,采用分层架构构建,将表示层、业务逻辑层和外部工具集成层分离。

核心架构图

来源

主要功能

Stirling-PDF 在用户界面中提供了按逻辑分类的全面 PDF 处理功能。

PDF 操作类别

来源

用户界面

Stirling-PDF 用户界面采用响应式网页设计方法构建,可在各种设备上访问。用户界面由导航栏、主页和特定操作界面组成。

主要用户界面组件

来源

国际化支持

Stirling-PDF 具有广泛的国际化支持,提供 39 种以上语言的用户界面。

语言和国际化系统

来源

部署选项

Stirling-PDF 支持多种部署选项,以适应从个人用户到企业环境的不同用例。

部署方法

部署方法描述配置
Docker 镜像基于容器的部署,支持不同的镜像变体(常规、超轻、完整)Docker 配置文件
原生安装在 Windows、macOS 或 Linux 上直接安装JAR 文件、平台特定安装程序
开发环境设置面向项目贡献者(开发者)使用 Gradle 从源代码构建

来源

系统要求

Stirling-PDF 设计为可在具有不同配置的各种平台上运行,但要实现全部功能,需要某些依赖项。

核心要求

  • Java 运行时:最低 Java 17,推荐 Java 21
  • 外部工具(可选,取决于所用功能)
    • LibreOffice,用于文件格式转换
    • Tesseract OCR,用于文本识别
    • QPDF,用于高级 PDF 压缩
    • Weasyprint,用于 HTML/Markdown 到 PDF 转换

硬件建议

Stirling-PDF 可以在适度的硬件上运行以执行基本操作,但像 OCR 或大型文档处理等更密集型任务将受益于额外的资源。

来源

安全特性

Stirling-PDF 提供可选的安全和认证机制,可根据部署需求启用。

认证方法

方法描述配置
表单登录用户名/密码认证安全配置
OAuth2通过外部 OAuth2 提供商认证OAuth2 客户端配置
SAML2通过 SAML 实现企业单点登录SAML2 服务提供商配置
API密钥通过 API 密钥进行程序化访问API 安全配置

来源

结论

Stirling-PDF 是一款功能全面、特性丰富的 PDF 处理工具,专为本地部署设计,重点关注隐私和安全。其模块化架构、广泛的功能集和多种部署选项使其适用于从个人用户到企业环境的各种用例。

有关系统特定方面的更多详细信息,请参阅本文档开头提及的相关维基页面。