Stirling-PDF 自托管实战：基于 Docker 与 Cpolar 的多功能 PDF 工具部署指南

Source

Stirling-PDF 自托管实战：基于 Docker 与 Cpolar 的多功能 PDF 工具部署指南

前言

不知道从什么时候开始，PDF已经变成了一种特殊的收费模式。

想合并两个 PDF？

开会员。

想压缩一下文件？

开会员。

想加个水印或者转换格式？

还是开会员。

最离谱的是，有时候只是临时处理一份合同、一份作业或者一份客户资料，结果刚上传文件就弹出熟悉的提示：

继续使用请开通会员。

一次两次还能接受。

时间长了就会发现，我们真正需要的可能只是一个简单功能，却被迫为整套服务买单。

更让我在意的是隐私问题。

很多 PDF 文件里包含合同、报价单、身份证明甚至公司资料。上传到第三方网站处理虽然方便，但这些文件究竟会不会被保存、会不会被分析，我们其实并不清楚。

后来折腾 NAS 和 Docker 时，我发现了 Stirling-PDF。

最开始我以为它只是个普通 PDF 工具，结果打开之后发现几乎把常见需求全包了：合并、拆分、压缩、格式转换、添加水印、加密解密……而且所有操作都在自己的设备上完成，不上传云端、不限次数，也没有会员提示。

接下来，就让我们从零开始，搭建属于你的随身PDF工具箱。

Stirling PDF - 自托管的多功能 PDF 工具 - Tyooe

1.安装Stirling-PDF

使用docker命令一键部署：

docker pull frooodle/s-pdf:latest

image-20250902101817949

docker run -d -p 8080:8080 frooodle/s-pdf:latest

image-20250902101835462

部署完成后，localhosts:8080直接打开：

image-20250902101927026

这样就部署成功啦！

2.简单使用Stirling-PDF

这个页面清晰简洁，我们想要的操作一目了然。

image-20250902102525304

你是否也有这种烦恼，接触pdf格式，没有会员寸步难行，这次我们安装完后，这个问题迎刃而解。

image-20250902102625343

我们来试一下。

image-20250902102643835

无任何压力的直接转为pdf。

image-20250902102702651

尝试将pdf转为照片格式。

image-20250902102731842

轻松完成。

image-20250902102743012

添加专属于我的水印。

image-20250902102758672

成功。

image-20250902102808240

操作是不是特别简单？重点是不用花一分钱！

但如果平时突然接收到紧急任务，我们该怎么办呢，别急，接下来跟我一起部署cpolar，一起实现随时随地，不止电脑，平板、手机都可以操作！

3.安装cpolar实现随时随地开发

cpolar 可以将你本地电脑中的服务（如 SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。配合 VSCode 的 Remote - SSH 插件，你可以从任何设备访问自己的完整开发环境。

❤️以下是安装cpolar步骤：

点击免费注册注册一个账号，并下载最新版本的Cpolar：

image-20250902103628163

登录成功后，点击下载Cpolar到本地并安装（一路默认安装即可）本教程选择下载Windows版本。

image-20250902103645329

Cpolar安装成功后，在浏览器上访问http://localhost:9200，使用cpolar账号登录,登录后即可看到Cpolar web 配置界面,结下来在web 管理界面配置即可。

image-20250902103702081

4.配置公网地址

通过配置，你可以在本地 WSL 或 Linux 系统上运行 SSH 服务，并通过 Cpolar 将其映射到公网，从而实现从任意设备远程连接开发环境的目的。

  • 隧道名称：可自定义，本例使用了:pdf，注意不要与已有的隧道名称重复

  • 协议：http

  • 本地地址：8080

  • 域名类型：随机域名

  • 地区：China Top

image-20250902104116520

创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地）上，使用任意一个地址在终端中访问即可。

  • http表示使用的协议类型

  • b93098d.r2.cpolar.top是Cpolar提供的域名

    image-20250902104146684

通过 Cpolar 提供的公网地址，就可以随时随地进入本网站啦！

http://b93098d.r2.cpolar.top

image-20250902104607024

5.保留固定公网地址

使用cpolar为其配置固定二级子域名公网地址，该地址为固定地址，不会随机变化。

image-20250902104650920

选择区域和描述：有一个下拉菜单，当前选择的是“China Top”。
右侧输入框，用于填写描述信息。
保留按钮：在右侧有一个橙色的“保留”按钮，点击该按钮可以保留所选的二级子域名。
列表中显示了一条已保留的子域名记录。

  • 地区：显示为“China Top”。
  • 二级子域名：显示为“pdf”。

image-20250902104825327

登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道pdf，点击右侧的编辑。

image-20250902104846769

修改隧道信息，将保留成功的二级域名配置到隧道中。

  • 域名类型：选择二级子域名
  • Sub Domain：pdf

点击更新。

image-20250902104924584

创建完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名。

image-20250902104953816

最后测试一下固定的地址是否好用：

image-20250902105040443

这样，就可以随时随地编辑文件啦。

总结

体验下来，Stirling-PDF 最大的价值并不是功能丰富。

而是让 PDF 处理重新回归工具本身。

以前很多在线 PDF 平台的核心逻辑是：

免费使用
↓
限制功能
↓
诱导开会员

而 Stirling-PDF 的思路恰好相反。

所有功能都部署在自己的设备上，所有文件都保存在自己的环境里。你需要的时候打开浏览器即可使用，不需要担心文件上传到第三方平台，也不需要担心某一天功能突然被限制。

对于经常处理合同、方案、技术文档和各种办公文件的人来说，这种体验会非常舒服。因为真正影响效率的从来不是功能不够，而是在最需要的时候突然被会员挡住。

而通过 cpolar 提供的公网访问能力后，这套工具也不再局限于家里的电脑。无论是在公司、高铁上还是出差途中，都能够通过手机或平板直接访问自己的 PDF 工作站，实现真正的跨设备办公。

这些年我装过很多办公软件。

但真正让我留下来的工具都有一个共同特点：

它们不会在你最着急的时候提醒你充值。

而是在你最需要的时候，安静地把事情做好。