La funzionalità App One-Click ti permette di esplorare un ampio catalogo di app e di distribuirle direttamente dall’interfaccia web del tuo VPS. In questa guida scoprirai come preparare il server, scegliere il tipo di installazione più adatto, installare e gestire le app e, se necessario, utilizzare le impostazioni avanzate e gli strumenti di risoluzione dei problemi.
Prima di utilizzare le App One-Click, il tuo VPS deve soddisfare i requisiti minimi e utilizzare un sistema operativo supportato.
Requisiti minimi La funzionalità App richiede che il tuo VPS sia online e configurato con risorse sufficienti per eseguire in modo affidabile sia i servizi della piattaforma sia le app installate.
| Requisito | Minimo | Consigliato |
|---|---|---|
| Stato del server | Online | Online |
| Spazio di archiviazione | 30 GB | 50 GB |
| RAM | 2 GB | 4 GB |
| CPU | 2 core | 4 core |
| Sistema operativo | Debian o Ubuntu LTS | Debian 13 |
Si consiglia un sistema operativo appena installato Ti consigliamo vivamente di configurare la funzionalità App su un sistema operativo appena installato. In questo modo eviterai conflitti con servizi esistenti, porte già occupate, configurazioni Docker o impostazioni personalizzate già presenti sul server.
Se devi reinstallare il tuo VPS, usa un’immagine Debian o Ubuntu LTS supportata e appena installata dall’interfaccia di gestione del VPS.
Dopo il deployment, le app installate vengono elencate nella sezione di gestione della scheda. Da qui puoi monitorare e controllare i servizi senza dover gestire manualmente i container sottostanti.
La sezione delle app installate ti permette di eseguire le operazioni più comuni del ciclo di vita direttamente dalla scheda.
| Azione | Scopo |
|---|---|
| Avvia | Avvia un’app arrestata |
| Arresta | Arresta un’app in esecuzione |
| Controlla i log | Apre i log dell’app per la risoluzione dei problemi |
| Reinstalla | Reinstalla l’app |
Questi strumenti semplificano la gestione di tutte le app in un unico posto, soprattutto se preferisci un controllo web semplice invece di usare manualmente la riga di comando.
Progetti e ambienti ti aiutano a strutturare chiaramente i deployment. Puoi usarli per separare:
- app private e di produzione
- ambienti di test e live
- deployment di più clienti o team
- stack diversi sullo stesso VPS
Questa organizzazione diventa sempre più importante man mano che la raccolta di app cresce e gestisci più servizi su uno o più Node.
La funzionalità App One-Click supporta i domini personalizzati e l’integrazione ZAP Cloud. In questo modo puoi rendere accessibili le app in sicurezza e fornire certificati SSL ai tuoi deployment.
Supporto per domini e SSL Puoi usare domini personalizzati per le tue app e usufruire della configurazione automatica dei certificati SSL, se supportata dalla piattaforma.
Quando assegni un dominio, assicurati che i record DNS puntino a [deine_server_ip]. Se il dominio non è configurato correttamente, l’app potrebbe non essere accessibile da Internet.
| Valore | Descrizione |
|---|---|
[deine_domain] | Il dominio o sottodominio assegnato alla tua app |
[deine_server_ip] | L’indirizzo IP pubblico del tuo VPS |
Il DNS deve puntare al tuo VPS
Se il DNS di [deine_domain] non punta a [deine_server_ip], la convalida del dominio e l’accesso all’app potrebbero non funzionare.
Se la dashboard mostra uno stato degradato, significa che la piattaforma non riesce a raggiungere l’istanza che esegue la funzionalità App One-Click o a recuperarne i dati. Segui i passaggi di risoluzione dei problemi nell’ordine indicato.
La finestra di risoluzione dei problemi può mostrare i seguenti indicatori:
| Stato | Significato |
|---|---|
| Stato Coolify: Attivo | Il servizio del pannello sembra essere in esecuzione |
| Stato API: Raggiungibile | L’API è attualmente raggiungibile |
| Stato del servizio: Online | Il tuo VPS è online |
Se uno o più componenti non funzionano correttamente, prosegui con i passaggi seguenti.
Per prima cosa, assicurati che il tuo VPS sia online nella dashboard ZapX. Se il server è offline, la piattaforma App non può funzionare.
Usa l’azione Aggiorna stato per eseguire nuovamente il controllo dello stato con i dati più recenti. Questo può risolvere problemi temporanei di connessione.
Problemi temporanei di connessione A volte, uno stato degradato può essere causato da brevi problemi di comunicazione. Aggiornare lo stato è il controllo iniziale più rapido.
Se lo stato rimane degradato, usa l’azione Riavvia Docker. L’istanza della piattaforma verrà riavviata. Dopo aver ricevuto la conferma dell’operazione, attendi 1-2 minuti e aggiorna nuovamente lo stato.
Riavvio del servizio Il riavvio di Docker può interrompere temporaneamente le app in esecuzione mentre i servizi si riavviano.
Come ultimo passaggio, usa Aggiorna credenziali. È particolarmente importante se lo stato risulta online, ma alcune funzioni della dashboard, come l’installazione delle app, non funzionano.
Questa azione:
- non elimina i tuoi dati
- aggiorna le credenziali dell’utente root
- rinnova il token API utilizzato dalla dashboard
- aggiorna automaticamente le credenziali del pannello se l’operazione riesce
Aggiornamento sicuro delle credenziali L’aggiornamento delle credenziali non rimuove le app installate né i dati di deployment. Rinnova solo le credenziali necessarie per l’accesso e la comunicazione.
Se il problema persiste dopo aver seguito tutti i passaggi di risoluzione, crea un ticket di supporto sul sito web di ZAP-Hosting.
Per mantenere le App One-Click stabili e facili da gestire, segui queste raccomandazioni:
| Buona pratica | Motivo |
|---|---|
| Usa un sistema operativo appena installato | Evita conflitti con servizi esistenti e porte occupate |
| Rispetta le risorse consigliate | Migliora prestazioni e affidabilità |
| Organizza le app in progetti e ambienti | Mantiene i deployment organizzati |
| Configura il DNS prima di assegnare un dominio | Previene problemi di accesso e SSL |
| Usa con cautela le impostazioni avanzate | Evita modifiche personalizzate non supportate |
Mantieni organizzati i deployment
Se vuoi ospitare molte app, definisci uno schema di denominazione chiaro per [dein_projektname], [dein_umgebungsname] e [dein_appname] prima del primo deployment.
Fonte preferita su Google
