gotenberg.dev

是什么

Gotenberg 是一个基于 Docker 的 PDF 转换 API，核心定位是“一个容器解决 PDF 工作流”。开发者通过 multipart/form-data 向本地或自托管服务发送文件或 URL，即可获得 PDF，无需自行管理 Chromium、LibreOffice 或字体环境。正文显示其采用 MIT License，并提供 GitHub、文档和 Docker 快速启动方式。

核心能力

在 Web 转 PDF 方面，Gotenberg 使用 Headless Chromium，可转换 URL、HTML、Markdown，并支持 JavaScript 执行、Web 字体、SPA 动态渲染。它提供 waitDelay、waitForExpression、waitForSelector、网络 idle 等机制，适合前端页面、图表和异步数据渲染后的精确导出。网络控制也较细，包括 cookies、自定义 HTTP Header、User-Agent、状态码失败策略、资源加载失败控制和 outbound URL filtering。

Office 转换由 LibreOffice 承担，支持 docx、xlsx、pptx 及大量传统/标准格式，并可选择页面范围、生成 PDF/A。PDF 后处理能力也很完整，借助 QPDF、pdfcpu、ExifTool 等统一暴露合并、拆分、加密、旋转、压平表单、水印、盖章、元数据、书签、附件嵌入、PDF/A、PDF/UA 等能力。云原生方面支持从 S3、MinIO、GCS 预签名 URL 直接下载输入并上传结果，还可发送 Webhook 事件，减少业务服务传输压力。

定价与部署

正文仅看到 MIT License，未出现商业云版本、套餐价格或支付方式。部署方式非常明确：使用 docker run -p 3000:3000 gotenberg/gotenberg:8 启动容器即可调用 API，因此更偏开源自托管工具，而不是托管 SaaS。

优缺点与适合谁

优点是能力覆盖广、API 参数细、文档示例充分，特别适合 SaaS 报表、发票、合同、归档系统和批量文档转换场景。缺点是生产环境的扩缩容、字体、超时、安全过滤、LibreOffice/Chromium 资源消耗都需要团队自行运维；同时正文仅提到 PHP SDK，官方多语言 SDK 覆盖信息不足。适合有后端能力、希望掌控数据和部署环境的团队。

中国访问

正文未提供中国大陆访问、镜像源或云服务信息，判定为未知。由于可自托管，实际运行可部署在国内服务器；但拉取 Docker 镜像、访问 GitHub 或外部文档时可能受网络环境影响。替代方案可考虑 wkhtmltopdf、Puppeteer/Playwright、WeasyPrint、LibreOffice headless，或商业 API 如 PDFShift、DocRaptor。