查看“︁如何在搬瓦工服务器上搭建全能PDF处理中心（Stirling PDF）”︁的源代码

在日常办公中，PDF 处理几乎是必不可少的。无论是合并文档、页面拆分、添加水印，还是复杂的 OCR（文字识别）。然而现在大多数 PDF 软件要么需要付费，要么要求注册账号，而一些免费的在线转换网站则存在隐私泄露风险。

本教程将教你如何在搬瓦工的 VPS 上搭建属于自己的全能PDF处理中心（Stirling PDF）。它不仅功能完整（涵盖拆分、合并、压缩、旋转、OCR 等），而且完全私有化部署，数据不经过第三方服务器，确保安全。

需要注意，Stirling PDF目前的V2版本的配置要求还是较高的，建议2核2G以上的服务器安装，'''如果你的服务器配置有限，可以参考本文第三部分的精简版'''。

=== 需要准备的事项： ===
1.拥有一台搬瓦工的服务器（[https://vpsmes.com/602.html 参考教程]）；

2.服务器在运行，且安装了debian12系统（[https://vpsmes.com/615.html 参考教程]）；

3. SSH 连接工具已准备就绪（例如 Xshell）。

=== 一、连接服务器并安装Nginx Proxy Manager ===
Nginx Proxy Manager 推荐使用 Docker 容器化部署，本部分将一并完成 Docker 环境的安装。

==== 1.SSH 连接与基础工具安装 ====
使用 SSH 工具连接到您的搬瓦工服务器（推荐使用 Xshell 等工具，如果你是个人或家庭使用，可以下载 Xshell：[https://www.xshell.com/zh/free-for-home-school/ 下载链接]），

然后执行下方命令安装必要的工具。<syntaxhighlight lang="abap">apt-get install wget curl vim sudo unzip -y</syntaxhighlight>

==== 2.安装并启动Docker ====
执行下方命令安装 Docker，安装过程预计耗时数十秒。<syntaxhighlight lang="abap">wget -qO- get.docker.com | bash</syntaxhighlight>Docker 安装完成后，执行以下命令启动 Docker 服务并设置开机自启：<syntaxhighlight lang="abap">
systemctl start docker
systemctl enable docker
</syntaxhighlight>

==== 3.安装Stirling PDF ====
执行下方命令安装，安装会有点满，等待安装完成<syntaxhighlight lang="abap">
docker run -d \
  -p 8080:8080 \
  -v ./stirling-data:/configs \
  stirlingtools/stirling-pdf:latest
</syntaxhighlight>[[File:Pdf安装完全版.png|900x900px]]

=== 二、访问Stirling PDF并进行基础配置 ===

==== 1.访问Stirling PDF ====
在浏览器中输入 '''IP 地址:8080'''（例如 [http://1.2.3.4:8080），登录并重设密码。 <code>http://1.2.3.4:8080</code>），登录并重设密码。]
* '''默认用户名：''' <code>admin</code>
* '''默认密码：''' <code>Stirling</code>

[[File:Pdf登陆界面.png|900x900px]]

==== 2.用户管理 ====
Stirling PDF 免费版支持最多 5 个用户管理。如果您是小团队使用，可以在后台添加成员。

[[File:添加成员.png|900x900px]]

==== 3.功能展示 ====
左上角功能图标展开，就能看到完整的功能区，支持各种常用PDF功能，且都是免费的。

[[File:Pdf功能区.png|900x900px]]

=== 三、访问问题和配置优化 ===

==== 1.Stirling PDF不能访问 ====
可能是访问地址的8080端口未放行，尝试放行它。

==== 2.反向代理 ====
为了方便记忆且启用 HTTPS 加密（提高文件传输安全性），建议配合之前教程中的 Nginx Proxy Manager (NPM) 进行反向代理。

[https://md5.pw/%E5%A6%82%E4%BD%95%E6%90%AD%E5%BB%BANginx_Proxy_Manager%E5%B9%B6%E4%BD%BF%E7%94%A8%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E5%92%8C%E8%BF%9C%E7%A8%8B%E6%A1%8C%E9%9D%A2%E5%8A%A0%E9%80%9F 如何搭建Nginx Proxy Manager并使用反向代理和远程桌面加速]

'''反向代理配置：'''

* '''转发目标：''' <code>127.0.0.1</code>
* '''端口：''' <code>8080</code>
* '''注意：''' 如果需要处理超大 PDF（如几百 MB），请在 NPM 的配置中调大 <code>client_max_body_size</code>。

==== 3.低配服务器解决方案 ====
如果你的搬瓦工服务器内存仅为 1G，安装完整版可能会导致系统卡顿。

此时建议安装简易版（移除了 OCR 等重资源模块）。

'''操作步骤（需要先删除完整版）：'''

'''3.1''' 查找当前运行容器的 ID：<code>docker ps</code>

'''3.2''' 停止并删除旧容器：<code>docker stop <ID></code> 和 <code>docker rm <ID></code>

'''3.3''' 安装简易版<syntaxhighlight lang="abap">
docker run -d \
  -p 8080:8080 \
  -v ./stirling-data:/configs \
  stirlingtools/stirling-pdf:latest-ultra-lite
</syntaxhighlight>[[File:Pdf简易版.png|900x900px]]
[[Category:500 常见应用指南 — Application Guides]]