个人总结 docker搭建PDF操作工具

PDF工具

Stirling - PDF：

• 格式支持：主要针对 PDF 文件，。
• 功能特点：是一个强大的本地托管的基于 Web 的 PDF 操作工具，可对 PDF 文件执行各种操作，包括拆分、合并、转换、重新组织、添加图像、旋转、压缩等。支持自定义查看排序和搜索多页 PDF，还有页面编辑功能，如注释、绘制和添加文本及图像等

5.1、部署 Stirling - PDF

1. 创建工作目录与配置文件，

   sudo mkdir project-striling

   推荐工程目录结构：

   docker-projects/
   ├── project-striling/  # striling项目目录
       ├── docker-compose.yml  # striling的配置文件
       └── data/  # 数据存储目录

2. 创建docker-compose.yml文件，此文件将用于定义 Stirling - PDF 容器的各项配置

   version: '3.8'
   
   services:
     stirling-pdf:
       container_name: stirling-pdf
       image: frooodle/s-pdf:latest
       ports:
         - "8380:8080"  # 主机端口:容器端口
       volumes:
         - ./data:/data  # 配置和用户数据
         - ./tesseract:/usr/share/tesseract-ocr/5/tessdata  # OCR语言包
         - ./custom-fonts:/customFonts  # 自定义字体
       environment:
         # 基础配置
         - PUID=1000  # 用户ID，与主机用户匹配避免权限问题
         - PGID=1000  # 用户组ID
         - UMASK=022  # 文件权限掩码
         
         # 安全设置
         - DOCKER_ENABLE_SECURITY=true  # 启用安全功能
         - SECURITY_ENABLELOGIN=true  # 强制登录（默认账号: admin/密码: stirling）
         
         # 界面配置
         - UI_APPNAME=Stirling PDF  # 应用名称
         - UI_HOMEDESCRIPTION=Powered by Docker  # 首页描述
         
         # 性能优化
         - JAVA_OPTS=-Xmx1024m  # 限制Java内存使用（根据服务器内存调整）
         - SYSTEM_MAXFILESIZE=100  # 最大文件上传大小（MB）
         
         # OCR配置（可选）
         - TESSERACT_LANGS=eng+chi_sim  # 默认OCR语言（英文+简体中文）
       restart: unless-stopped  # 容器自动重启策略

   配置说明：

   1. 服务定义：
      • stirling-pdf：主服务容器，使用官方最新镜像。
      • fluentd（可选）：日志收集服务，演示多容器协同工作。
   2. 端口映射：
      • 8380:8080：将容器内的 8080 端口映射到主机的 8380 端口，可通过 http://服务器IP:8380 访问。
   3. 数据卷：
      • ./data：存储用户上传的文件、配置和处理结果。
      • ./tesseract：OCR 语言包目录，支持中文识别。
      • ./custom-fonts：自定义字体目录，用于 PDF 生成和编辑。
   4. 环境变量：
      • PUID/PGID：与主机用户 ID 匹配，避免权限冲突。
      • SECURITY_ENABLELOGIN：启用登录验证，保护服务安全。
      • JAVA_OPTS：限制 Java 内存使用，防止容器占用过多资源。

3. 启动容器

   docker-compose up -d

4. 验证部署

   docker-compose ps  # 查看容器状态
   docker compose logs -f stirling-pdf-logger

5.2、访问服务

​ 打开浏览器，访问 http://服务器IP:8380，使用默认账号 admin 和密码 stirling 登录（首次登录后会提示修改密码）。

http://xx.xx.xx.xx:8380/?lang=zh_CN

---