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 - Stirling-Tools/Stirling-PDF: locally hosted web application that allows you to perform various operations on PDF files

Requisitos

Imagen

Repositorio de Docker Hub: frooodle/s-pdf - Docker Image | Docker Hub

docker pull frooodle/s-pdf

Directorio de datos

mkdir -pv /var/data/$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»

DOMAIN=domain.com
CONTAINERDIR=DOCKER_DATA_DIR=/home/user"mi_usuario"/docker_volumes
DOMAIN="mi_dominio.com"
DOCKER_ENABLE_SECURITY=false
SYSTEM_DEFAULTLOCALE=es-ES
SYSTEM_GOOGLEVISIBILITY=false
DOCKER_ENABLE_SECURITY=true
SECURITY_ENABLELOGIN=true #Default username: admin and password: stirling 
UI_APPNAMENAVBAR=appnamenavbar-test
UI_APPNAME=DOCKER PDF
UI_HOMEDESCRIPTION=------> AWESOME 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:
    container_name: s-pdf
    restart: unless-stopped
    image: frooodle/s-pdf
    env_file: stack.env
    volumes:
      - $CONTAINERDIR/DOCKER_DATA_DIR/s-pdf/trainingData:/usr/share/tesseract-ocr/5/tessdata
      - $CONTAINERDIR/DOCKER_DATA_DIR/s-pdf/extraConfigs:/configs
      - $CONTAINERDIR/DOCKER_DATA_DIR/s-pdf/customFiles:/customFiles/
      - $CONTAINERDIR/DOCKER_DATA_DIR/s-pdf/logs:/logs/
    ports:
      - '8080:8080'

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 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 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