Desarrollo

Gotenberg

API HTTP de generación de PDF autoalojada: convierta HTML, URLs, Markdown y documentos LibreOffice a PDF con una sola llamada REST.

Documentación oficial

Acerca de Gotenberg

Gotenberg (licencia MIT, 8 k+ estrellas en GitHub) es un microservicio HTTP en contenedor para generar PDF a partir de HTML, URLs, Markdown y documentos Office (DOCX, XLSX, PPTX) mediante una API REST depurada. Despliéguelo en un VPS y sustituya los servicios PDF SaaS facturados por página por un coste mensual fijo. Chromium y LibreOffice están integrados en el contenedor único — sin dependencias adicionales. Úselo para generar facturas, informes, contratos o cualquier documento desde sus aplicaciones backend.

Lo que se instala

Listo al arrancar el VPS

SO compatibles
Ubuntu 24.04
Aplicación
Gotenberg
RAM mínima
500 MB mínimo (renderizado Chromium), 1 GB recomendado
CPU mínima
1 vCPU
Acceso
root por SSH

Funcionalidades clave

  • HTML→PDF mediante Chromium: compatibilidad completa con CSS, JavaScript y fuentes web.
  • URL→PDF: capture cualquier página web desde el servidor — útil para informes y archivado.
  • Conversión LibreOffice: DOCX, XLSX, PPTX, ODP y más de 20 formatos a PDF sin Microsoft Office.
  • Fusión de PDF: combine varios archivos PDF en un solo documento con una sola llamada.
  • Microservicio sin estado: sin base de datos ni capa de autenticación — añada su reverse proxy por delante.
  • Licencia MIT — sin facturación por página ni por documento.

¿Cuándo usar esta solución?

Generación de facturas y contratos

Convierta sus plantillas HTML de facturas en PDF desde el servidor y envíelas como archivos adjuntos o almacénelas en S3. Sin facturación por documento, sin acceso de terceros a sus datos financieros.

Exportación de informes en los productos SaaS

Añada un botón «Descargar en PDF» a su panel de control. Su backend envía el informe HTML a Gotenberg y transmite el PDF directamente al usuario — sin biblioteca frontend ni extensión de navegador.

Pipeline de conversión de formatos documentales

Convierta a PDF los archivos DOCX o XLSX subidos para el archivado, la vista previa o los flujos de firma electrónica. La ruta LibreOffice de Gotenberg gestiona la conversión sin instalar Office en su servidor.

Guía

Desplegar Gotenberg en su VPS

  1. Desplegar desde el Marketplace

    Abra el panel de control de ServOrbit, vaya a Marketplace → Desarrollo → Gotenberg y haga clic en Desplegar. Docker descarga la imagen gotenberg/gotenberg:8 — incluye Chromium y LibreOffice — y arranca el servidor HTTP en el puerto 3000. El servicio está listo en menos de 30 segundos.

  2. Enviar su primera petición de HTML a PDF

    Desde su aplicación o desde un terminal, envíe su HTML a la ruta Chromium: ` curl -s --request POST 'http://127.0.0.1:3000/forms/chromium/convert/html' \ --form '[email protected]' \ -o facture.pdf` Gotenberg renderiza la página con una instancia completa de Chromium y devuelve el PDF como flujo binario.

  3. Convertir una URL a PDF

    Para capturar una página web en directo: ` curl -s --request POST 'http://127.0.0.1:3000/forms/chromium/convert/url' \ --form 'url=https://votre-page-rapport.com' \ -o rapport.pdf` Útil para archivar vistas de panel de control, generar informes semanales o capturar recibos.

  4. Añadir una autenticación

    Gotenberg no tiene autenticación integrada. Proteja la API colocándola detrás de un reverse proxy (nginx) con autenticación HTTP basic o restringiendo el acceso únicamente a una red interna. El esquema estándar consiste en mantener el puerto 3000 vinculado a 127.0.0.1 y llamarlo desde el backend de su aplicación en el mismo servidor.

Preguntas frecuentes

Preguntas sobre Gotenberg

← Volver a DesarrolloTodas las aplicaciones
Sí. Gotenberg no mantiene estado y es escalable horizontalmente. Un solo contenedor gestiona decenas de peticiones concurrentes; añada más contenedores detrás de un balanceador de carga para las cargas de trabajo de alto rendimiento.

Integrar el botón de despliegue

¿Mantiene un proyecto que utiliza Gotenberg? Este botón permite a sus lectores desplegarlo en un VPS con un clic, sin leer documentación de Docker.

Deploy Gotenberg on ServOrbit
Markdown
[![Deploy Gotenberg on ServOrbit](https://servorbit.com/brand/deploy/button.svg)](https://servorbit.com/vps-cloud?template=gotenberg&utm_source=deploy-badge&utm_medium=referral&utm_campaign=gotenberg)
HTML
<a href="https://servorbit.com/vps-cloud?template=gotenberg&utm_source=deploy-badge&utm_medium=referral&utm_campaign=gotenberg"><img src="https://servorbit.com/brand/deploy/button.svg" alt="Deploy Gotenberg on ServOrbit" height="40"></a>

El botón lleva al pedido de un VPS con la plantilla preseleccionada. La imagen se sirve desde servorbit.com: no tiene que alojar nada por su parte.

Soluciones complementarias

Colaboración y productividad

Penpot

La plataforma de diseño de código abierto autoalojable — alternativa a Figma para los equipos de producto, con colaboración en tiempo real, prototipado interactivo y exportación de CSS en vivo.

Colaboración y productividad

Stirling PDF

Suite PDF completa autoalojada, la aplicación PDF n.º 1 en GitHub: convertir, fusionar, dividir, comprimir, OCR, poner marcas de agua y más de 50 operaciones — ningún dato enviado a la nube.

¿Necesita ayuda?

Consulte nuestro centro de ayuda y nuestra FAQ, o contacte con nuestro equipo: llamada, WhatsApp o correo electrónico.

Escribir por WhatsAppse abre en una pestaña nueva
o escribirnos