Vai al contenuto

Funzionalità

File Manager

Il file manager si collega al tuo bucket compatibile con S3 per archiviare e servire i file e le immagini dei tuoi template email. Un endpoint CDN facoltativo serve quei file più velocemente.

Schermata del File Manager

Configurazione dello storage S3

Configura il tuo storage compatibile con S3 con queste impostazioni:

  • Endpoint S3: l’URL dell’endpoint del tuo storage compatibile con S3
  • Chiave di accesso S3: la chiave di accesso per l’autenticazione
  • Chiave segreta S3: la chiave segreta per l’autenticazione
  • Bucket S3: il nome del bucket in cui verranno archiviati i file
  • Regione S3: la regione dello storage (per esempio us-east-1)

Configurazione della CDN

Endpoint CDN

  • A cosa serve: URL della CDN che mette in cache i tuoi file
  • Vantaggio: consegna dei file più rapida e costi di banda ridotti
  • Facoltativo: non obbligatorio, ma consigliato

Personalizzazione degli URL

Quando è configurato un endpoint CDN, gli URL dei file nei tuoi template email usano l’URL della CDN invece dell’URL S3 diretto.

Configurazione CORS

Perché il file manager possa caricare i file direttamente dal tuo browser, configura il CORS (Cross-Origin Resource Sharing) sul tuo bucket.

Cloudflare R2 / AWS S3

Crea una policy CORS con questa configurazione:

[
  {
    "AllowedOrigins": ["*"],
    "AllowedMethods": ["GET", "POST", "HEAD", "DELETE", "PUT"],
    "AllowedHeaders": ["*"]
  }
]

Suggerimento

In produzione, sostituisci "*" in AllowedOrigins con l’URL della tua console Notifuse, per una sicurezza maggiore.

Google Cloud Storage

Per GCS, usa il comando gsutil con un file di configurazione JSON:

[
  {
    "origin": ["*"],
    "method": ["GET", "POST", "HEAD", "PUT", "DELETE", "OPTIONS"],
    "responseHeader": ["Content-Type", "*"]
  }
]

Applica la configurazione CORS:

gsutil cors set cors.json gs://your-bucket-name

Provider di storage supportati

I file si possono caricare su qualsiasi servizio di storage compatibile con S3:

  • Amazon S3
  • Cloudflare R2
  • DigitalOcean Spaces
  • Wasabi
  • MinIO
  • Backblaze B2
  • Google Cloud Storage (API S3)

Opzione S3 self-hosted

Se preferisci non usare un provider di storage cloud, puoi eseguire il nostro server di storage self-hosted compatibile con S3:

Storage S3 self-hosted

Un server di storage leggero, basato su Docker e compatibile con S3, per fare self-hosting di Notifuse senza dipendenze esterne.

È adatto a:

  • Ambienti isolati dalla rete o offline
  • Sviluppo e test
  • Utenti che vogliono il pieno controllo sui propri dati
  • Evitare i costi di un provider cloud

Uso dei file

Una volta configurato, i file caricati si possono usare per:

  • Le immagini dei template email
  • Gli allegati
  • Le risorse del brand (loghi, intestazioni)
  • Qualsiasi contenuto multimediale delle tue campagne email

Limiti

Il file manager elenca i primi 10.000 file di un bucket. In un bucket più grande, il conteggio delle cartelle, la dimensione totale e la ricerca considerano solo quei file; gli altri file restano archiviati e continuano a funzionare nelle tue email.

Integrazione con l’editor dei template

Il file manager è disponibile dall’editor visuale delle email:

  • Accesso da una finestra modale: il file manager si apre in una finestra modale mentre modifichi un template
  • Integrazione diretta: seleziona e inserisci file dall’editor
  • Caricamento in tempo reale: carica nuovi file senza uscire dall’editor dei template