Distribuire Coolify su VPS con un'immagine preinstallata

Distribuisci Coolify su un'infrastruttura VPS quando desideri una piattaforma self-hosted per costruire e gestire applicazioni, database e servizi su un server che controlli. L'immagine dell'applicazione VoyraCloud rimuove il lavoro iniziale di installazione di Coolify, mentre rimani responsabile per i progetti, le credenziali, i domini, i dati, gli aggiornamenti, i backup, la sicurezza e la capacità del VPS.

TL;DR

L'immagine Coolify di VoyraCloud fornisce Coolify su Ubuntu 24.04 LTS per configurazioni Cloud VPS e Residential IP VPS idonee.
Crea il primo amministratore di Coolify attraverso il tunnel SSH mostrato nei dettagli delle risorse VPS. Non esporre una pagina di registrazione non inizializzata a Internet pubblico.
L'indirizzo iniziale della dashboard locale è http://127.0.0.1:8000 mentre il tunnel SSH è aperto. Non è un URL pubblico.
Le porte 80 e 443 sono utilizzate dal proxy di Coolify per le applicazioni distribuite, la validazione del dominio e HTTPS. Le porte di gestione 8000, 6001 e 6002 rimangono off-line.
Punta il tuo dominio al VPS e inserisci un https:// FQDN in Coolify per consentire al suo proxy di richiedere e rinnovare un certificato Let’s Encrypt.
Coolify può distribuire da repository Git, Dockerfile, Docker Compose e immagini di container preconfezionate, ma le build e i database consumano le stesse risorse VPS a meno che non li sposti altrove.
Esegui il backup sia dell'istanza di Coolify che di ogni database, volume persistente, file e segreti delle applicazioni. Un backup del database di Coolify da solo non è un backup completo dell'applicazione.
VoyraCloud non aggiorna automaticamente la tua istanza di Coolify dopo la consegna. Controlla le versioni, esegui prima il backup e aggiorna deliberatamente.

Che cos'è Coolify?

Coolify è una piattaforma di distribuzione open-source e self-hosted per eseguire applicazioni, database e servizi compatibili con Docker su server che controlli. Fornisce una dashboard web per connettere repository sorgente, costruire applicazioni, gestire variabili d'ambiente, visualizzare log, assegnare domini, operare database e controllare distribuzioni.

Coolify si descrive come un'alternativa self-hostable a piattaforme come Heroku, Netlify e Vercel. La differenza importante è la proprietà operativa: Coolify gira sulla tua infrastruttura e i tuoi carichi di lavoro rimangono su server che amministri. La piattaforma aggiunge automazione alla distribuzione, ma non trasforma un VPS auto-gestito in un servizio di hosting gestito.

La introduzione ufficiale di Coolify elenca distribuzione basata su Git, servizi compatibili con Docker, domini personalizzati, gestione automatica dei certificati, backup su storage compatibile con S3, webhook, un'API, monitoraggio e un terminale browser tra le sue capacità.

Coolify è una buona scelta quando vuoi:

Distribuire siti web, API, worker e applicazioni full-stack da Git.
Eseguire immagini Docker o progetti Docker Compose attraverso un'unica interfaccia.
Operare carichi di lavoro di sviluppo, staging o piccole produzioni sul tuo server.
Gestire domini, variabili d'ambiente, log di distribuzione e controlli di salute in modo centrale.
Ospitare database e servizi insieme alle applicazioni quando il VPS ha sufficiente capacità.

È meno adatto quando nessuno può occuparsi dell'amministrazione di Linux, della sicurezza delle applicazioni, del recupero dei database o della risposta agli incidenti. Una dashboard amichevole riduce il lavoro ripetitivo; non elimina la necessità di un operatore.

Cosa include l'immagine Coolify di VoyraCloud?

L'immagine dell'applicazione include un ambiente di partenza Coolify testato, non un'applicazione aziendale preconfezionata o una piattaforma gestita. Ti consente di iniziare dal flusso del primo amministratore di Coolify invece di installare manualmente le dipendenze del sistema operativo e Coolify.

Incluso con l'immagine	Gestito dall'utente o non incluso
Ubuntu 24.04 LTS	Il tuo codice e architettura dell'applicazione
Versione fissa di Coolify testata al momento della creazione delle risorse	Aggiornamenti automatici di Coolify dopo la consegna
Servizi Coolify basati su Docker e proxy integrato	Un sito web, API, database o servizio one-click distribuito
Configurazione persistente di Coolify sul disco VPS	Recupero automatico da disastri off-server
Recupero del servizio dopo un riavvio normale del VPS	Alta disponibilità o failover automatico
Istruzioni per il tunnel SSH per il primo accesso	Un amministratore Coolify precreato
Porte pubbliche 80 e 443 per applicazioni e HTTPS	Un nome di dominio o gestione DNS
Porte di gestione solo locali	Esposizione pubblica della pagina di registrazione
Accesso completo all'amministrazione VPS	Operazioni gestite di Linux, database o applicazioni

La pagina delle risorse registra la versione di Coolify consegnata quando viene creato il VPS. Se successivamente aggiorni Coolify da solo, quel valore visualizzato non diventa un inventario software attivo.

Per un ambiente di container a livello inferiore senza una piattaforma di distribuzione, confronta questo modello con la guida Docker su VPS con Portainer. Docker e Portainer espongono direttamente le primitive dei container, mentre Coolify aggiunge flussi di lavoro orientati all'applicazione per build, dominio, distribuzione e servizi.

Come distribuisci Coolify su VPS dall'immagine dell'applicazione?

Inizia creando un VPS VoyraCloud idoneo, aprendo i dettagli dell'Applicazione e utilizzando il tunnel SSH fornito prima di creare il primo amministratore. Il tunnel è essenziale perché la pagina di registrazione iniziale può concedere il controllo sull'istanza di Coolify e sul server che gestisce.

1. Crea un VPS con l'immagine di Coolify

Apri la pagina Coolify di VoyraCloud, prosegui con il flusso di acquisto e seleziona una configurazione Cloud VPS o Residential IP VPS idonea. Scegli qualsiasi regione attualmente offerta dal prodotto selezionato e conferma che Coolify sia selezionato nella sezione Immagini.

VoyraCloud Cloud VPS è la scelta generale per l'hosting di applicazioni, build, API, database e strumenti per sviluppatori. Il Residential IP VPS è anche supportato quando un carico di lavoro legittimo ha specificamente bisogno delle caratteristiche di rete di quel prodotto, ma un IP residenziale non rende Coolify stesso più veloce, più sicuro o più facile da gestire.

La guida ufficiale all'installazione di Coolify stabilisce una base di due core CPU, 2 GB di RAM e 30 GB di spazio di archiviazione libero. Questo è un pavimento iniziale per la piattaforma, non una promessa di capacità per le applicazioni che distribuisci. Build, database, log, immagini di container e dati persistenti utilizzano tutte risorse aggiuntive.

2. Copia il comando del tunnel SSH

Attendi fino a quando il VPS è pronto, quindi copia il comando completo del tunnel SSH dalla sezione Applicazione della pagina delle risorse. Utilizza il nome utente SSH effettivo, la porta SSH e l'indirizzo pubblico del tuo VPS.

Il comando segue questa struttura:

ssh -p {ssh_port} \
  -L 8000:127.0.0.1:8000 \
  -L 6001:127.0.0.1:6001 \
  -L 6002:127.0.0.1:6002 \
  {ssh_user}@{server_ip}

Tieni aperta la sessione SSH. I tre forwarding supportano la dashboard, la comunicazione in tempo reale e il terminale del browser. Chiudere la sessione SSH chiude il tunnel ma non ferma Coolify sul VPS.

Se una di quelle porte locali è già in uso sul tuo computer, cambia solo il numero sul lato sinistro di quella mappatura. Ad esempio, -L 18000:127.0.0.1:8000 utilizza la porta locale 18000 pur raggiungendo ancora Coolify sulla porta del server 8000. Usa l'URL locale corrispondente nel tuo browser.

3. Crea il primo amministratore

Apri http://127.0.0.1:8000 mentre il tunnel è connesso e crea immediatamente il primo amministratore di Coolify. Usa un indirizzo email unico e una password forte che non venga riutilizzata altrove.

L'indirizzo è locale al tuo computer e funziona solo attraverso la connessione SSH autenticata. Non sostituirlo con http://{server_ip}:8000 o aprire porte di gestione a Internet come scorciatoia. La guida ufficiale all'installazione di Coolify avverte che un'altra persona che raggiunge prima una pagina di registrazione non inizializzata potrebbe ottenere il controllo completo del server.

Dopo la registrazione:

Accedi con il nuovo amministratore.
Conferma che il server localhost risulti raggiungibile.
Controlla le impostazioni di aggiornamento e mantieni disabilitati gli aggiornamenti automatici per un'operazione di produzione controllata.
Controlla l'uso di disco e memoria prima di distribuire un'applicazione.
Tieni il tunnel SSH come percorso di gestione fino a quando non configuri un dominio fidato.

4. Distribuisci una piccola prima applicazione

Utilizza un piccolo repository pubblico o un'immagine di container preconfezionata per la prima distribuzione in modo da poter convalidare il percorso completo prima di aggiungere un database o credenziali private. Coolify supporta repository Git pubblici e privati, Dockerfile, Docker Compose, immagini Docker preconfezionate e build packs.

Un primo test controllato dovrebbe verificare:

Coolify può raggiungere la sorgente selezionata.
La build termina senza esaurire CPU, memoria o disco.
Il container dell'applicazione diventa sano.
I log sono visibili e non contengono errori di avvio ricorrenti.
L'applicazione risponde attraverso il suo dominio assegnato.
Un riavvio del VPS non rimuove la sua configurazione o i dati persistenti.

Il repository di esempi di Coolify ufficiale contiene piccoli esempi di applicazioni adatti per l'apprendimento. Controlla l'esempio prima della distribuzione, perché il codice pubblico è comunque input di terze parti che gira sul tuo server.

Come funzionano i domini e HTTPS in Coolify?

Coolify può configurare il suo proxy e richiedere un certificato Let’s Encrypt dopo che il tuo dominio si risolve nel VPS e inserisci un https:// FQDN. VoyraCloud non include il dominio né controlla i suoi record DNS.

Per la dashboard di Coolify o un'applicazione distribuita:

Crea un record A che punti il nome host scelto all'indirizzo IPv4 del VPS.
Attendi fino a quando il DNS pubblico restituisce l'indirizzo atteso.
Inserisci il nome host completo in Coolify utilizzando lo schema https://.
Tieni raggiungibili le porte TCP pubbliche 80 e 443 affinché il proxy possa servire traffico e completare la validazione del certificato.
Attendi l'emissione del certificato, quindi apri l'URL HTTPS finale.
Conferma che l'HTTP semplice reindirizza a HTTPS e che il browser non mostra alcun avviso di certificato.
Testa il comportamento di rinnovo prima che il certificato diventi critico per un servizio di produzione.

La guida ufficiale ai domini di Coolify spiega che inserire un FQDN HTTPS fa sì che il proxy integrato Traefik o Caddy generi una configurazione di routing, richieda un certificato Let’s Encrypt e gestisca il rinnovo. Se l'emissione fallisce, Coolify può servire un certificato autofirmato, che mantiene l'endpoint raggiungibile ma causa comunque un avviso del browser. Tratta quell'avviso come un'impostazione HTTPS fidata fallita e correggi DNS, raggiungibilità, limiti di velocità o configurazione del proxy.

Dopo che un dominio della dashboard fidato funziona, puoi continuare a utilizzare il tunnel SSH o utilizzare il dominio HTTPS secondo la tua politica di accesso. Non pubblicare le porte 8000, 6001 o 6002 semplicemente perché la dashboard ha una password per l'amministratore. Le linee guida sul firewall di Coolify consentono di chiudere quelle porte quando è in uso un dominio personalizzato e un proxy integrato.

Quale metodo di distribuzione dovresti scegliere?

Scegli il metodo di distribuzione più semplice che corrisponde a come è costruita e mantenuta la tua applicazione. Ogni strato di build extra o servizio pubblico aumenta l'uso delle risorse e il lavoro operativo.

Metodo di distribuzione	Adatto meglio	Responsabilità principale
Build pack	Framework comuni con struttura di progetto convenzionale	Verificare i comandi di build e avvio rilevati
Dockerfile	Applicazioni che necessitano di un'immagine di build controllata e riproducibile	Mantenere il Dockerfile e le immagini di base
Docker Compose	Applicazioni multi-container e progetti Compose esistenti	Controllare reti, volumi, porte e dipendenze dei servizi
Immagine Docker preconfezionata	Software già pubblicato su un registro fidato	Bloccare una versione dell'immagine e verificarne la fonte
Servizio one-click	Strumenti self-hosted supportati con un template Coolify	Controllare le variabili generate, lo storage e le versioni delle immagini upstream

Coolify esegue applicazioni come container Docker. Costruire sorgente sullo stesso VPS può creare picchi di CPU, memoria e disco, specialmente per grandi dipendenze JavaScript, compilazione nativa o build Docker multi-stage. Se le build rendono il server non responsivo, aumenta la dimensione del VPS o utilizza un server di build separato invece di presumere che la dashboard possa isolare un lavoro illimitato.

Blocca le versioni delle immagini di applicazione e database dove pratico. Un tag fluttuante può estrarre una release materialmente diversa durante un redeploy di routine, creando un aggiornamento che non avevi pianificato.

Come dovresti dimensionare un VPS Coolify?

Dimensiona il VPS per Coolify più l'uso massimo delle risorse di ogni build, applicazione, database, flusso di log, backup e immagine di container memorizzata sul server. Il minimo del flusso di acquisto è una soglia di idoneità per un carico di lavoro iniziale piccolo, non una raccomandazione universale.

Modello di carico di lavoro	Pressione principale	Guida alla pianificazione
Un piccolo sito statico	Build CPU e archiviazione delle immagini	Mantenere margine per ricostruzioni e aggiornamenti
API senza un database locale	Picchi di memoria e traffico	Monitorare la memoria del processo e il comportamento di riavvio
Web app più database	RAM, latenza del disco e spazio di backup	Proteggere i dati del database con storage persistente e dump nativi
Più applicazioni	Memoria aggregata, log e immagini	Misurare i picchi combinati, non l'uso inattivo
Build di sorgente grandi	CPU, RAM, file temporanei e strati di immagine	Considerare un piano più grande o un server di build separato
Servizi stateful	Durabilità del disco, crescita e recupero	Pianificare ritenzione, backup off-server e test di ripristino

Controlla lo spazio libero su disco con la stessa attenzione della memoria. Gli strati delle immagini Docker, le cache di build, la cronologia delle distribuzioni, i log, i file del database e i backup possono crescere fino a quando le distribuzioni non riescono o i database si fermano. La pulizia dovrebbe rimuovere solo gli artefatti che comprendi; eliminare un volume attivo non è manutenzione di routine.

Se un carico di lavoro è critico per l'attività, un VPS singolo più grande migliora la capacità ma non fornisce alta disponibilità. Backup esterni, monitoraggio, failover e un design multi-server sono requisiti separati. Un distribuzione Uptime Kuma self-hosted può fornire un punto di vista di monitoraggio, ma non dovrebbe condividere ogni dominio di fallimento con il servizio che monitora.

Cosa devi eseguire il backup?

Esegui il backup dei dati del piano di controllo di Coolify e dello stato di ogni carico di lavoro distribuito come strati di recupero separati. Il processo di backup ufficiale di Coolify protegge le impostazioni di Coolify, ma non include automaticamente ogni volume di applicazione o database.

Un piano di recupero completo dovrebbe coprire:

Il backup del database di Coolify.
Il APP_KEY di Coolify, memorizzato in modo sicuro al di fuori del VPS.
Chiavi SSH gestite da Coolify necessarie per riconnettere i server gestiti.
Dump nativi del database per PostgreSQL, MySQL, MariaDB, MongoDB o altri servizi stateful.
Volumi persistenti e file di applicazione montati.
Repository Git, Dockerfile, file Compose e documentazione di distribuzione.
Variabili d'ambiente e segreti attraverso un processo sicuro e recuperabile.
Record DNS, proprietà del dominio, assunzioni del proxy e dipendenze del certificato.
Un ordine di ripristino testato su un altro server.

Non memorizzare l'unico backup sullo stesso VPS. Un guasto del disco, una compromissione dell'account, una cancellazione accidentale o la cancellazione del VPS possono rimuovere sia il carico di lavoro attivo che una copia locale.

La guida ufficiale al backup e ripristino di Coolify nota esplicitamente che un backup dell'istanza di Coolify non esegue il backup dei dati dell'applicazione come i mount dei volumi. Testa il ripristino con la stessa versione di Coolify utilizzata per creare il backup, quindi verifica progetti, credenziali, applicazioni, database e domini prima di dichiarare il recupero riuscito.

Come dovresti aggiornare Coolify e le applicazioni distribuite?

Aggiorna Coolify e le tue applicazioni deliberatamente, con un backup verificato e un piano di rollback per ogni strato stateful. L'immagine di VoyraCloud fornisce una versione fissa di Coolify e non aggiorna continuamente la tua istanza.

Prima di un aggiornamento di Coolify:

Leggi le note di rilascio ufficiali e le modifiche significative.
Registra la versione attualmente in esecuzione.
Esegui il backup del database di Coolify, APP_KEY, chiavi SSH, applicazioni, database e volumi.
Conferma di avere spazio libero su disco sufficiente per le nuove immagini e il lavoro di migrazione.
Pianifica una finestra di manutenzione.
Aggiorna a una versione specifica esaminata piuttosto che a un obiettivo fluttuante non esaminato.
Testa il login, la raggiungibilità del server, una build, una distribuzione, i log, il terminale, i domini, HTTPS e il recupero da riavvio.
Ripristina su un sistema separato quando devi dimostrare il rollback piuttosto che presumere che un'immagine di container più vecchia sia sufficiente.

Coolify supporta aggiornamenti automatici, semi-automatici e manuali. Per un'istanza di produzione, aggiornamenti manuali controllati o semi-automatici esaminati riducono le sorprese. La guida ufficiale all'aggiornamento raccomanda anche di eseguire il backup prima di un aggiornamento.

Gli aggiornamenti delle applicazioni sono separati. Un aggiornamento di Coolify non aggiorna ogni applicazione in modo sicuro, e una nuova immagine di applicazione può includere migrazioni di database che rendono più difficile il rollback. Blocca le versioni, rivedi le modifiche upstream, esegui il backup dei dati, distribuisci, testa e monitora ogni carico di lavoro secondo i propri requisiti.

Errori comuni da evitare

Gli errori più gravi di Coolify riguardano l'esposizione pubblica della gestione, backup incompleti e il trattare una piattaforma di distribuzione come un'infrastruttura illimitata. Evita questi schemi:

Non esporre una pagina di registrazione non inizializzata di Coolify a Internet pubblico.
Non aprire le porte 8000, 6001 o 6002 come scorciatoia attorno al tunnel SSH o alla configurazione del dominio.
Non presumere che UFW da solo blocchi le porte pubblicate da Docker; verifica la raggiungibilità da una rete esterna.
Non posizionare database su porte pubbliche a meno che l'accesso remoto non sia richiesto e sicuro.
Non impegnare segreti ambientali in Git o incollarli nei log di build pubblici.
Non utilizzare tag di container fluttuanti per servizi stateful importanti.
Non presumere che un avvio di container riuscito significhi che un'applicazione sia sana.
Non trattare il VPS minimo idoneo come sufficiente per build arbitrarie o più database.
Non mantenere l'unico backup sullo stesso VPS.
Non confondere un backup del database di Coolify con backup di volumi di applicazione o database.
Non abilitare aggiornamenti non presidiati senza comprendere migrazioni e rollback.
Non aspettarti che un VPS fornisca alta disponibilità.

FAQ

Cosa significa self-host Coolify su un VPS?

Significa eseguire la piattaforma di distribuzione Coolify su un server Linux virtuale che controlli. Coolify gestisce build, container, domini, servizi e flussi di lavoro di distribuzione, mentre tu gestisci il VPS, le applicazioni, i dati, le credenziali, gli aggiornamenti, la sicurezza, i backup e la capacità.

Devo installare Coolify manualmente?

No, l'immagine dell'applicazione VoyraCloud fornisce Coolify preinstallato. Crea un VPS idoneo, copia il comando del tunnel SSH dalla pagina delle risorse, apri l'URL della dashboard locale e crea il primo amministratore. Devi comunque distribuire e configurare le tue applicazioni.

Perché la dashboard di Coolify non è disponibile all'IP pubblico del server?

La dashboard iniziale è intenzionalmente accessibile tramite un tunnel SSH perché la prima registrazione concede un controllo ad alta privilegio. Tieni aperto il tunnel fornito e visita http://127.0.0.1:8000. In seguito, puoi configurare il tuo dominio della dashboard e HTTPS fidato attraverso il proxy di Coolify.

Quali porte necessita Coolify?

Le porte pubbliche 80 e 443 supportano il traffico delle applicazioni, la validazione del dominio e HTTPS, mentre le porte di gestione 8000, 6001 e 6002 rimangono locali nell'immagine di VoyraCloud. SSH utilizza la porta mostrata per il tuo VPS. Porte aggiuntive dipendono dalle applicazioni che pubblichi deliberatamente.

Coolify fornisce automaticamente HTTPS?

Coolify può configurare automaticamente il suo proxy e richiedere un certificato Let’s Encrypt dopo che punti un dominio al VPS e inserisci un FQDN HTTPS. Un dominio non è incluso, il DNS deve risolversi correttamente e le porte pubbliche 80 e 443 devono essere raggiungibili. Un fallback autofirmato non è HTTPS fidato dal browser.

Posso distribuire repository Git privati?

Sì, Coolify supporta flussi di lavoro per repository privati attraverso integrazioni Git supportate e chiavi di distribuzione. Usa credenziali con il minimo privilegio, controlla l'esposizione dei webhook, ruota le chiavi quando l'accesso cambia e non memorizzare mai le credenziali del repository in log pubblici o codice.

Coolify esegue il backup di ogni applicazione distribuita?

No, un backup dell'istanza di Coolify non protegge automaticamente ogni database, volume o file dell'applicazione. Esegui il backup del piano di controllo di Coolify, dei database delle applicazioni, dello storage persistente, della configurazione, dei segreti e della documentazione di recupero separatamente, quindi testa il ripristino completo.

Il VPS minimo idoneo è sufficiente per più applicazioni?

Non necessariamente. Il minimo supporta la piattaforma Coolify e un carico di lavoro iniziale leggero, mentre la capacità reale dipende dalle dimensioni della build, dalla memoria dell'applicazione, dai database, dai log, dal traffico, dai backup e dalla crescita dello storage. Monitora l'uso effettivo e passa a una configurazione più grande prima che la pressione sulle risorse influisca sull'affidabilità.

VoyraCloud aggiorna Coolify per me?

No, Coolify è auto-gestito dopo la consegna del VPS. Mantieni gli aggiornamenti automatici controllati, rivedi le note di rilascio upstream, esegui il backup di tutti i dati richiesti e aggiorna a una versione specifica testata. Gli aggiornamenti del sistema operativo e delle applicazioni rimangono responsabilità separate.

Coolify può rendere un VPS altamente disponibile?

No, un VPS Coolify rimane un dominio di fallimento. Un server più grande può fornire maggiore capacità, ma l'alta disponibilità richiede server separati, bilanciamento del carico, stato replicato dove appropriato, monitoraggio indipendente, backup esterni e failover testati.

Conclusione

Self-host Coolify su un VPS quando desideri automazione della distribuzione orientata alle applicazioni senza rinunciare al controllo del server sottostante. L'immagine dell'applicazione VoyraCloud ti offre un ambiente di partenza testato e un percorso di primo accesso privato, mentre Coolify fornisce flussi di lavoro per Git, Docker, dominio, HTTPS, database e servizi.

Inizia con il tunnel SSH, crea il primo amministratore, distribuisci una piccola applicazione e convalida un dominio reale con HTTPS fidato. Poi aggiungi gradualmente i carichi di lavoro, misura l'uso delle risorse, blocca le versioni, proteggi i segreti, esegui il backup di ogni strato stateful e testa il recupero prima che il server diventi critico.

Per un flusso di lavoro di gestione dei container a livello inferiore, confronta questo approccio con l'esecuzione di Docker e Portainer su un VPS.

Esplora l'immagine dell'applicazione VoyraCloud Coolify per partire dall'ambiente preinstallato.