Come migrare un sito Netlify su un VPS

Desideri abbandonare Netlify, ma senza il rischio che il tuo sito risulti inaccessibile non appena modifichi la configurazione DNS.

In sintesi: per migrare un progetto da Netlify a un server proprietario, occorre trasferire l'applicazione o il sito già compilato, ricostruire i servizi gestiti in precedenza dalla piattaforma, instradare il dominio verso il nuovo server e reindirizzare il traffico solo a collaudo completato. Il trasferimento delle risorse statiche rappresenta la fase più lineare; il vero margine di rischio risiede nella re-architettura delle funzionalità integrate di Netlify, come Netlify Functions, Netlify Forms, le regole in _redirects, le variabili d’ambiente e i certificati HTTPS.

Cosa cambia quando passi da Netlify al tuo server?

Netlify non si limita a ospitare i file di un sito web, ma agisce come un'infrastruttura operativa automatizzata: esegue la build del codice, distribuisce le pagine elaborate, gestisce la cifratura HTTPS, applica le regole di reindirizzamento ed esegue l'eventuale codice backend serverless.

Con il passaggio a un server proprietario, la gestione di questi processi diventa di tua pertinenza. Ciò non rende la migrazione complessa, ma impone una pianificazione rigorosa.

Il trasferimento di un sito statico essenziale equivale allo spostamento di materiale informativo cartaceo: è sufficiente compilare il progetto, trasferire la directory finale ed erogarne i contenuti.

Un'applicazione dotata di moduli di contatto, endpoint serverless, regole di reindirizzamento o variabili d’ambiente riservate richiede invece la migrazione dell'intero ecosistema operativo: non basta trasferire la struttura superficiale, ma occorre ricreare la logica funzionale, le integrazioni e le credenziali di accesso.

Di cosa hai bisogno prima di migrare?

Il primo passo consiste nell'eseguire un censimento preventivo delle componenti infrastrutturali, evitando criticità in fase di rilascio.

È necessario disporre di un server con risorse adeguate al carico previsto, un dominio con gestione DNS accessibile, la cifratura HTTPS per l'host finale e la conoscenza dettagliata del processo di compilazione dell'applicazione. In caso di dubbi sul dimensionamento hardware, si consiglia di partire con una configurazione base per poi adattare le risorse in funzione delle metriche reali di utilizzo.

Occorre inoltre individuare la cartella di output generata dalla fase di build, solitamente denominata dist, build, public o out. Un generatore di siti statici è lo strumento che trasforma il codice sorgente nei file HTML, CSS e JavaScript interpretabili dal browser.

Prima di aggiornare i puntamenti DNS, verifica la presenza di queste dipendenze specifiche dell'infrastruttura Netlify:

• Utilizzo di Netlify Functions;
• Utilizzo di Netlify Forms;
• Presenza di regole nei file _redirects o netlify.toml;
• Variabili d’ambiente definite sul pannello Netlify;
• Gestione di domini secondari, sottodomini o ambienti di preview.

Se la gestione dei record DNS rappresenta una procedura nuova, la nostra guida su come collegare un dominio al tuo server illustra i passaggi operativi in modo chiaro e lineare.

Come sposti un semplice sito statico Netlify?

Per un sito statico privo di dinamicità backend, il processo di migrazione risulta estremamente lineare.

Esegui per prima cosa la build del progetto in locale, replicando l'ambiente di compilazione utilizzato da Netlify. L'obiettivo è generare la cartella di output definitiva destinata alla produzione. Eventuali errori in fase di build locale non vanno ignorati: potrebbero indicare la mancanza di variabili d’ambiente o impostazioni di configurazione precedentemente definite sulla piattaforma.

Trasferisci la cartella di output sul server e associala alla configurazione del dominio. Se il web server punta a una directory errata, i visitatori riscontreranno un errore 404 Not Found, anche in presenza dei file sul disco fisso.

Configura quindi la cifratura HTTPS. Un sito raggiungibile ma privo di un certificato SSL valido verrà segnalato dai browser come non sicuro, compromettendo la fiducia degli utenti. Per approfondire l'argomento con un approccio pratico, consulta la guida su come ottenere HTTPS gratis sul tuo server.

Effettua infine una sessione di collaudo completa prima di variare i record DNS ufficiali. Verifica il corretto caricamento della homepage, delle pagine interne, degli asset multimediali, degli script e delle rotte che in precedenza dipendevano dalle regole di redirect di Netlify.

E se le funzioni di Netlify stanno facendo lavoro extra?

In presenza di logiche backend integrate, la migrazione richiede maggiore attenzione per evitare l'interruzione di servizi non immediatamente visibili.

Le Netlify Functions sono endpoint serverless che necessitano di una nuova collocazione architetturale sul server proprietario. Ciò può comportare l'esecuzione di una micro-applicazione affiancata al sito statico o la sostituzione della funzione con un servizio dedicato.

I moduli gestiti tramite Netlify Forms non si trasferiscono automaticamente. Se il modulo di contatto si affidava a Netlify per la ricezione degli invii, occorre integrare un gestore di form alternativo, uno script di inoltro email o un endpoint backend dedicato, evitando che i messaggi inviati dagli utenti vadano dispersi.

Anche le regole di reindirizzamento richiedono una riconversione manuale. Le istruzioni presenti in _redirects o netlify.toml non vengono interpretate nativamente dal nuovo server e devono essere ricreate nella configurazione del web server (come Nginx o Caddy). L'omissione di questo passaggio può causare errori 404 Not Found sui vecchi URL o compromettere il routing interno delle Single Page Application (SPA) al ricaricamento della pagina.

Le variabili d’ambiente rappresentano un ulteriore elemento critico: includono parametri riservati come chiavi API o credenziali di accesso. Se il nuovo server non espone correttamente tali variabili all'applicazione, la build potrebbe fallire o generare errori 502 Bad Gateway a causa del blocco dei processi backend.

Per la gestione di un'applicazione web dinamica in alternativa a un sito statico, la nostra guida su come pubblicare una web app senza DevOps offre un valido supporto metodologico.

La soluzione semplificata

Server Manager semplifica il processo di migrazione mantenendo l'architettura dell'infrastruttura trasparente ed evitando l'accumulo di modifiche manuali non documentate. L'obiettivo finale è garantire che il dominio punti correttamente alla destinazione prevista, che la cifratura HTTPS sia attiva e che la configurazione rimanga intelligibile nel tempo.

Questo approccio previene le anomalie frequenti post-migrazione: puntamenti DNS residui verso Netlify, certificati SSL non validi o scaduti, regole di reindirizzamento omesse, interferenze tra progetti distinti o malfunzionamenti dovuti a variabili d'ambiente non configurate.

Il vantaggio fondamentale risiede nella manutenibilità del sistema: le relazioni tra domini, servizi ed elementi di configurazione rimangono chiare e consultabili, evitando la necessità di ricostruire a memoria le scelte effettuate in fase di trasferimento.

FAQ

È possibile migrare un sito Netlify senza ricompilarlo? In alcuni casi sì: disponendo già dei file statici compilati, è possibile erogarli direttamente. Tuttavia, eseguire la build a partire dal codice sorgente è la procedura consigliata, poiché garantisce la replicabilità del progetto nel nuovo ambiente.

Le regole presenti nei reindirizzamenti di Netlify funzioneranno automaticamente? No. Le istruzioni contenute nei file _redirects o netlify.toml devono essere convertite e integrate nella configurazione del web server adottato.

**Per quale motivo viene visualizzato l'errore 404 Not Found dopo il trasferimento?** Questo errore si verifica in genere quando il web server punta a una directory errata, quando manca la configurazione del fallback per le rotte interne o quando la propagazione DNS punta ancora alla vecchia destinazione.

**Per quale motivo viene visualizzato l'errore 502 Bad Gateway dopo il trasferimento?** Indica di norma che il processo backend o la funzione associata non è in esecuzione correttamente, spesso a causa di variabili d’ambiente mancanti o di un errore in fase di avvio.

È necessario eliminare immediatamente il progetto su Netlify? No. È opportuno mantenere attivo il progetto su Netlify finché il nuovo server non è stato collaudato, i record DNS non si sono propagati, il certificato HTTPS risulta operativo e la funzionalità di moduli e servizi backend è stata pienamente confermata.

Una migrazione eseguita con criterio non consiste in un'interruzione brusca dei servizi, ma nella comprensione delle dipendenze esistenti, nella corretta sostituzione dei componenti gestiti e nel reindirizzamento del traffico solo a infrastruttura pronta.

Seguendo questo metodo si ottiene il risultato desiderato: l'applicazione risiede sul server di proprietà, le componenti critiche rimangono operative e la configurazione di pagine, moduli, certificati e reindirizzamenti resta stabile e controllata.