私密PDF处理工具Stirling本地部署指南，Docker容器化方案50+功能完整教程

项目介绍

Stirling-PDF 是一款功能强大的本地化 PDF 处理工具，采用 Docker 容器化部署方案。它提供了超过 50 项 PDF 操作功能，包括文件合并、分割、格式转换、页面重组、添加水印、数字签名、OCR 识别等全方位的 PDF 处理能力。

这是一个完全私密的解决方案，所有文件处理都在本地进行。上传的 PDF 文件要么只存在于客户端，要么在服务器内存中进行临时处理，任务完成后会立即删除，无需担心数据泄露。无论是个人用户还是企业团队，都能找到适合的部署方案。

项目地址：点我跳转

部署安装

如果你想在外网也能访问项目，建议配置内网穿透工具。可以选择帕斯内网穿透来实现远程访问，先注册好账号以备后用。具体的操作步骤可以参考这份详细攻略，涵盖了各种平台的上手方法。

Docker 单命令快速启动

打开你的 NAS 设备或任何支持 Docker 的系统，执行以下命令即可一键启动 Stirling-PDF：

1docker run -d -p 8080:8080 -v /path/to/data:/usr/share/stirlingpdf/data --name stirling-pdf frooodle/s-pdf:latest

参数说明：

-d ：后台运行容器 -p 8080:8080 ：将容器的 8080 端口映射到主机的 8080 端口（如果 8080 端口已被占用，可改为其他端口，如 -p 8081:8080） -v /path/to/data:/usr/share/stirlingpdf/data ：挂载数据目录用于持久化存储，请根据实际情况修改 /path/to/data 为你的本地路径

关于端口： 容器内部使用 8080 端口运行服务。如果你的主机上 8080 端口已被其他应用占用，只需修改冒号前的数字即可。例如想用 8081 端口访问，改为 -p 8081:8080 就行。

关于存储： 如果需要保存处理过的文件或配置信息，请提前在主机上创建一个文件夹，然后通过 -v 参数将其挂载进容器。这样即使容器重启，数据也不会丢失。

环境变量配置

Stirling-PDF 支持多种环境变量自定义配置，以下是常用的选项：

必须设置：

无强制性必设环境变量

可选设置：

LANG：设置应用语言（默认：en_US） TZ：设置时区（默认：UTC） DOCKER_ENABLE_SECURITY：启用安全功能（默认：false） SECURITY_ENABLE_LOGIN：启用登录认证（默认：false） SECURITY_INITIALLOGIN_USERNAME：初始登录用户名（默认：admin） SECURITY_INITIALLOGIN_PASSWORD：初始登录密码（默认：stirling）

如果你需要启用登录功能，可以这样启动：

1docker run -d -p 8080:8080 \
2  -e SECURITY_ENABLE_LOGIN=true \
3  -e SECURITY_INITIALLOGIN_USERNAME=admin \
4  -e SECURITY_INITIALLOGIN_PASSWORD=yourpassword \
5  -v /path/to/data:/usr/share/stirlingpdf/data \
6  --name stirling-pdf frooodle/s-pdf:latest

其他环境变量保持默认即可，无需额外配置。

访问应用

容器启动成功后，在浏览器中访问：

1http://你的主机IP:8080

如果是本地访问，可以直接打开：

1http://localhost:8080

到这里就能看到 Stirling-PDF 的完整界面了，可以开始上传 PDF 文件进行各种操作。

总结

通过以上步骤，你已经成功部署了 Stirling-PDF。这个强大的 PDF 工具箱现在就在你的手中，无论是合并多个文件、转换格式，还是添加数字签名，都能轻松搞定。所有处理都在本地完成，数据安全有保障。祝你使用愉快！

本篇教程到此结束。