Stirling PDF | PDF Tools | Docker

Stirling PDF: Herramienta completa de manipulación de PDF autohospedada en Docker

60+ herramientas PDF: merging, splitting, conversión, OCR, firmas, redacción. Sin enviar documentos a la nube. Privacidad garantizada, interfaz moderna, 38+ idiomas.

¿Qué es Stirling PDF?

Stirling PDF es una plataforma open source de manipulación de PDF autohospedada diseñada para dar control total sobre documentos sensibles. A diferencia de servicios online que suben tus PDFs a servidores remotos (Smallpdf, iLovePDF, etc), Stirling PDF procesa todo localmente en tu servidor. Más de 60 herramientas integradas en una única interfaz moderna y fácil de usar.

Funciones completas: Merge/Split, Convert (PDF a Word, Excel, imágenes, HTML), Edit (añadir texto, imágenes, anotaciones), Secure (contraseñas, watermarks, encriptación), OCR, Compress, Sign, Redact, y mucho más. Interfaz disponible en 38+ idiomas. API REST completa para integración. Sin almacenamiento de archivos: se procesan en memoria o se borran automáticamente.

Privacidad local: Documentos confidenciales, contrato legales, datos financieros: todo se procesa en tu servidor. Ningún tercero toca tus archivos. La única opción verdaderamente privada para manipulación de PDFs.

Características principales

Merge & Split

Combina múltiples PDFs o divide uno en varias partes.

Conversión completa

PDF a Word, Excel, PowerPoint, imágenes, HTML, Markdown.

Edición de PDF

Añade texto, imágenes, anotaciones, dibuja directamente.

Seguridad PDF

Añade contraseñas, watermarks, encriptación, permisos.

OCR

Extrae texto de PDFs escaneados, reutilizable.

Compresión

Reduce tamaño de archivo sin perder calidad.

Firmas digitales

Firma PDFs digitalmente o añade campos de firma.

Redacción

Oculta texto o imágenes sensibles permanentemente.

Organización de páginas

Rota, reorganiza, elimina, duplica páginas.

Extracción de contenido

Extrae imágenes, extrae tablas como CSV.

API REST

Integra con tus aplicaciones vía API JSON.

Multi-idioma

Interfaz en 38+ idiomas, soporte comunitario.

Más de 60 herramientas disponibles

Conversión

PDF a Word, Excel, PowerPoint, imágenes (PNG, JPG, WebP), HTML, Markdown, Markdown-table, CSV, JSON, XML

Manipulación

Merge, Split, Rotate, Reorder, Scale, Crop, Add borders, Auto-crop, Extract pages, Convert to PDF (from images, Office, HTML)

Seguridad

Add password, Remove password, Encrypt, Decrypt, Change permissions, Add watermark, Add signature, Add certificate

Edición

Add text, Add images, Add drawings/annotations, Flatten forms, Repair PDF, Remove blank pages, Compare PDFs

OCR & Optimización

OCR scanning, Compress, Remove duplication, Extract images, Metadata editing, Change color space, PDF to PDF/A

Especializadas

Handwriting recognition, Generate barcodes, Custom stamp, Flatten layers, HTML to PDF, URL to PDF, y más

Requisitos del sistema

Docker instalado
2-4 GB de RAM mínimo (más para procesamiento concurrente)
10+ GB de espacio en disco para caché y procesamiento
Puerto 8080 disponible (configurable)
CPU multi-core recomendado para mejor rendimiento
Opcional: GPU para aceleración de OCR

Nota: La imagen Docker es bastante grande (~3-4 GB) porque incluye todas las dependencias: LibreOffice, Ghostscript, Tesseract OCR, FFmpeg, y más.

Instalación con Docker

Opción 1: Docker Run (30 segundos)

docker run -p 8080:8080 \ docker.stirlingpdf.com/stirlingtools/stirling-pdf

Opción 2: Docker Compose (recomendado)

version: '3.8' services: stirling-pdf: image: docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest container_name: stirling-pdf restart: unless-stopped ports: - "8080:8080" volumes: - ./uploads:/uploads - ./logs:/logs environment: - DOCKER_ENABLE_SECURITY=true - ALLOW_GOOGLE_DRIVE_INTEGRATION=false - MAX_FILE_SIZE=1000 # En MB - ENABLE_AUTOUPDATE=true

Iniciar

docker compose up -d

Acceder

Abre http://localhost:8080 en tu navegador. Verás la interfaz de Stirling PDF lista para usar.

Nota: Stirling PDF no requiere login ni configuración inicial. Está listo para usar inmediatamente.

Primeros pasos

1. Explorar la interfaz

Abre http://localhost:8080
Verás menú izquierdo con categorías de herramientas
Cada categoría agrupa herramientas relacionadas
Click en cualquier herramienta para usarla

2. Merge (unir dos PDFs)

Click en "Merge PDFs"
Arrastra dos PDFs o click para cargar
Reordena si necesitas (drag and drop)
Click "Merge" y descarga resultado

3. Split (dividir PDF)

Click en "Split PDF"
Carga un PDF multi-página
Elige "Split by pages" o "Split every X pages"
Download individual PDFs

4. Convertir PDF a Word

Selecciona "PDF to Word"
Carga PDF
Click Convert
Descarga archivo .docx editable

5. OCR (extraer texto de scan)

Click en "OCR PDF"
Carga PDF escaneado
Tesseract extrae automáticamente el texto
Descarga PDF con texto buscable

Configuración avanzada

Variables de entorno importantes

DOCKER_ENABLE_SECURITY=true # Habilita validación de seguridad MAX_FILE_SIZE=1000 # Tamaño máximo en MB ENABLE_AUTOUPDATE=true # Auto-actualizar imagen CUSTOM_USERS_FILENAME=users.yaml # Archivo de usuarios personalizados UI_DEFAULT_LANG=es # Idioma por defecto (es, en, de, fr, etc)

Procesamiento por lotes (Batch)

Stirling PDF puede procesar múltiples archivos automáticamente usando su API REST:

# Endpoint para API batch POST /api/v1/process-multiple Content-Type: application/json { "files": ["file1.pdf", "file2.pdf"], "operation": "merge" }

Autenticación y permisos

Para multi-usuario con permisos, edita users.yaml:

users: - username: admin password: tu-contraseña-hash role: admin - username: usuario1 role: user

HTTPS con Caddy (acceso remoto)

Configuración Caddyfile

stirling-pdf.tudominio.com { reverse_proxy localhost:8080 }

Acceso remoto seguro

Configura Caddy con tu dominio
HTTPS automático con Let's Encrypt
Accede: https://stirling-pdf.tudominio.com
Manipula PDFs desde cualquier lugar con seguridad

Seguridad importante: Los archivos se borran automáticamente después del procesamiento. No se almacenan en el servidor.

Casos de uso

Documentos legales confidenciales: Procesa sin enviar a servicios online
Trabajo en equipo: Multi-usuario con permisos y auditoría
Automatización: API REST para scripts y pipelines
Producción en masa: Procesamiento batch de miles de PDFs
Compliance normativo: GDPR, HIPAA, FERPA: datos locales
OCR a escala: Digitaliza archivos escaneados masivamente
Firmas digitales: Firma contratos sin plataformas terceras
Conversión de documentos: PDF a Word, Excel, imágenes

Gestión y mantenimiento

Ver logs

docker compose logs -f stirling-pdf

Limpiar archivos temporales

docker exec stirling-pdf rm -rf /tmp/stirling-pdf-*

Renovar contenedor (liberar espacio)

docker compose down docker rmi docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest docker compose up -d

Actualizar a la última versión

docker compose pull docker compose up -d

Reiniciar servicio

docker compose restart stirling-pdf

Ver estado

docker compose ps

Verificar uso de disco

docker exec stirling-pdf du -sh /tmp

Referencias oficiales

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Cómo instalar Stirling PDF en Docker - Herramienta de manipulación de PDF autohospedada en Docker