前言
临时合并两份 PDF、把扫描件压缩一下、给文档加水印,很多时候我们第一反应都是打开一个在线 PDF 网站。
这样确实方便,但如果处理的是合同、工作资料、证件扫描件或者其他不适合交给陌生网站的文件,就会多一个问题:这些文件到底被上传到了哪里,又会保留多久?
Stirling-PDF 提供的是一种自托管方案。把它运行在自己的电脑、NAS 或服务器上以后,浏览器打开一个页面,就可以使用合并、拆分、转换、压缩、水印、OCR 等一系列 PDF 工具,具体处理任务由自己的 Stirling-PDF 实例完成。
本文会通过 Docker 部署 Stirling-PDF,持久化配置目录,完成首次登录和密码修改,再实际测试格式转换、水印等几个常用功能。
本地 8080 端口确认正常以后,再通过 cpolar为这个 Web 服务增加外部访问入口。这样人在其他网络环境中,也可以继续用手机、平板或电脑打开自己部署的 PDF 工具页面,而不用临时寻找不同的在线处理网站。

1.安装Stirling-PDF
使用docker命令一键部署:
shell
docker pull frooodle/s-pdf:latest

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

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

这样就部署成功啦!
2.简单使用Stirling-PDF
这个页面清晰简洁,我们想要的操作一目了然。

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

我们来试一下。

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

尝试将pdf转为照片格式。

轻松完成。

添加专属于我的水印。

成功。

操作是不是特别简单?重点是不用花一分钱!
但如果平时突然接收到紧急任务,我们该怎么办呢,别急,接下来跟我一起部署cpolar,一起实现随时随地,不止电脑,平板、手机都可以操作!
3.安装cpolar实现随时随地开发
cpolar 可以将你本地电脑中的服务(如 SSH、Web、数据库)映射到公网。即使你在家里或外出时,也可以通过公网地址连接回本地运行的开发环境。配合 VSCode 的 Remote - SSH 插件,你可以从任何设备访问自己的完整开发环境。
❤️以下是安装cpolar步骤:
点击免费注册注册一个账号,并下载最新版本的Cpolar:

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

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

4.配置公网地址
通过配置,你可以在本地 WSL 或 Linux 系统上运行 SSH 服务,并通过 Cpolar 将其映射到公网,从而实现从任意设备远程连接开发环境的目的。
-
隧道名称:可自定义,本例使用了:pdf,注意不要与已有的隧道名称重复
-
协议:http
-
本地地址:8080
-
域名类型:随机域名
-
地区:China Top

创建成功后,打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址,接下来就可以在其他电脑或者移动端设备(异地)上,使用任意一个地址在终端中访问即可。
-
http表示使用的协议类型
-
b93098d.r2.cpolar.top是Cpolar提供的域名

通过 Cpolar 提供的公网地址,就可以随时随地进入本网站啦!
shell
http://b93098d.r2.cpolar.top

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

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

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

修改隧道信息,将保留成功的二级域名配置到隧道中。
- 域名类型:选择二级子域名
- Sub Domain:pdf
点击更新。

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

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

这样,就可以随时随地编辑文件啦。
总结
Stirling-PDF 最实用的地方,其实不是某一项 PDF 功能特别稀有,而是把很多日常会用到的操作集中到了一个自己可以部署的页面里。
合并、拆分、转换、水印、压缩、OCR 等任务不需要每次重新寻找不同网站,处理服务也运行在自己的电脑、NAS 或服务器上。对于经常处理工作资料、扫描件和各种 PDF 文档的人来说,这种统一入口会方便很多。
通过 cpolar增加远程访问以后,这套工具还可以从家庭或办公室网络之外继续使用。但这时它就已经从"本地小工具"变成了一个能够接收文件的公网 Web 服务,因此账号认证不能省略。首次部署后应及时修改默认管理员密码,也不要为了少一步登录就直接关闭认证后开放公网。
如果准备长期运行,还应把 Stirling-PDF 的配置目录持久化,并在升级容器之前做好备份。
所以这套方案真正解决的并不是"以后所有 PDF 都必须自己处理",而是多了一个选择:遇到不想上传公共在线网站的文件时,手里有一套自己维护、随时可以打开的 PDF 工具箱。
