全功能PDF工具箱Stirling-PDF部署指南

一、 为什么要自己部署 PDF 工具？

• 痛点：市面上的 PDF 编辑器要么收费贵，要么有次数限制，要么担心隐私泄露（文件传到别人的服务器）。

• Stirling-PDF，开源界的“瑞士军刀”，合并、分割、OCR、格式转换样样精通，且完全私有化。支持团队使用

二、 环境准备

• 服务器：推荐 ARM 架构（如甲骨文云）或普通 VPS，内存建议 2G 以上。

• 工具：宝塔面板 + Docker 插件。

三、 避坑部署（重点：内存优化）

这里可以分享我们刚才讨论的核心命令，一定要提醒读者限制内存，否则会撑爆小内存 VPS：

docker run -d \  --name pdf \  -p 8080:8080 \  --restart always \  --memory="2g" \  -e DOCKER_ENABLE_SECURITY=false \  -e INSTALL_UNKNOWN_LOCALE=true \  docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest

四、 宝塔反向代理设置

• 步骤：新建站点 -> 反向代理 -> 目标指向 127.0.0.1:8080。

• 进阶技巧：如何关闭缓存防止 502。

• 发送域名：建议留空或填入自己的域名。

• 

五、 商业化变现：如何植入广告代码？

这是很多号主最关心的。分享如何利用宝塔的**“内容替换”**功能，无损植入广告脚本。

• 查找：</body>

• 替换：<script src="你的广告代码"></script></body>

六、 常见问题排查（QA）

• 502 报错：Java 程序启动慢，需耐心等待 2-3 分钟。

• 磁盘占用：记得定期 pm2 flush 或清理 Docker 残留。

• 防火墙：别忘了在宝塔和云服务器后台同时放行端口。