thecodingmachine/gotenberg

Gotenberg Docker镜像文档

镜像概述和主要用途

Gotenberg是一个开发者友好的API服务，基于Docker构建，通过Chromium和LibreOffice等强大工具，提供无状态的文档转换能力，支持将HTML、Markdown、Word、Excel等多种格式文件转换为PDF，同时提供简洁的接口供开发者集成。

核心功能和特性

• 多格式支持：兼容HTML、Markdown、Word、Excel等多种文档格式转换为PDF
• 工具集成：内置Chromium（用于网页渲染）和LibreOffice（用于办公文档处理）
• 无状态架构：服务设计为无状态，支持水平扩展和微服务集成
• 多平台适配：提供标准版、Cloud Run优化版、AWS Lambda优化版等多种镜像标签
• 语义化版本：遵循SemVer版本控制规范，版本格式为MAJOR.MINOR.PATCH

快速参考

• 源代码：
  https://github.com/gotenberg/gotenberg
• 发布说明：
  https://github.com/gotenberg/gotenberg/releases
• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  amd64、arm64v8、arm32v7、i386、ppc64le
• 获取帮助：
  https://github.com/gotenberg/gotenberg/discussions/categories/q-a
• 提交问题：
  https://github.com/gotenberg/gotenberg/issues

镜像标签说明

• 标准版本：latest、8
  遵循语义化版本控制，如需特定版本可查看https://hub.docker.com/repository/docker/gotenberg/gotenberg/tags
• Cloud Run优化版：latest-cloudrun、8-cloudrun
  针对Google Cloud Run环境优化，版本规则同上
• AWS Lambda优化版：latest-aws-lambda、8-aws-lambda
  针对AWS Lambda环境优化，版本规则同上
• 开发版本：edge、edge-cloudrun
  对应main分支的最新开发构建，包含未发布功能
• 快照版本：
  https://hub.docker.com/r/gotenberg/snapshot

使用场景和适用范围

适用于需要文档转PDF能力的各类开发场景，如：

• 生成业务报告、电子发票、合同文档
• 网页内容静态化导出为PDF
• 办公文档批量转换归档
• 电子书或教程材料格式统一

作为无状态服务，适合集成到微服务架构，支持高并发场景下的水平扩展。

快速开始

Docker运行命令

打开终端执行以下命令启动服务：

bash
docker run --rm -p 3000:3000 docker.xuanyuan.run/gotenberg/gotenberg:8

历史仓库地址（可选）

如需使用赞助商TheCodingMachine提供的历史仓库：

bash
docker run --rm -p 3000:3000 docker.xuanyuan.run/thecodingmachine/gotenberg:8

服务访问

服务启动后，API接口将在本地可用，访问地址：http://localhost:3000

扩展学习

查看https://gotenberg.dev/docs/getting-started/introduction了解API详细使用方法和参数配置 🚀