← Back to desktop ← Return to Blog

Toolkit PDF self-hosted: il caso pdf.cornelcaba.com

Ogni azienda lavora con i PDF: contratti, fatture, documenti firmati, scansioni da archiviare. Il problema è che la maggior parte degli strumenti per gestirli vive online, su servizi di terze parti dove i tuoi file vengono caricati su server che non controlli. Per questo ho costruito pdf.cornelcaba.com, un toolkit PDF self-hosted che unisce, divide, comprime, converte e applica l’OCR ai documenti senza che un solo byte lasci l’infrastruttura. È un esempio concreto di come progetto e gestisco soluzioni self-hosted per aziende che tengono alla riservatezza dei propri dati.

Che cos’è pdf.cornelcaba.com

pdf.cornelcaba.com è un’applicazione web completa per la manipolazione dei documenti PDF, accessibile da qualsiasi browser e ospitata interamente su server che gestisco io. L’utente apre la pagina, trascina i file, sceglie l’operazione e scarica il risultato: nessuna installazione, nessun account su piattaforme esterne, nessun limite artificiale legato a un piano a pagamento.

Le funzioni coprono praticamente tutto il ciclo di vita di un PDF: unione di più documenti in un unico file, divisione di un PDF in pagine o intervalli, compressione per ridurre il peso senza rovinare la leggibilità, conversione da e verso altri formati e riconoscimento ottico dei caratteri (OCR) per rendere ricercabili le scansioni. Tutto questo in un’interfaccia pulita e immediata.

Il problema che risolve

Quando carichi un contratto o una fattura su un sito gratuito per “comprimere il PDF”, stai consegnando un documento potenzialmente sensibile a un servizio di cui non conosci le policy di conservazione. Per molte attività questo è un rischio concreto: dati di clienti, importi, dati personali. La maggior parte degli strumenti commerciali, inoltre, mette dietro a un abbonamento le funzioni più utili come l’OCR o l’elaborazione batch.

La soluzione self-hosted ribalta la prospettiva. I file restano all’interno di un perimetro controllato, le operazioni avvengono su un server dedicato e non c’è alcun vincolo commerciale che limiti l’uso. Per un’azienda significa avere uno strumento sempre disponibile, privato e su misura, senza canoni mensili che crescono con il numero di utenti.

Lo stack tecnologico

pdf.cornelcaba.com è costruito con un frontend moderno in React, che garantisce un’interfaccia reattiva e fluida: i file si caricano con il drag and drop, lo stato dell’elaborazione è sempre visibile e l’esperienza è la stessa su desktop e mobile. Dietro l’interfaccia lavorano i motori di elaborazione documentale che gestiscono il parsing dei PDF, la ricostruzione delle pagine, la compressione e il livello OCR per il testo nelle immagini.

L’intera applicazione gira in container Docker, orchestrati tramite Portainer, su un server Linux che amministro direttamente. Davanti all’applicazione c’è un reverse proxy Nginx che gestisce il traffico e termina il TLS, con certificati SSL sempre validi e rinnovati automaticamente. Questo significa che ogni connessione è cifrata end-to-end e che il servizio è isolato, aggiornabile e replicabile in pochi minuti su qualsiasi altro host.

In sintesi, lo stack che uso è:

  • Frontend: React, interfaccia single-page con caricamento drag and drop;
  • Elaborazione: motori dedicati per merge, split, compressione, conversione e OCR;
  • Containerizzazione: Docker con gestione tramite Portainer;
  • Infrastruttura: server Linux self-hosted con reverse proxy Nginx;
  • Sicurezza: certificati SSL e traffico cifrato HTTPS.

Perché scegliere una soluzione self-hosted

Il self-hosting non è una scelta ideologica, è una scelta di controllo. Quando ospito un’applicazione sulla mia infrastruttura decido io dove vivono i dati, chi può accedervi, quando aggiornare e come fare il backup. Per le aziende con cui lavoro questo si traduce in tre vantaggi concreti: riservatezza dei documenti, assenza di costi ricorrenti per licenze esterne e piena libertà di personalizzazione.

pdf.cornelcaba.com nasce come strumento personale, ma è esattamente il tipo di prodotto che posso adattare e installare per un cliente: con il suo dominio, le sue regole di accesso, eventualmente integrato nei flussi documentali già esistenti. È la dimostrazione pratica che una soluzione self-hosted per aziende può essere tanto comoda quanto un servizio cloud commerciale, ma senza rinunciare al controllo.

Cosa dimostra questo progetto

Costruire e far funzionare un’applicazione come questa richiede di coprire l’intera catena: dal design dell’interfaccia React alla logica di elaborazione dei documenti, dalla containerizzazione con Docker alla configurazione del server, del proxy e dei certificati. È esattamente il lavoro che faccio quando un’azienda mi chiede di sviluppare un’app o un sito: non mi limito a scrivere il codice, lo porto in produzione e lo mantengo operativo nel tempo.

Quando sviluppo un prodotto end-to-end significa che chi mi affida un progetto ha un unico interlocutore per tutto: sviluppo, hosting, sicurezza e manutenzione. Niente passaggi di consegne tra fornitori diversi, niente parti scoperte. Il risultato è un’applicazione che funziona davvero, ogni giorno, e che posso evolvere insieme alle esigenze del cliente.

Hai bisogno di un’app o di un sito su misura?

Se la tua azienda ha bisogno di uno strumento web su misura, di un’applicazione self-hosted per gestire i propri dati in modo riservato o di un sito costruito e mantenuto da un unico professionista, posso aiutarti. Sviluppo e gestisco prodotti reali dall’idea alla messa in produzione, esattamente come ho fatto con pdf.cornelcaba.com.

Scopri gli altri progetti e contattami dal mio sito: cornelcaba.com. Raccontami cosa ti serve e troviamo insieme la soluzione giusta per la tua attività.

Cornel Caba — signature