这个开源PDF神器把所有付费功能都免费了

一条 Docker 命令，把 PDF 编辑、签名、密文、转换收进本地网页，文件不出内网。

Stirling-Tools/Stirling-PDF 项目名片

• Stars / 热度：93.1k Stars
   · 最近推送 2026-09-27
• 核心技术栈：
   Java · org.springframework.boot:spring-boot-starter-web、org.springframework.boot:spring-boot-starter-security、org.apache.pdfbox:pdfbox、org.bouncycastle:bcprov-jdk18on、org.springframework.security:spring-security-saml2-service-provider、com.google.crypto.tink:tink
• 适合人群：
   不想把合同传上云的开发者或家庭服务器用户
• 核心产出：
   本地/私有 PDF 编辑与自动化面板

合同要改，不再上传第三方网页

Stirling PDF - Dashboard； nal desktop app, in the browser, or deploy it on your own servers with a private API

合同要改签名或打码，以前第一反应是把文件拖进某个网页。现在本地打开 dashboard，就能完成编辑、签名、密文、转换，合同不离开自己的桌面。

Stirling-PDF 把 PDF 工具搬进 localhost，文件不出内网。面对敏感文件时，最大的变化不是功能更多，而是默认不用外发。

和手工、闭源工具比，它到底少传了什么

它的能力不是只做单一转换，而是把常用 PDF 操作压到同一个本地界面里。

• 编辑与签名：
   本地完成修改、签名、密文，不用先把合同传到外部。
• 转换与自动化：
   合并、OCR、格式转换等操作可在一个 dashboard 内串起来。
• 部署形态：
   桌面、浏览器或自托管服务器均可，README 明确不把文档发送到外部服务。

开源版仍有 Upgrade to Pro 提示，社区可通过反向代理注入脚本移除。

一条命令跑起来，但这两个坑先绕开

Stirling PDF logo； Stirling PDF - The Open-Source PDF Platform Stirling PDF is a powerful, open-source PDF editing platform

一条命令跑起来，但这两个坑先绕开

先把错误路径和正确路径拆开看。

bash
# ❌ 只等 Windows 安装程序 # 卡在 90%：Initializing Stirling-PDF / Finalising startup... # 终止后重跑 exe，仍可能卡在同样位置  # ✅ 卡住时直接到安装目录启动 ./Stirling-PDF.exe # 用浏览器访问 http://localhost # 同时收集 info.log，便于后续排查

bash
# ❌ 默认 Docker 启动后，Windows 桌面端用同一地址直接登录 docker run -p 8080:8080 docker.stirlingpdf.com/stirlingtools/stirling-pdf # 桌面端可能报 Self-hosted login failed  # ✅ 先关登录，或确保桌面端与浏览器 URL、OAuth2/SAML2 完全一致 docker run -p 8080:8080 -e SECURITY_ENABLELOGIN=false docker.stirlingpdf.com/stirlingtools/stirling-pdf # 重启容器后，再用完全一致的地址访问

避坑编号：

1. Windows 安装卡在 90% 不一定要等：直接去安装目录启动 Stirling-PDF.exe，通过 localhost 访问；别忘记收集 info.log。
2. Docker 开启登录后，桌面端报 Self-hosted login failed：先设 SECURITY_ENABLELOGIN=false 重启容器；若仍需登录，浏览器与桌面端必须用完全一致的 URL，并核对 OAuth2/SAML2。

哪些参数能调，哪些功能还没合入

可调参数

• 认证配置：SECURITY_ENABLELOGIN
   控制登录开关；启用后要核对 OAuth2/SAML2，否则桌面端容易登录失败。
• 模板与挂载：customHTMLFiles=true
   时，自定义文件放 /customFiles/templates；Docker 挂载 /customFiles 可覆盖默认模板。
• 运行形态：
   Docker、Windows 桌面端、浏览器、私有 API 都能跑，但默认最小命令只展示 Docker 一条路径。

能力边界

• 表单编辑：
   拖放、移动、缩放还没合入主分支，只在旧分支 add-elements，合并需要 rebase。
• 自动打印：
   监控文件夹后自动打印未落地，仅谈到可与文件夹扫描 alpha 集成。
• 通用打包：Flatpak
  /AppImage/Snap 无官方支持。
• 默认应用横幅：
   设置里还没有永久关闭入口。

社区生命力

• 潜力：Flatpak
   有明确需求，但维护者缺打包经验，适合有桌面打包经验的人接入。
• 响应：
   打印功能想与文件夹扫描 alpha 结合，但发现打印机方式仍在讨论。
• 态度：
   对默认应用横幅已道歉并承诺加永久选项；表单元素需求多但主线推进慢。

能改的不只是 PDF，还有这些缺口

轻量贡献

• 语言文案：
   按 devGuide/HowToAddNewLanguage.md 补语言包。
• 安装反馈：
   在 Windows 10 卡 90% 时，收集 info.log 并提供复现环境。
• 打包经验：
   提供 Flatpak 打包经验，或维护社区自动更新脚本。

进阶贡献

• 表单元素：
   帮 add-elements 分支 rebase，改进移动、缩放、小尺寸元素交互。
• 通用打包与打印：
   参与 Flatpak/AppImage/Snap 打包，或实现监控文件夹自动打印。

开放讨论

• 开源版持续显示 Upgrade to Pro，你更支持加永久关闭开关，还是保留入口但不打扰？
• 官方要不要提供 Flatpak/AppImage，让 Fedora Silverblue/Kinoite、SteamOS 等不可变系统也能稳定运行？

回复 本地PDF 获取本文涉及的参数与命令速查。

仓库地址

本文基于开源项目 Stirling-Tools/Stirling-PDF 整理。

• GitHub：
   https://github.com/Stirling-Tools/Stirling-PDF
• 主页：
   https://stirling.com

想对照源码自己玩一遍，回复 【STIRLINGPDF】 也可拿到同一份地址。