Skip to main content

Stirling-PDF

Stirling-PDF es una herramienta para PDFs que puedes alojar tú mismo, con capacidades que incluyen dividir, unir, rotar, extraer páginas, convertir imágenes, reorganizar, agregar o extraer imágenes, establecer contraseñas, definir permisos, añadir marcas de agua, convertir otros archivos a PDF, reconocimiento óptico de caracteres (OCR), editar metadatos y es compatible con el modo oscuro.

image.png

Enlaces

GitHub - https://github.com/Stirling-Tools/Stirling-PDF: locally hosted web application that allows you to perform various operations on PDF filesPDF/blob/main/README.md

Requisitos

Imagen

Repositorio de Docker Hub: frooodle/s-https://hub.docker.com/r/stirlingtools/stirling-pdf - Docker Image | Docker Hub

Directorio de datos

mkdir -pv $HOME/docker_volumes/s-pdf/{trainingData,extraConfigs,customFiles,logs}

Portainer- Nuevo «stack»

Add a new stack – Portainer Documentation

Web editor

En Portainer «Stack» agregamos nuevo usando el editor WEB pegando el contenido del fichero «docker-compose.yml» y el contenido del fichero de variables2.15-docker_add_stack_web_editor.gif

Fichero de variables «.env»

DOCKER_DATA_DIR=/home/"mi_usuario"/docker_volumes
DOMAIN="mi_dominio.com"
DOCKER_ENABLE_SECURITY=false
SYSTEM_DEFAULTLOCALE=es-ES
SYSTEM_GOOGLEVISIBILITY=false
DOCKER_ENABLE_SECURITY=trueUI_APPNAME=Herramientas SECURITY_ENABLELOGIN=truepdf
#DefaultUI_HOMEDESCRIPTION=Para username:"casi" admintodas andlas password: stirling 
UI_APPNAMENAVBAR=appnamenavbar-test
UI_APPNAME=DOCKERnecesidades PDF
UI_HOMEDESCRIPTION=------> AWESOME UI_APPNAMENAVBAR=PDF TOOL IN DOCKER <------
METRICS_ENABLED=false # API CAllS are not allowed e.g. http://<IP>:<PORT>/api/v1/uptime
ENDPOINTS_TOREMOVE=img-to-pdf, remove-pages

Fichero docker-compose.yml

services:
  stirling-pdf:
    image: docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest
    container_name: s-stirling-pdf
    restart: unless-stopped
    image: frooodle/s-pdf
    env_file:envfile: stack.env
    volumes:
      - $DOCKER_DATA_DIR/s-pdf/trainingData:/usr/share/tesseract-ocr/5/tessdata
      - $DOCKER_DATA_DIR/s-pdf/extraConfigs:/configs
      - $DOCKER_DATA_DIR/s-pdf/customFiles:/customFiles/
      - $DOCKER_DATA_DIR/s-pdf/logs:/logs/
    ports:
      - '8080:8080'  # Solo necesario si no usas proxy inverso
    volumes:
      - trainingdata:/usr/share/tessdata  # Datos para OCR (idiomas adicionales)
      - configs:/configs                  # Configuraciones extras
      - customfiles:/customFiles          # Archivos personalizados
      - logs:/logs                        # Logs de la aplicación
      - pipeline:/pipeline                # Pipeline de procesamiento
    networks:
      - proxy

volumes:
  trainingdata:
  configs:
  customfiles:
  logs:
  pipeline:

networks:
  proxy:
    external: true

En este punto ya puedes ir a http://my.docker.ip.address:8080

Publicando detrás de un proxy

Crear registro DNS

En el proveedor que aloja el servidor DNS público, crear un registro DNS que resuelva la IP pública que llega al Proxy hacia un nombre del estilo "cmk.domain.com"

NGINX proxy

image.png

Para publicar el contenedor detrás de NGINX proxy, deberás añadir al final del fichero "docker-compose.yml" lo siguiente:

networks:
  default:
    external: true
    name: proxy

Crear un nuevo "proxy host"

Añade un nuevo proxy host con el nombre de dominio creado en el paso anterior redirigido hacia el nombre del contenedor y el puerto que use (5000 en este caso):

image.png

Publicando con Traefik

traefik-concepts-1.webp

Para publicar el contenedor detrás del proxy Traefik, el contenido del fichero "docker-compose.yml" es el siguiente:

services:
  stirling-pdf:
    container_name: s-pdf
    restart: unless-stopped
    image: frooodle/s-pdf
    env_file: stack.env
    volumes:
      - $CONTAINERDIR/s-pdf/trainingData:/usr/share/tesseract-ocr/5/tessdata
      - $CONTAINERDIR/s-pdf/extraConfigs:/configs
      - $CONTAINERDIR/s-pdf/customFiles:/customFiles/
      - $CONTAINERDIR/s-pdf/logs:/logs/
    networks:
      - traefik_public
    labels:
      - traefik.enable=true
      - traefik.http.routers.pdf.tls=true
      - traefik.http.routers.pdf.tls.certresolver=letsencrypt
      - traefik.http.routers.pdf.rule=Host(`pdf.$DOMAIN`)
      - traefik.http.services.pdf.loadbalancer.server.port=8080
networks: 
  traefik_public:
    external: true

En este punto ya puedes ir a https://pdf.$DOMAIN

Para personalizar el logo de la aplicación coloca un fichero "$DOCKERDIR/s-pdf/customFiles/static/favicon.svg" para sobrescribir el actual SVG

Back to top