如何在搬瓦工伺服器上搭建全能PDF處理中心（Stirling PDF）

在日常辦公中，PDF 處理幾乎是必不可少的。無論是合併文檔、頁面拆分、添加水印，還是複雜的 OCR（文字識別）。然而現在大多數 PDF 軟體要麼需要付費，要麼要求註冊帳號，而一些免費的在線轉換網站則存在隱私洩露風險。

本教程將教你如何在搬瓦工的 VPS 上搭建屬於自己的全能PDF處理中心（Stirling PDF）。它不僅功能完整（涵蓋拆分、合併、壓縮、旋轉、OCR 等），而且完全私有化部署，數據不經過第三方伺服器，確保安全。

需要注意，Stirling PDF目前的V2版本的配置要求還是較高的，建議2核2G以上的伺服器安裝，如果你的伺服器配置有限，可以參考本文第三部分的精簡版。

需要準備的事項：

1.擁有一台搬瓦工的伺服器（參考教程）；

2.伺服器在運行，且安裝了debian12系統（參考教程）；

3. SSH 連接工具已準備就緒（例如 Xshell）。

一、連接伺服器並安裝Nginx Proxy Manager

Nginx Proxy Manager 推薦使用 Docker 容器化部署，本部分將一併完成 Docker 環境的安裝。

1.SSH 連接與基礎工具安裝

使用 SSH 工具連接到您的搬瓦工伺服器（推薦使用 Xshell 等工具，如果你是個人或家庭使用，可以下載 Xshell：下載連結），

然後執行下方命令安裝必要的工具。

apt-get install wget curl vim sudo unzip -y

2.安裝並啟動Docker

執行下方命令安裝 Docker，安裝過程預計耗時數十秒。

wget -qO- get.docker.com | bash

Docker 安裝完成後，執行以下命令啟動 Docker 服務並設置開機自啟：

systemctl start docker
systemctl enable docker

3.安裝Stirling PDF

執行下方命令安裝，安裝會有點滿，等待安裝完成

docker run -d \
  -p 8080:8080 \
  -v ./stirling-data:/configs \
  stirlingtools/stirling-pdf:latest

二、訪問Stirling PDF並進行基礎配置

1.訪問Stirling PDF

在瀏覽器中輸入 IP 地址:8080（例如 http://1.2.3.4:8080），登錄並重設密碼。

• 默認用戶名： admin
• 默認密碼： Stirling

2.用戶管理

Stirling PDF 免費版支持最多 5 個用戶管理。如果您是小團隊使用，可以在後台添加成員。

3.功能展示

左上角功能圖標展開，就能看到完整的功能區，支持各種常用PDF功能，且都是免費的。

三、訪問問題和配置優化

1.Stirling PDF不能訪問

可能是訪問地址的8080埠未放行，嘗試放行它。

2.反向代理

為了方便記憶且啟用 HTTPS 加密（提高文件傳輸安全性），建議配合之前教程中的 Nginx Proxy Manager (NPM) 進行反向代理。

如何搭建Nginx Proxy Manager並使用反向代理和遠程桌面加速

反向代理配置：

• 轉發目標： 127.0.0.1
• 埠： 8080
• 注意： 如果需要處理超大 PDF（如幾百 MB），請在 NPM 的配置中調大 client_max_body_size。

3.低配伺服器解決方案

如果你的搬瓦工伺服器內存僅為 1G，安裝完整版可能會導致系統卡頓。

此時建議安裝簡易版（移除了 OCR 等重資源模塊）。

操作步驟（需要先刪除完整版）：

3.1 查找當前運行容器的 ID：docker ps

3.2 停止並刪除舊容器：docker stop <ID> 和 docker rm <ID>

3.3 安裝簡易版

docker run -d \
  -p 8080:8080 \
  -v ./stirling-data:/configs \
  stirlingtools/stirling-pdf:latest-ultra-lite