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