# 安装pdf转换服务gotenberg {#安装pdf转换服务gotenberg}

本文讲解pdf转换服务gotenberg的安装方法。gotenberg可以实现将html、Markdown、office文档转换为pdf文件，功能强大，该服务不仅提供了现成的api转换接口，还提供了各种开发语言的客户端sdk。

# 1. 安装gotenberg {#_1-安装gotenberg}

vi Dockerfile:

FROM thecodingmachine/gotenberg:6 
MAINTAINER Wang Shibiao

vi docker-compose.yml:

version: "3"

services:
  gotenberg_office_convert:
    build: .
    container_name: gotenberg_office_convert
    restart: always
    ports:
      - "3001:3000"
    tty: true

# 2. 调用转换接口 {#_2-调用转换接口}

curl --request POST --url https://pdfconvert.sofineday.com/convert/office --header 'Content-Type: multipart/form-data' --form files=@./test.pptx --form waitTimeout=30 -o ./result.pdf

可能因为文件过大导致接口调用超时，这时需要手动指定超时参数, 如waitTimeout=30
可能因为文件过大，导致nginx报错，修改方法详见nginx配置上传文件大小限制。

# 3. 调用sdk {#_3-调用sdk}

gotenberg还提供了主流开发语言的客户端sdk，详见官网Gotenberg (opens new window)