敏感PDF不想上传陌生网站？我把Stirling-PDF装进NAS自己处理

前言

合同、身份证、财务文件这种PDF，我越来越不愿意随手丢进一个刚从搜索结果里找到的网站。

不是因为可以证明那些网站一定会"偷存文件"，而是因为我根本不知道对方后台到底怎么处理、保存多久、谁能访问。对普通资料可能无所谓，但敏感文件我更希望处理环境在自己手里。

所以这次我把Stirling-PDF装进了NAS。

合并、转换、加水印、裁剪都在自己的Stirling-PDF实例里做，不需要每次换一个在线网站。家里直接走局域网；人在外面真有需求，再通过cpolar连回自己的页面。

下面从Docker Compose开始，把2223端口、本地PDF处理和远程访问这一整条链跑通。

1.这里的"S-PDF"到底是什么？

先把一个容易误解的地方说清楚：S-PDF不是一个正式的软件名，也不是行业标准术语。原稿实际上是用它来指代"Self-hosted PDF"这一类自托管PDF工具，而本文真正部署的软件是Stirling-PDF。

因此下面统一把它写成"自托管PDF工具"，并以Stirling-PDF作为实际实现。

自托管的核心优势，是文档提交到你自己的Stirling-PDF实例处理，而不是交给一个陌生的公共PDF网站。它能减少第三方平台接触文件的范围，但并不等于"绝对不会泄露"：账号、服务器、公网入口和网络传输仍然需要自己保护。

自托管PDF工具的关键特征

特性	说明
🔒 自己控制处理位置	文件提交到自己的服务器/电脑，而不是公共在线PDF站点。
🛡️ 降低第三方暴露面	公共PDF服务商不参与处理，但仍需保护自己的服务器、账号和公网入口。
✅ 功能完整	支持合并、拆分、压缩、加密、OCR、格式转换等常见PDF操作。
📚 开源可审计	通常基于如 `PDFtk`、`qpdf`、`LibreOffice`、`Tesseract` 等成熟开源库构建，代码透明。
🌐 私有Web 界面	提供类似在线工具的图形界面（如网页），但仅限内网或授权用户访问。

对比：在线PDF工具vs. 自建S-PDF

项目	在线PDF工具（如 Smallpdf、iLovePDF）	自建S-PDF
数据流向	上传 → 第三方服务器 → 处理 → 下载	上传 → 你的服务器 → 处理 → 下载
隐私保障	取决于具体服务商的隐私政策与实现	处理环境由自己控制，可减少对公共第三方的依赖
网络要求	必须联网	可完全离线运行
成本	取决于具体第三方服务规则	软件可自托管，仍需自己的设备、电力和维护成本
安全性	取决于具体服务商和部署	可自行配置认证、网络、日志与访问控制

对合同、证件、财务资料等不希望提交到陌生第三方网站的文件，自托管方案更值得考虑；但涉及正式合规要求时，还需要结合组织自己的安全、审计和数据管理制度。

常见的自托管/本地PDF工具

虽然没有统一叫 "S-PDF" 的软件，但以下项目可作为自建安全PDF工具的基础：

PDF Arranger

轻量级桌面工具（Linux/Windows），支持合并、拆分、旋转。
Stirling-PDF（最接近"S-PDF"概念）

功能强大的自托管Web PDF工具箱，支持50+ 操作，Docker一键部署，界面媲美商业在线工具。
PDFsam Basic

开源桌面应用，专注分割与合并。
基于LibreOffice + OCR的自建脚本

适合集成到企业内部系统。

本文选择Stirling-PDF，是因为它提供Web界面、Docker部署和较完整的PDF处理功能。

本文后续统一使用软件真实名称：Stirling-PDF。

自托管强调的是处理环境由自己控制，不代表文件天然"无痕"或系统天然安全。

如果经常处理敏感PDF，又不希望每次都上传到陌生网站，自托管Stirling-PDF是一条更可控的路线。

2.部署前准备

2.1 通过SSH连接极空间

开启【SSH 服务】
使用终端（Windows PowerShell / Mac Terminal）登录：

shell 复制代码

ssh root@IP

没有ssh的小伙伴可以参考这篇文章：

连接成功：极空间别再吃灰了！开启SSH，秒变全能服务器！ - cpolar 极点云官网

2.2 确认Docker环境

先确认Docker可用：

shell 复制代码

docker -v 
systemctl status -v

没有docker的小伙伴可以参考这篇文章：极空间开箱实录：从拆箱到远程访问保姆级教程，30分钟上手！ - cpolar 极点云官网

3.使用Docker Compose部署Stirling-PDF

本文使用Docker Compose部署Stirling-PDF。

2026版本说明 ：原稿使用frooodle/s-pdf:latest，当前官方Docker文档已经改为docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest。当前标准镜像默认启用登录，并建议挂载/configs目录做持久化。下面的Compose已按当前官方方式更新。

可以先再次确认Docker版本：

shell 复制代码

docker --version

创建单独的部署目录并进入：

shell 复制代码

mkdir -p /docker/stirling-pdf
cd /docker/stirling-pdf

然后创建并编辑docker-compose.yml：

shell 复制代码

vi docker-compose.yml

yaml 复制代码

services:
  stirling-pdf:
    image: docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest
    container_name: stirling-pdf
    ports:
      - '2223:8080'
    volumes:
      - ./stirling-data:/configs
      - ./logs:/logs
      - ./tessdata:/usr/share/tessdata
    restart: unless-stopped