Gotenberg
基于 Docker 的文档转 PDF API，一行命令启动，支持 HTML、Office、Markdown 等多种格式。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
Docker 一键启动的文档转 PDF 神器，无需折腾环境。
核心功能
- 支持 HTML、URL、Markdown 转 PDF（基于 Chromium）
- 支持 Office 文档（Word/Excel/PPT 等 100+ 格式）转 PDF（基于 LibreOffice）
- PDF 编辑：合并、拆分、旋转、扁平化
- PDF 安全：水印、印章、加密
- PDF 合规：PDF/A、PDF/UA
避坑指南
- •如果转换大文件（如几百页 Office 文档），需确保 Docker 容器有足够内存（建议至少 2GB），否则可能 OOM。
- •默认监听 0.0.0.0:3000，建议在生产环境配置防火墙或反向代理。
- •LibreOffice 对中文排版复杂文档（如特殊字体、文本框）的还原度可能不如原生 Office，需要测试。
- •注意及时升级版本，旧版可能存在安全漏洞。
适用场景
- 自动化生成发票、报告、合同 PDF
- 在线文档预览系统（Office 转 PDF 以便浏览器查看）
- Web 页面快照与存档
- 批量处理 PDF 合并与拆分
- 需要 PDF/A 归档合规的场景
Gotenberg 是一个基于 Docker 的 API 服务，用于将各类文档转换为 PDF。你只需通过 HTTP 发送文件（HTML、URL、Markdown 或 Office 文档），就能收到 PDF 结果。底层使用 Headless Chromium 渲染网页和 Markdown，LibreOffice 处理超过 100 种办公文档格式（Word、Excel、PPT 等）。除了转换，它还支持 PDF 合并、拆分、旋转、加水印、加印章、加密、以及 PDF/A 和 PDF/UA 合规。甚至可以对网页截图。你无需手动安装或管理 Chromium、LibreOffice 或字体——只需运行 Docker 容器即可调用 API。目前已被数千家公司用于生产环境，众多知名开源项目也在使用。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：确保已安装 Docker，运行命令：docker run --rm -p 3000:3000 gotenberg/gotenberg:8
步骤2：将 URL 转 PDF：curl --request POST http://localhost:3000/forms/chromium/convert/url --form url=https://你的网页.com -o output.pdf
步骤3：将本地 HTML 文件转 PDF：curl --request POST http://localhost:3000/forms/chromium/convert/html --form files=@yourfile.html -o output.pdf
- 步骤1：确保已安装 Docker，运行命令：docker run --rm -p 3000:3000 gotenberg/gotenberg:8
- 步骤2：将 URL 转 PDF：curl --request POST http://localhost:3000/forms/chromium/convert/url --form url=https://你的网页.com -o output.pdf
- 步骤3：将本地 HTML 文件转 PDF：curl --request POST http://localhost:3000/forms/chromium/convert/html --form files=@yourfile.html -o output.pdf
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
删除 Docker 容器即可：docker rm $(docker ps -a | grep gotenberg | awk '{print $1}')，若不再需要镜像可执行 docker rmi gotenberg/gotenberg:8
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
5 FAQs