Con le App One-Click installi applicazioni come Nextcloud, n8n, database o strumenti di monitoraggio dal catalogo delle app sul tuo server dedicato e le gestisci direttamente nella dashboard ZapX. In background viene eseguito Coolify, una piattaforma open source per le app containerizzate.
A differenza di un VPS, configuri le app con un clic sul server dedicato una sola volta: crei un comando nella dashboard e lo esegui come root sul server. Al resto ci pensa ZapX. In questa guida scoprirai di cosa ha bisogno il server, come si svolge la configurazione, come gestire le app e a cosa serve l'accesso di manutenzione di ZapX sul server.
Cosa serve al tuo server dedicato: verifica questi requisiti prima di eseguire il comando. Il comando li controlla automaticamente e si interrompe senza apportare modifiche se qualcosa non è a posto.
| Requisito | Minimo |
|---|---|
| Sistema operativo | Debian o Ubuntu con server SSH |
| RAM | 2 GB |
| CPU | 2 core |
| Spazio libero | 30 GB |
| Indirizzo IP | Indirizzo IPv4 pubblico configurato sul server |
| Porte libere | 8000, 6001, 6002 e 8080 (le tue app hanno bisogno delle porte 80 e 443) |
| SSH | La porta SSH del server deve essere raggiungibile da ZapX |
È consigliabile un sistema operativo pulito: configura le app con un clic preferibilmente su un'installazione pulita di Debian o Ubuntu. I servizi che occupano già delle porte, una configurazione Docker personalizzata o un'installazione di Coolify con un proprio login interrompono la configurazione. Puoi avviare una nuova installazione dalla scheda Installazione del tuo server dedicato.
Host Proxmox e Windows: non puoi configurare le app con un clic direttamente su un host Proxmox. Per farlo, usa una VM sul server che utilizzi uno degli indirizzi IP del server. Windows non è supportato.
Solo il proprietario del server può configurare le app con un clic.
Apri il tuo server dedicato nella dashboard ZapX e passa alla scheda App One-Click. Qui vedrai la scheda Configura One-Click Apps.
Seleziona due opzioni:
- Indirizzo IP per pannello e app: qui trovi gli indirizzi IPv4 pubblici del server; quello principale è contrassegnato. In seguito, il pannello Coolify e le tue app saranno raggiungibili tramite questo IP.
- Email admin per Coolify: userai questo indirizzo e-mail per accedere al pannello Coolify.
Poi fai clic su Crea comando. ZapX prepara l'indirizzo del pannello. L'operazione può richiedere fino a un minuto.
Accedi al server tramite SSH come root. Copia il comando visualizzato facendo clic sull'icona di copia ed eseguilo. Inizia con curl -fsSL e termina con | bash.
Se sul server manca curl, installalo prima con:
apt update && apt install -y curl
L'installazione continuerà poi in background. Puoi chiudere il terminale.
Non condividere il comando: contiene una chiave personale valida solo per questo server e per 24 ore. Non condividerla. Se ti serve un nuovo comando, fai clic su Annulla l'installazione manuale e creane uno nuovo.
Nella scheda puoi vedere a che punto è la configurazione:
| Indicazione | Significato |
|---|---|
| Attendiamo che tu esegua il comando sul server. | Il comando non è ancora stato avviato |
| Connessione stabilita. L'installazione è in corso sul server. | ZapX sta installando Coolify; di solito occorrono fino a 10 minuti |
| Coolify è installato. Stiamo collegando il pannello. | Ultimo passaggio, richiede circa un minuto |
Se dopo alcuni minuti ZapX non riesce ancora a raggiungere il server tramite SSH, nella scheda verrà mostrato un avviso. Controlla se il firewall consente connessioni in entrata sulla porta SSH del server.
- Controlla il sistema operativo, le risorse, l'indirizzo IP e le porte libere. Se qualcosa non è a posto, si interrompe e mostra un messaggio.
- Crea l'utente
zapx-appscon privilegi sudo. ZapX usa questo utente per gestire Coolify e le tue app. L'accesso è possibile solo con una chiave di ZapX e solo dagli indirizzi di ZapX; non è possibile accedere con una password. - Installa Coolify usando il programma di installazione ufficiale, che configura anche Docker.
- Per la configurazione, ZapX usa temporaneamente una chiave root con privilegi fortemente limitati e, se necessario, modifica la configurazione SSH. Entrambe vengono rimosse al termine della configurazione.
- Il comando non modifica le regole del firewall.
Trovi il log della configurazione sul server in /var/lib/zapx-oneclick-apps/setup.log.
Al termine della configurazione, nella scheda App One-Click vedrai tre sezioni:
| Sezione | Contenuto |
|---|---|
| App installate | Le tue app, con stato e azioni disponibili |
| Catalogo delle app | Tutte le app disponibili per l'installazione |
| Accesso e impostazioni | Indirizzo del pannello, login e accesso di manutenzione |
- Apri il Catalogo delle app e cerca l'app che vuoi installare.
- Fai clic su Installa.
- Nella finestra Installare l'app, inserisci i valori richiesti, ad esempio
[il_tuo_nome_app]o[il_tuo_dominio]. - Fai clic su Metti l'installazione in coda.
Se la RAM del server non è sufficiente per un'app, nel catalogo vedrai l'avviso «Il tuo server non ha abbastanza RAM per questa app».
Chiedi aiuto all'Agente AI ZapX: puoi chiedere all'Agente AI ZapX del tuo server di suggerirti un'app adatta, controllare lo stato delle tue app o preparare un'installazione. L'agente esegue ogni modifica solo dopo la tua conferma. Gestisci sempre le credenziali e i dati segreti nella scheda App One-Click.
In App installate puoi gestire direttamente ogni app:
| Azione | Scopo |
|---|---|
| Avvia | Avvia un'app arrestata |
| Arresta | Arresta un'app in esecuzione |
| Riavvia | Riavvia l'app |
| Log | Mostra i log dell'app per la risoluzione dei problemi |
| Impostazioni | Modifica i valori dell'ambiente, il dominio e altre opzioni dell'app |
La scheda Accesso per la manutenzione mostra se ZapX riesce a raggiungere il server:
| Stato | Significato |
|---|---|
| Attivo | ZapX raggiunge il server e gestisce Coolify e le tue app |
| Interrotto | ZapX non riesce più a raggiungere il server, ad esempio perché la chiave host SSH è cambiata o la chiave di ZapX non viene più accettata |
| Rimosso | Hai rimosso l'accesso di manutenzione |
Con Rimuovi accesso, ZapX elimina dal server la propria chiave, la regola sudo e l'utente zapx-apps. Coolify e le tue app continueranno a funzionare, ma ZapX non potrà più gestirli: non potrai più installare app, risolvere problemi o apportare modifiche dalla dashboard. In questo caso, gestisci le app direttamente dal pannello Coolify.
Se il server non è raggiungibile quando rimuovi l'accesso, ZapX lo disattiva dal proprio lato. Puoi quindi eliminare manualmente dal server l'utente zapx-apps e il file /etc/sudoers.d/zapx-apps.
Con Ripristina accesso, crei un nuovo comando che configura nuovamente solo l'accesso di manutenzione. Coolify e le tue app non vengono modificati. Esegui il comando sul server come root, proprio come durante la configurazione iniziale.
| Evento | Cosa succede |
|---|---|
| Reinstallazione dalla scheda Installazione | La configurazione viene reimpostata e gli indirizzi su zap.cloud vengono eliminati. Il sistema viene reinstallato: salva prima i dati delle tue app. Poi configura di nuovo le app con un clic. |
| Rilascio dell'indirizzo IP del pannello e delle app | L'accesso di manutenzione viene rimosso, gli indirizzi su zap.cloud vengono eliminati e la configurazione viene reimpostata. Coolify e le tue app continuano a funzionare sul server. Per gestirli di nuovo dalla dashboard, configura le app con un clic usando un altro indirizzo IP. |
| Disdetta o termine del contratto | L'accesso di manutenzione e gli indirizzi su zap.cloud vengono rimossi. |
| Messaggio o problema | Soluzione |
|---|---|
| Nessuna connessione SSH dopo alcuni minuti | Controlla che il server SSH sia in esecuzione e che il firewall consenta l'accesso alla porta SSH |
| Porte già occupate | Arresta i servizi che usano le porte 8000, 6001, 6002 e 8080 oppure reinstalla il server |
| Coolify è già installato | ZapX non può gestire un'installazione di Coolify con un login personalizzato. Rimuovila oppure usa un sistema pulito |
| Il server SSH consente l'accesso solo a determinati utenti (AllowUsers) | Aggiungi zapx-apps alla configurazione SSH ed esegui di nuovo il comando |
| È in corso un'installazione sul server | Attendi che l'installazione nella scheda Installazione sia completata |
| Il server non ha ancora un indirizzo IPv4 pubblico | Configura prima un indirizzo IPv4 pubblico per il server |
| Troppi tentativi | Attendi qualche minuto, poi crea un nuovo comando |
Trovi altri dettagli su una configurazione non riuscita in /var/lib/zapx-oneclick-apps/setup.log. Se non riesci a risolvere il problema, crea un ticket di assistenza e indica il messaggio di errore mostrato nella scheda.
Fonte preferita su Google
