Files
bentopdf/docs/it/getting-started.md

3.4 KiB

Per iniziare

Benvenuto in BentoPDF! Questa guida ti aiuterà a metterti in funzione rapidamente.

Cos'è BentoPDF?

BentoPDF è un kit di strumenti PDF gratuito, open source e pensato per la privacy, che funziona interamente nel tuo browser. I tuoi file non lasciano mai il dispositivo: tutta l'elaborazione avviene in locale grazie alla tecnologia WebAssembly (WASM).

Avvio rapido

Opzione 1: usa la versione ospitata

Visita bentopdf.com per usare BentoPDF subito, senza installare nulla.

Opzione 2: self-hosting con Docker

Important

La conversione dei file Office richiede SharedArrayBuffer, che necessita di entrambi:

  • Cross-Origin-Opener-Policy: same-origin
  • Cross-Origin-Embedder-Policy: require-corp
  • un contesto sicuro

http://localhost funziona per i test in locale perché i browser considerano affidabile il loopback. http://192.168.x.x o altri IP di rete locale di solito no, quindi le conversioni di Word/Excel/PowerPoint richiederanno HTTPS quando si accede da altri dispositivi della tua rete.

# Pull and run the Docker image (self-hosted build)
docker run -d -p 3000:8080 ghcr.io/alam00000/bentopdf-simple:latest

# Or use Docker Compose
curl -O https://raw.githubusercontent.com/alam00000/bentopdf/main/docker-compose.yml
docker compose up -d

Tip

BentoPDF è disponibile in due build: la build self-hosted (bentopdf-simple, usata sopra) per installazioni interne, di team o di organizzazioni, e la build commerciale (bentopdf:latest) usata da bentopdf.com stesso e dai titolari di una licenza commerciale che gestiscono installazioni pubbliche. Entrambe includono gli stessi strumenti PDF: la build commerciale aggiunge hero, FAQ, testimonianze e footer di bentopdf.com. Se hai dubbi, usa la build self-hosted.

Poi apri http://localhost:3000 nel browser.

Note

Se stai preparando un'installazione OCR in ambiente air-gapped, devi ospitare internamente anche i font del livello di testo OCR, oltre al worker Tesseract, al runtime core e ai file traineddata. La configurazione completa è descritta in Self-hosting, inclusi VITE_OCR_FONT_BASE_URL e la cartella inclusa ocr-fonts/.

Opzione 3: compila dai sorgenti

# Clone the repository
git clone https://github.com/alam00000/bentopdf.git
cd bentopdf

# Install dependencies
npm install

# Start development server
npm run dev

Funzionalità in sintesi

Categoria Strumenti
Converti in PDF Word, Excel, PowerPoint, immagini, Markdown, EPUB, MOBI e altro
Converti da PDF JPG, PNG, testo, Excel, SVG e altro
Modifica e annota Firma, evidenzia, oscura, compila moduli, aggiungi timbri
Organizza Unisci, dividi, ruota, elimina pagine, riordina
Ottimizza Comprimi, ripara, appiattisci, OCR
Sicurezza Cifra, decifra, rimuovi restrizioni

Browser supportati

BentoPDF funziona al meglio sui browser moderni:

  • ✅ Chrome/Edge 90+
  • ✅ Firefox 90+
  • ✅ Safari 15+

Prossimi passi