gotenberg

应用介绍

Gotenberg 是一款开发者友好的开源文档转换服务，专门用于将多种文档格式转换为 PDF 文件。它基于 Docker 运行，无需你手动安装和配置 Chromium、LibreOffice 等依赖，所有转换工具都已经预打包在容器中，开箱即用。

无论你需要将 HTML、URL、Markdown 转换为 PDF，还是将 Word、Excel、PowerPoint 等 Office 文档转换为 PDF，Gotenberg 都能轻松处理。它还支持 PDF 的合并、拆分、旋转、添加水印、加密等操作，满足各类文档处理需求。对于开发者来说，通过简单的 HTTP API 即可调用所有功能，非常方便集成到自己的应用或工作流中。

安装说明

前提依赖

只需要你的 NAS 支持 Docker 和 Docker Compose 即可运行。由于需要启动 Chromium 和 LibreOffice 进行转换，建议至少分配 2 CPU 核心和 2GB 内存以保证转换流畅。

安装配置

下面是一份基础的 docker-compose.yml 配置：

version: "3"
services:
  gotenberg:
    image: gotenberg/gotenberg:latest
    container_name: gotenberg
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - GOTENBERG_DEFAULT_CHROMIUM_MAX_QUEUE_SIZE=10

保存配置后执行 docker-compose up -d 即可启动服务。默认情况下，Gotenberg 会监听 3000 端口，等待你的转换请求。

使用说明

启动服务后，你可以通过 HTTP API 发起转换请求。例如，将一个网页转换为 PDF，可以使用以下 curl 命令：

curl \
 --request POST http://your-nas-ip:3000/forms/chromium/convert/url \
 --form url=https://example.com \
 -o example.pdf

对于 Office 文档转换，只需要上传你的文档文件，Gotenberg 会自动调用 LibreOffice 进行转换并返回 PDF 文件。所有操作都通过 API 完成，非常适合在自动化工作流中使用。

你也可以配合各类开源工具，例如在 NAS 上搭建自己的文档转换服务，供家庭或团队使用。Gotenberg 已经被很多知名开源项目采用，稳定性和功能都经过了生产环境的考验。

开源信息

项目 GitHub 地址：https://github.com/gotenberg/gotenberg
官方网站：https://gotenberg.dev
项目文档：https://gotenberg.dev/docs
开源协议：MIT License
Star 数量：超过 12.2k