Stirling PDF 工具箱

由 Stirling-Tools 制作工具包效率

新上架第 2 版 · 更新于 2026-11-09

星标95.9k

Stirling PDF 采用 open-core（开放核心）模式，是一款 PDF 编辑与处理工具，可装在桌面、在浏览器里用，也能放到你自己的服务器上。安装说明涵盖桌面应用、Docker、Java、Kubernetes、Stirling Cloud、REST API、文件夹扫描，以及给 AI 智能体用的 MCP 服务器。

Stirling PDF 工具箱是一款 GitHub 上的开源项目，属于效率类，由 Mindket 上架。可免费获取。当前为第 2 版，最近更新于 2026-11-09。按它的 README 从 GitHub 安装。Mindket 的设置说明可在你的 Mindket 账户获取，以 zip 压缩包下载。

速览

用在

Claude Code 通过 .mcp.json，VS Code 通过 .vscode/mcp.json
Codex CLI 通过 ~/.codex/config.toml
Claude Desktop 通过 mcp-remote 桥接，它需要 Node.js
你自己的脚本，通过 REST API 和 Pipeline API

先运行

docker run -p 8080:8080 docker.stirlingpdf.com/stirlingtools/stirling-pdf

平台

Windows操作系统

macOS操作系统

Linux操作系统

Docker容器

Claude Code编程智能体

VS Code代码编辑器

用在哪里里还有 3 个

关于

它是什么

Stirling PDF 是 Stirling PDF Inc. 做的 PDF 编辑与处理工具。它的 README 说，你可以把它当桌面应用用，也可以在浏览器里用，或者部署到自己的服务器上，配一个私有 API。这些工具能合并、拆分、压缩、转换、做 OCR、签名和涂黑（redact），还能把一串工具存下来，在任意文件上依次运行。README 承诺，编辑、签名、涂黑、转换和自动处理 PDF，都可以“不把文档发给外部服务”。

你安装桌面应用，或者启动 Docker 镜像
你打开应用，服务器则打开 http://localhost:8080
你选一个工具，添加 PDF，然后运行
仅本机模式和你自己的服务器让文件留在你手里
脚本和 AI 智能体通过 API 或 MCP 调用同样的工具

适合谁

经常编辑、合并、压缩、签名或涂黑 PDF，又想在自己机器上完成的人。想给整家公司架一个统一工具的 IT 团队适合它，在脚本或智能体里调用 PDF 工具的开发者也适合。公司要在生产环境里用它，先读它的许可证。

谁在用，怎么用

行业	谁在用	怎么用	例子
办公和行政	手上有一堆 PDF 的人	在桌面应用里合并、拆分、压缩、旋转和加页码	有人打开 Compress，让质量滑块保持默认的 5，再保存变小的文件。
法务和财务	处理敏感文件的团队	涂黑文字或匹配的格式，再把页面转成图片，让方框后面不留文字	一位律师助理在 Words to Redact 下添加一个姓名，打开 Convert PDF to PDF-Image，再点 Redact。
档案和扫描	手上有纸质扫描件的人	运行 OCR，让页面能搜索、能复制	有人打开 OCR / Cleanup scans，选好文档里出现的语言，再点 Process OCR and Review。
IT 和平台团队	为别人架设工具的管理员	在 Docker 或 Kubernetes 里运行服务器，开启登录和用户	一位管理员启动 Docker 镜像，用密码 stirling 以 admin 登录，按提示设一个新密码。
软件团队	把 PDF 接进软件的开发者	从脚本调用 REST 接口或流水线	一个脚本带着 X-API-KEY 头，把文件 post 到 /api/v1/misc/compress-pdf，再存成 compressed.pdf。
AI 智能体用户	用 Claude Code 或 Codex 的人	连上 MCP 服务器，让智能体去运行这些工具	有人把 stirling-pdf 条目加进 .mcp.json，再让智能体压缩一个文件。

用在哪里

Stirling PDF 能作为桌面应用运行在 Windows、macOS 和 Linux 上，也能作为服务器跑在 Docker、Java 或 Kubernetes 里，还有在浏览器里用的 Stirling Cloud。下面是把其他工具接上它的办法。

Claude Code 通过 .mcp.json，VS Code 通过 .vscode/mcp.json
Codex CLI 通过 ~/.codex/config.toml
Claude Desktop 通过 mcp-remote 桥接，它需要 Node.js
你自己的脚本，通过 REST API 和 Pipeline API
n8n、Zapier、Make 和 Power Automate，通过它们通用的 HTTP 请求动作
Telegram，通过自托管服务器上的机器人
服务器上的监视文件夹，对丢进去的每个文件运行一个保存好的工作流

它能在哪里运行

位置	安装方式	文档的要求
Windows 桌面版	winget、Scoop 或 MSI 安装包	Windows 10 或 11
macOS 桌面版	DMG，或者 Homebrew	macOS 10.15 或更高，Apple 芯片或 Intel
Linux 桌面版	.deb 或 .rpm 包、AppImage，或者 AUR	64 位 x86 系统
Docker 服务器	docker run 那一行，或者一个 compose 文件	Docker。文档对 latest 镜像建议 4 GB 内存
Java 服务器	GitHub 发布页上三个 JAR 文件之一	Java 25，外加你想用的工具所依赖的程序
Kubernetes	官方 Helm chart	设置内存上限。文档建议生产环境用 8 GB 或更多

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹，里面按制作者的 README 和文档，给每种运行方式各写了一页。最短的路线是桌面安装包，或者一条 Docker 命令。

先准备好这些

需要	说明
一台电脑	桌面版需要 Windows 10 或 11、macOS 10.15 或更高，或者 64 位 x86 的 Linux。服务器需要 Docker 或 Java 25
内存	Docker 方面，文档对 latest 建议 4 GB，latest-fat 建议 6 GB，latest-ultra-lite 建议 2 GB
账号	仅本机模式下的桌面版，或者你自己运行的服务器，都不需要。Stirling Cloud 可以用访客身份使用所有手动工具，AI 工具、自动化、API 密钥和 MCP 才需要 Stirling 账号
额外的程序	Docker 的 latest 镜像自带 LibreOffice、Tesseract、OCRmyPDF、WeasyPrint、Calibre、Ghostscript、QPDF 和 ImageMagick，但没有 rar，所以不能把 PDF 转成 CBR。用 JAR 的话，要自己装你想用的那些

选一条路线。自己用就装桌面应用，要架服务器就用 Docker。
装好桌面应用。用安装包、winget 或 Homebrew 装，然后打开 Stirling PDF。第一个界面选 Continue without signing in，就进入仅本机模式（Local Only）。
服务器就运行下面那一行。然后打开 http://localhost:8080。
以 admin 登录。密码是 stirling，按提示设一个新密码。

docker run -p 8080:8080 docker.stirlingpdf.com/stirlingtools/stirling-pdf

winget install StirlingTools.StirlingPDF

第一行是 README 的快速开始。它没有挂载任何卷，所以想长期保留数据，就用安装说明里更长的 Docker 命令。第二行在 Windows 上安装桌面应用。

如何使用

打开工具选择器，选一个工具，添加你的 PDF，然后运行。工具页把最常用的放在最上面：PDF Text Editor、Page Editor、Merge、Compare、Compress、Convert、OCR 和 Redact。桌面应用里，Ctrl+S 会覆盖你打开的那个文件，Save As 则另存一份。在服务器上，每个服务器端工具还有一个接口。少数只在浏览器里运行的工具（比如查看器和手绘签名）没有接口。REST API 页面这样压缩一个文件：

curl -X POST "$STIRLING_URL/api/v1/misc/compress-pdf" \
  -H "X-API-KEY: $STIRLING_API_KEY" \
  -F "fileInput=@document.pdf" \
  -F "optimizeLevel=5" \
  -o compressed.pdf

把 STIRLING_URL 设成你的服务器地址，把 STIRLING_API_KEY 设成你在 Settings、Preferences、API Keys 里拿到的密钥。

示例

你有一个 PDF，需要先修复再压缩，想用一个脚本把两步做完。Pipeline API 页面用一次请求发出这两个步骤。

curl -X POST "$STIRLING_URL/api/v1/pipeline/handleData" \
  -H "X-API-KEY: $STIRLING_API_KEY" \
  -F "fileInput=@input.pdf" \
  -F 'json={
    "name": "Repair then compress",
    "pipeline": [
      {"operation": "/api/v1/misc/repair", "parameters": {}},
      {"operation": "/api/v1/misc/compress-pdf", "parameters": {"optimizeLevel": 2}}
    ]
  }' \
  -o result.pdf

只有一个输出文件时，返回的就是文件本身，这里是 result.pdf。有多个文件的话，会以 output.zip 返回。

新手与专家

新手：先从桌面应用开始。第一个界面选 Continue without signing in，进入仅本机模式，然后打开一个 PDF，试试 Merge 或 Compress。带云标记的工具需要 Stirling Cloud 或一台服务器，运行它时会要求你登录或连接。

专家：settings.yml 里的每个键也都能当环境变量用，比如 SECURITY_ENABLELOGIN 或 SYSTEM_DEFAULTLOCALE。流水线的步骤要写完整的接口路径，在工具调用后加 ?async=true 会返回一个任务 ID，让你去轮询。服务器在 /swagger-ui/index.html 列出每个接口，OpenAPI 规范在 /v1/api-docs。

集群模式让几个 pod 跑在同一个服务后面。Kubernetes 页面说它需要 Team 或 Enterprise 许可证，外加你自己的 PostgreSQL、Valkey 和 S3。MCP 服务器支持 OAuth 2.1 或每个用户自己的 API 密钥，管理员还能列出它允许或屏蔽的工具。

注意事项

大部分功能在你自己的电脑或服务器上运行，只有少数几条路径会连到外面。

许可证：README 说 Stirling PDF 是 open-core（开放核心）。根目录的 LICENSE 是 MIT 许可证，“Copyright (c) 2025 Stirling PDF Inc.”，适用于它所列文件夹以外的内容。那些文件夹各有自己的 LICENSE 文件，我们读过的四个，写的都是 Stirling PDF User License，它只在持有有效用户许可证时才允许生产使用。GitHub 显示的是“Other”。公司要在生产环境运行之前，请把两份许可证都读一遍
账号：仅本机模式的桌面版，或者你自己运行的服务器，都不需要。Stirling Cloud 允许访客使用手动工具，但 API 密钥、MCP 和 AI 工具需要账号
离开你电脑的内容：仅本机模式下，每个工具都在你的电脑上运行，什么也不会上传。在 Stirling Cloud 模式下，内置引擎跑不了的工具会交给 Stirling Cloud。Cloud 文档说，它的 AI 功能用的是 Anthropic 的模型和 Voyage AI 的嵌入，看到的是节选内容，不是整份文件
使用数据：服务器可以把匿名使用数据发到 PostHog 的欧盟服务器，浏览器也可能加载 Scarf 像素。文档说文档内容从不发送。第一位管理员会在首次登录时被问到，SYSTEM_ENABLEANALYTICS=false 能把这一切关掉
首次登录：数据库为空时，会创建密码为 stirling 的 admin 账号。登录关闭时，能连到服务器的人都能使用它
删除：Redact 会永久删除文字，所以要保留一份原件。文件夹扫描在成功运行后会删除输入文件
套餐：服务器在加上 Team 或 Enterprise 之前运行在 Free 套餐上（5 个用户）。Processor 自动化、AI 工具和用 API 密钥发起的 PDF 工具调用会消耗每月的处理额度。有 Team 许可证密钥时，API 密钥调用不再计入，Enterprise 则全都不计。额度用完后，API 调用返回 402 和 ACCOUNT_LINK_REQUIRED
Telegram 机器人：文档称它是社区做的 beta，不在 Team 或 Enterprise 的支持范围内
安装命令：Docker 说明里的 Proxmox 一行命令会运行一个来自网上的脚本，先把它读一遍。在 Windows x64 上，桌面应用是为所有用户安装的，所以更新提示可能需要管理员权限
更新：桌面应用启动后不久会检查新版本，默认在安装前先询问。Docker 请固定一个版本标签，不要用 latest

README 和文件

README

Stirling PDF：安装说明

这个工具包里只有安装说明，由 Mindket 编写。Stirling PDF 本身、它的安装包、镜像和软件包，都来自制作者的仓库：https://github.com/Stirling-Tools/Stirling-PDF

这些说明不是它的制作者写的，也没有得到他们的认可。文档首页说：“Stirling is a private, open-source PDF editor and processor for you and your agents. Read, edit and automate PDFs in your browser, on your own computer or on your own servers.”，意思是：Stirling 是一款私密的开源 PDF 编辑与处理工具，为你和你的智能体而做，可以在浏览器里、你自己的电脑上或你自己的服务器上读取、编辑和自动处理 PDF。制作者的网站是 https://stirling.com ，文档在 https://docs.stirlingpdf.com

许可证：open-core（开放核心），按文件夹分开授权。公司要运行它，请先读这一部分。

根目录的 LICENSE 文件（https://github.com/Stirling-Tools/Stirling-PDF/blob/main/LICENSE ）是 MIT 许可证，“Copyright (c) 2025 Stirling PDF Inc.”。它说，所列文件夹以外的内容按 MIT 许可证提供。README 说“Stirling PDF is open-core.”。GitHub 的许可证栏写的是“Other”。
根目录的 LICENSE 列出了几个有自己 LICENSE 文件的文件夹，每一条后面都带着“if that directory exists”（如果该目录存在）：app/proprietary/、app/saas/、engine/、frontend/src/editor/proprietary/、frontend/src/editor/desktop/、frontend/src/editor/saas/、frontend/src/editor/cloud/ 和 frontend/src/processor/。
我们读了其中四个文件：app/proprietary/、engine/、frontend/src/editor/desktop/ 和 frontend/src/processor/。四个写的是同一段文字，即“Stirling PDF User License”。照它的话说，那部分软件只有持有有效的 Stirling PDF User License 才允许生产使用；不付费订阅时，只能用于“internal trial, evaluation, or minimal use”（内部试用、评估或少量使用），并且不能用在面向客户或商业的场合。
这些说明无法告诉你，一个镜像、一个 JAR 或一个安装包里的哪些部分来自哪个文件夹。文档的 Plans and licences 页面（https://docs.stirlingpdf.com/Server/Licensing/Plans-and-Licences/ ）说，自托管服务器在加上 Team 或 Enterprise 之前运行在 Free 套餐上，并列出了每个套餐包含什么。用于工作的话，请读这两份许可证和那个页面，或者直接问制作者。

会安装什么

桌面应用：适合你系统的安装包或软件包，外加一个内置引擎。来源见 https://docs.stirlingpdf.com/Desktop/Install/
Docker：一个来自 docker.stirlingpdf.com、Docker Hub 或 GitHub 的镜像，有三种变体（latest、latest-fat、latest-ultra-lite）。来源见 https://docs.stirlingpdf.com/Server/Install/Docker/
Java：GitHub 发布页上三个 JAR 文件之一，外加你自己装的转换工具。来源见 https://docs.stirlingpdf.com/Server/Install/JAR/
Kubernetes：官方 Helm chart。来源见 https://docs.stirlingpdf.com/Server/Install/Kubernetes/
你的数据：在服务器上，是 Docker 页面列出的那几个文件夹（/configs、/logs、/customFiles、/pipeline、/storage、/usr/share/tessdata）。桌面应用把数据放在 setup/desktop-app.md 列出的文件夹里。

事先需要准备

桌面版：Windows 10 或 11、macOS 10.15 或更高，或者 64 位 x86 的 Linux 系统。来源见 https://docs.stirlingpdf.com/Desktop/
用 Docker 的服务器：Docker。Docker 页面对 latest 镜像建议 4 GB 内存，latest-fat 建议 6 GB，latest-ultra-lite 建议 2 GB。
用 Java 的服务器：Java 25，外加你想用的工具所依赖的程序。来源见 https://docs.stirlingpdf.com/Server/Install/JAR/
账号：仅本机模式下的桌面版，或者你自己运行的服务器，都不需要。Stirling Cloud 可以用访客身份使用所有手动 PDF 工具，那里的 AI 工具、自动化、API 密钥和 MCP 需要 Stirling 账号。在你自己的服务器上，API 密钥和 MCP 用的是那台服务器上的账号；关闭登录时，API 不需要密钥。

主要安装命令

README 给出下面这一行来启动服务器。然后打开 http://localhost:8080。

docker run -p 8080:8080 docker.stirlingpdf.com/stirlingtools/stirling-pdf

Docker 页面里更长的命令会挂载卷，让你的设置和文件保留下来，见 setup/docker.md。在 Windows 上，桌面版的安装页给的是：

winget install StirlingTools.StirlingPDF

各种运行方式的说明

setup/desktop-app.md：Windows、macOS 和 Linux，连接模式，工具在哪里运行
setup/docker.md：镜像、卷、更新，以及 NAS、Proxmox 和 Podman 的路线
setup/java-jar.md：几个 JAR、Java 25、转换工具和一个 Linux 服务
setup/kubernetes.md：Helm chart、设置和集群
setup/stirling-cloud.md：托管版本、它的账号和它的隐私页面
setup/mcp-for-agents.md：给 Claude Code、Claude Desktop、Codex CLI 和 VS Code 用的 MCP 服务器
setup/rest-api-and-pipelines.md：API 密钥、curl 示例和 Pipeline API
setup/folder-scanning-and-telegram.md：监视文件夹和 Telegram 机器人
setup/login-production-and-privacy.md：首次登录、生产清单和数据分析

更新或卸载

桌面版：应用启动后会检查更新。它的 Updates 页面还给了 winget、Homebrew 和 AUR 的升级命令。
Docker：拉取新镜像，再启动一次。你的数据留在卷里。
Java：停掉服务器，替换 JAR，再从同一个文件夹启动。
Kubernetes：修改 image.tag，再运行 helm upgrade。
卸载：桌面应用的 Updates 页面有卸载步骤。服务器的几个页面没有给出卸载步骤。下面是 Mindket 的说明，不是制作者的：像 Docker 页面的更新步骤那样停掉并删除容器（docker stop，再 docker rm），想把数据也清掉的话，再删除你挂载的文件夹。

隐私

文档说 Stirling PDF 可以发送匿名使用数据，从不发送文档的内容。在服务器上，由管理员决定是否开启数据分析。数据会发到 PostHog 的欧盟服务器，浏览器也可能加载一个 Scarf 像素。关闭的开关见 setup/login-production-and-privacy.md。在桌面应用的 Stirling Cloud 模式和 Stirling Cloud 本身里，有些工具会把文件发到 Stirling 的服务器；仅本机模式下什么也不会上传：见 setup/desktop-app.md 和 setup/stirling-cloud.md。

来源

README https://github.com/Stirling-Tools/Stirling-PDF/blob/main/README.md
LICENSE https://github.com/Stirling-Tools/Stirling-PDF/blob/main/LICENSE
文档首页 https://docs.stirlingpdf.com/
桌面版 https://docs.stirlingpdf.com/Desktop/Install/
服务器 https://docs.stirlingpdf.com/Server/
Plans and licences https://docs.stirlingpdf.com/Server/Licensing/Plans-and-Licences/
Analytics and telemetry https://docs.stirlingpdf.com/Server/Analytics-and-Telemetry/

文件

README.md  6 KB
setup/desktop-app.md  7 KB
setup/docker.md  8 KB
setup/folder-scanning-and-telegram.md  6 KB
setup/java-jar.md  7 KB
setup/kubernetes.md  6 KB
setup/login-production-and-privacy.md  7 KB
setup/mcp-for-agents.md  6 KB
setup/rest-api-and-pipelines.md  6 KB
setup/stirling-cloud.md  3 KB

10 个文件，共 63 KB，以 zip 压缩包下载。