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