【Docker項目實戰(zhàn)篇】Docker部署PDF多功能工具Stirling

獨孤求財 2024-09-06 發(fā)布于廣東

展開全文

前言

之前使用Docker部署過Stirling-PDF項目，當時的版本為0.22.2，其中部分功能使用起來可能存在bug?，F(xiàn)在該項目已經(jīng)更新到了0.26.1版本，部分bug得到修復(fù)，同時Stirling-PDF界面有了較大變化，更加的美觀，現(xiàn)在來體驗一下新版本以及功能。

一、Stirling-PDF介紹

1.1 Stirling-PDF簡介

Stirling-PDF：這是一個使用 Docker 的強大的、本地托管的基于 Web 的 PDF 操作工具。它使您能夠?qū)?PDF 文件執(zhí)行各種操作，包括拆分、合并、轉(zhuǎn)換、重新組織、添加圖像、旋轉(zhuǎn)、壓縮等。這個本地托管的 Web 應(yīng)用程序已經(jīng)發(fā)展到包含一套全面的功能，可以滿足您的所有 PDF 需求。

1.2 Stirling-PDF功能

功能分類	功能說明
頁面操作	查看和修改PDF：使用PDF.js與Joxit及Liberation字體，支持多頁PDF瀏覽、自定義排序、搜索以及頁面注釋、繪圖、添加文字和圖片功能。
	全交互式GUI：用于合并、拆分、旋轉(zhuǎn)、移動PDF及其頁面。
	合并PDF：將多個PDF合并成單個文件。
	拆分PDF：按指定頁碼拆分為多個文件或提取所有頁面為獨立文件。
	重新組織頁面順序。
	旋轉(zhuǎn)PDF：以90度為單位旋轉(zhuǎn)。
	刪除頁面。
	多頁布局：將PDF格式化為多頁頁面。
	縮放頁面內(nèi)容大小。
	調(diào)整對比度。
	裁剪PDF。
	自動拆分掃描的PDF（基于物理分隔）。
	提取頁面。
	將PDF轉(zhuǎn)換為單頁。
轉(zhuǎn)換操作	PDF與圖片互轉(zhuǎn)。
	常見文件轉(zhuǎn)換為PDF（使用LibreOffice）。
	PDF轉(zhuǎn)換為Word/PPT/其他格式（使用LibreOffice）。
	HTML轉(zhuǎn)PDF。
	URL轉(zhuǎn)PDF。
	Markdown轉(zhuǎn)PDF。
安全與權(quán)限	添加/移除密碼。
	更改/設(shè)置PDF權(quán)限。
	添加水印。
	簽名/認證PDF。
	清理PDF。
	自動屏蔽敏感文字。
其他操作	添加/生成/編寫簽名。
	修復(fù)PDF。
	檢測并移除空白頁。
	比較兩個PDF并顯示文本差異。
	向PDF中添加圖片。
	壓縮PDF以減小文件大?。ㄊ褂肙CRMyPDF）。
	從PDF中提取圖片。
	從掃描件中提取圖片。
	添加頁碼。
	根據(jù)PDF頭部文本自動重命名文件。
	對PDF進行OCR處理（使用OCRMyPDF）。
	轉(zhuǎn)換為PDF/A標準（使用OCRMyPDF）。
	編輯元數(shù)據(jù)。
	扁平化PDF。
	獲取PDF所有信息，可查看或?qū)С鰹镴SON。

二、本次實踐規(guī)劃

2.1 本地環(huán)境規(guī)劃

本次實踐為個人測試環(huán)境，操作系統(tǒng)版本為centos7.6。

hostname	IP地址	操作系統(tǒng)版本	Docker版本	Stirling-PDF版本
ubuntu-docker	192.168.3.86	Ubuntu 22.04.1 LTS	24.0.7	0.26.1

2.2 本次實踐介紹

1.本次實踐部署環(huán)境為個人測試環(huán)境，生產(chǎn)環(huán)境請謹慎；
2.在Docker環(huán)境下部署PDF多功能工具Stirling-PDF。

三、本地環(huán)境檢查

3.1 檢查Docker服務(wù)狀態(tài)

檢查Docker服務(wù)是否正常運行，確保Docker正常運行。

代碼語言：bash

復(fù)制

root@ubuntu-docker:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Fri 2024-06-21 16:45:29 UTC; 9h ago
TriggeredBy: ● docker.socket
       Docs: https://docs.
   Main PID: 3625 (dockerd)
      Tasks: 12
     Memory: 26.0M
        CPU: 3.367s
     CGroup: /system.slice/docker.service

3.2 檢查Docker版本

檢查Docker版本

代碼語言：bash

復(fù)制

root@ubuntu-docker:~# docker  -v
Docker version 24.0.7, build 24.0.7-0ubuntu2~22.04.1

3.3 檢查docker compose 版本

檢查Docker compose版本，確保2.0以上版本。

代碼語言：bash

復(fù)制

root@ubuntu-docker:~#  docker compose version
Docker Compose version v2.19.1

四、下載Stirling-PDF鏡像

使用本人的阿里云私人鏡像倉庫下載Stirling-PDF鏡像registry.cn-hangzhou.aliyuncs.com/jeson/s-pdf:0.26.1-fat

代碼語言：bash

復(fù)制

root@ubuntu-docker:~# docker pull   registry.cn-hangzhou.aliyuncs.com/jeson/s-pdf:0.26.1-fat
0.26.1-fat: Pulling from jeson/s-pdf
d25f557d7f31: Pull complete
c1f8f1be6b13: Pull complete
1f66901a7ce5: Pull complete
64608eef7b1e: Pull complete
b3900a49ca85: Pull complete
cea40baf48ce: Pull complete
Digest: sha256:67ee927cc5b499e32164c25cad5197e9226ced31d319282a7a346b912063909c
Status: Downloaded newer image for registry.cn-hangzhou.aliyuncs.com/jeson/s-pdf:0.26.1-fat
registry.cn-hangzhou.aliyuncs.com/jeson/s-pdf:0.26.1-fat

五、部署Stirling-PDF

5.1 創(chuàng)建部署目錄

創(chuàng)建部署目錄

代碼語言：bash

復(fù)制

mkdir -p /data/s-pdf && cd /data/s-pdf

5.2 編輯部署文件

在/data/s-pdf目錄，創(chuàng)建docker-compose.yaml文件，內(nèi)容如下，其中宿主機映射端口、登錄賬號密碼等可以自定義配置。

代碼語言：bash

復(fù)制

version: '3.9'
services:
  stirling-pdf:
    image: registry.cn-hangzhou.aliyuncs.com/jeson/s-pdf:0.26.1-fat
    container_name: Stirling-PDF
    ports:
      - '6080:8080'
    volumes:
      - /data/s-pdf/trainingData:/usr/share/tessdata    # OCR 語言支持
      - /data/s-pdf/extraConfigs:/configs
      - /data/s-pdf/customFiles:/customFiles/
      - /data/s-pdf/logs:/logs/
    environment:
      DOCKER_ENABLE_SECURITY: true    # 啟用內(nèi)部安全功能
      SECURITY_ENABLELOGIN: true    # 啟用登錄功能
      SECURITY_INITIALLOGIN_USERNAME: jeven    # Stirling-PDF登錄賬號
      SECURITY_INITIALLOGIN_PASSWORD: jeven    # Stirling-PDF登錄密碼
      UI_APPNAME: jeven-PDF    # 自定義導(dǎo)航標題
      INSTALL_BOOK_AND_ADVANCED_HTML_OPS: false
      LANGS: zh_CN    # 設(shè)置語言

5.3 創(chuàng)建Stirling-PDF容器

執(zhí)行以下命令，創(chuàng)建Stirling-PDF容器。

代碼語言：bash

復(fù)制

root@ubuntu-docker:/data/s-pdf# docker compose up -d
[+] Running 2/2
 ? Network s-pdf_default   Created                                                                                                                                 0.0s
 ? Container Stirling-PDF  Started                                                                                                                                 0.3s

5.4 查看Stirling-PDF容器狀態(tài)

檢查tirling-PDF容器狀態(tài)狀態(tài)，確保Stirling-PDF容器正常啟動。

代碼語言：bash

復(fù)制

[root@ubuntu-docker:/data/s-pdf# docker compose ps
NAME                IMAGE                                                      COMMAND                  SERVICE             CREATED             STATUS              PORTS
Stirling-PDF        registry.cn-hangzhou.aliyuncs.com/jeson/s-pdf:0.26.1-fat   "tini -- /scripts/in…"   stirling-pdf        58 seconds ago      Up 57 seconds       0.0.0.0:6080->8080/tcp, :::6080->8080/tcp