Stirling PDF 2026 安装包下载与部署使用指南

Stirling PDF 是什么

Stirling PDF 是一款在 GitHub 上拥有超过 30 万 Star、下载量超 3000 万次的开源 PDF 处理工具，提供 50 多种 PDF 操作功能，涵盖合并、拆分、转换、压缩、签名、OCR 文字识别、添加水印、编辑、页面提取、加密解密等常见需求。

与 Adobe Acrobat、PDFelement 等商业软件不同，Stirling PDF 完全开源自托管，可部署在自己的服务器或本地电脑上，所有文件都在本地设备处理，不会上传到第三方服务器，对合同、身份证扫描件等隐私敏感文档较为友好。软件同时提供桌面客户端和浏览器界面两种使用方式，并有开源自托管版（免费，通过 Docker 部署）和官方云服务版（stirling.com，有免费额度）两个版本。

Stirling PDF 安装包下载方式

Stirling PDF 安装包下载地址：Stirling PDF安装包（源自 GitHub 开源仓库，放心使用）夸克网盘下载

Windows 用户下载 .msi 安装包，macOS 用户下载 .dmg 文件，Linux 用户下载 rpm/deb/AppImage 格式。

Stirling PDF 安装步骤

1）Windows 平台安装

下载 .exe 安装包，双击开始安装：

默认安装到 C 盘，有其他盘的建议选择其他盘：

点击 Install 等待安装完成：

点击 Finish：

Stirling PDF 首次启动如下图所示：

2）Docker 部署方式

确保电脑已安装 Docker Desktop（Windows/Mac）或 Docker Engine（Linux）。打开终端（Windows 可用 PowerShell），执行以下命令：

docker run -d -p 8080:8080 -v /opt/stirling-data:/usr/share/stirling-pdf/data —name stirling-pdf stirlingtools/stirling-pdf

命令执行完成后，浏览器访问 http://localhost:8080 即可看到界面。停止服务执行 docker stop stir-pdf，再次启动执行 docker start stir-pdf。

Stirling PDF 基础使用

1）合并 PDF

在首页或导航中点击”合并 PDF”：

上传两个或多个 PDF 文件，拖动调整排列顺序，点击”合并”即可合并成一个 PDF，合并后的文件会自动下载。

Stirling PDF 文件处理均在服务器本地完成，上传文档不会外传。

2）拆分 PDF

点击”拆分 PDF”，上传文件后可选择按页数拆分（每 X 页拆成一个文件）、按范围提取（指定页码）或每页单独拆分。设置好后点击”拆分”，会下载一个包含所有拆分文件的压缩包。

3）PDF 转 Word/Excel/图片

点击”转换”，可将 PDF 转换为 Word（.docx）、Excel（.xlsx）、图片（.png/.jpg）、HTML 等格式，转换后保持原始排版。

反过来也能将 Word、Excel、图片等格式转换成 PDF。OCR 识别功能可识别扫描版 PDF 中的文字内容。

4）添加水印和签名

“添加水印”位于”文档安全”分类，“添加签名”位于”签署”分类，水印支持文字或图片，可设置透明度、位置、旋转角度等。签名功能支持手绘或上传签名图片，签名可保存反复使用。

5）压缩 PDF

“压缩”功能提供多种压缩级别，从低压缩（画质高）到高压缩（文件小），可根据需要选择。一个 50MB 的扫描件压缩后通常可到 10MB 以下。

6）PDF 加密和解密

在”文档安全”分类中，可为 PDF 添加打开密码或权限密码（禁止打印、禁止复制等）。“移除”分类里的”删除密码”功能可去除已加密 PDF 的密码（需知道密码），适合团队内部共享文档时使用。

Stirling PDF 常见问题

问：Docker 部署时提示”port is already allocated”端口被占用怎么办？

答：这是因为 8080 端口已被其他程序占用，修改映射端口即可，比如改成 docker run -d -p 8081:8080 …，然后访问 http://localhost:8081。常见的冲突源包括 Nginx、Apache 或其他 Java 应用。

问：安装后浏览器提示”连接不安全”或者页面打不开？

答：桌面版启动后通常会自动弹出浏览器窗口，如果没有，手动在浏览器地址栏输入 http://localhost:8080 访问，注意是 http 而不是 https，因为本地服务默认不走 SSL。若页面仍打不开，检查桌面版托盘图标是否运行，不行就重启桌面客户端。

问：文件处理完成后无法自动下载？

答：浏览器的弹窗拦截功能可能阻止了自动下载，检查地址栏右侧是否有弹窗拦截提示并允许弹窗。如果仍不行，手动查看 Stirling PDF 界面上的”下载”或”输出”按钮，部分功能处理完成后不会自动下载，而是在页面生成预览，需手动点击下载按钮。

使用提示

Stirling PDF 作为开源免费、功能全面、隐私安全的 PDF 工具，一条 Docker 命令即可部署，或直接安装桌面客户端，就能拥有一个完全本地化的 PDF 处理中心，日常文档操作可以放心交给它。