Documentazione
Avvio rapido + descrizione di ogni funzione per ogni sezione e dispositivo (in continuo aggiornamento)
Catalogo app
Questo documento presenta il «Catalogo app» del pannello: la guida completa per distribuire con un clic le applicazioni più comuni.
In una frase
Il Catalogo app è l'«app store» integrato: raccoglie numerose applicazioni open source di uso comune (blog, cloud storage, note, monitoraggio, database ecc.). Con un clic la distribuzione Docker viene completata automaticamente sul server di destinazione, senza scrivere a mano docker-compose né cercare tutorial.
Panoramica delle funzionalità
Il Catalogo app raccoglie applicazioni open source di uso comune; ogni applicazione ha già pronti «credenziali predefinite + porta + directory dati + passi di distribuzione + avvertenze». Devi solo fare clic su «Installa», scegliere il server e compilare alcuni parametri chiave: tutto il resto (scaricare l'immagine, creare il database, configurare le variabili d'ambiente, avviare il container) viene fatto automaticamente.
Scenari d'uso
- Vuoi distribuire rapidamente un'applicazione (come il cloud storage Nextcloud, il blog WordPress, le note Memos)
- Non vuoi studiarti da solo variabili d'ambiente, mappatura delle porte e persistenza dei dati
- Vuoi che ogni applicazione abbia già «credenziali predefinite + passi di distribuzione + avvertenze»
Come si usa
1. Entra nel «Catalogo app», sfoglia o cerca l'applicazione
2. Passa a «Tutte» o «Installate»
3. Fai clic su un'applicazione per vederne i dettagli (credenziali predefinite, porta, directory dati, avvertenze)
4. Fai clic su «Installa», scegli il server di destinazione e compila la configurazione come indicato (password, porta ecc.)
Installazione con un clic dei CMS (Content Management System)
Il Catalogo app include la categoria «Content Management System (installazione CMS con un clic)», con i CMS più diffusi come WordPress, Joomla, Drupal, MediaWiki, Halo e Ghost: tutti supportano installazione con un clic + configurazione automatica del database, senza mai scrivere SQL a mano:
1. Verifica/installa automaticamente Docker
2. Avvia automaticamente il container MariaDB condiviso (sshe-mysql, serve una sola volta, i CMS successivi lo riutilizzano)
3. Crea automaticamente per ogni sito un database e un utente dedicati (password robusta casuale; la password di root è salvata in modo persistente sul server in /opt/sshe-mysql/.root_password per riutilizzarla)
4. Avvia automaticamente il container CMS e inietta la configurazione del database
5. Al termine dell'installazione una finestra mostra indirizzo di accesso + credenziali del database, copiabili con un clic
Tre modalità:
- Tutto automatico (WordPress / Joomla): l'immagine ufficiale supporta le variabili d'ambiente del database, subito utilizzabile dopo l'installazione
- Procedura guidata web (Drupal / MediaWiki): lo strumento crea automaticamente database e utente; nella procedura guidata web inserisci le credenziali generate automaticamente (senza digitare SQL)
- Database integrato (Halo / Ghost): nessun database esterno necessario, si avvia direttamente con un clic
> Suggerimento: se su un server in Cina il download delle immagini da Docker Hub va in timeout, configura prima sul server un acceleratore di mirror Docker (acceleratori pubblici come docker.1ms.run / docker.m.daocloud.io).
Visualizzare / eseguire il backup delle credenziali del database di un sito
Dopo l'installazione con un clic, le credenziali del database di ogni sito vengono salvate automaticamente sul server di destinazione: /opt/sshe-db-creds/<nome-container>.conf (con DB_HOST / DB_NAME / DB_USER / DB_PASS / DB_ROOT, permessi 600).
Nei dettagli CMS del Catalogo app o del Catalogo immagini fai clic su «Visualizza credenziali del database» per consultarle in qualsiasi momento; la finestra include automaticamente:
- 🚀 Distribuzione di phpMyAdmin con un clic: un clic distribuisce automaticamente phpMyAdmin nella rete
sshe-cms-net(sceglie da solo una porta libera, predefinita 8888, puntando asshe-mysql) e fornisce il pulsante «Apri phpMyAdmin (login già compilato)», che entra direttamente nel database per una navigazione visiva a prova di principiante, con import/export e query. - Comando di backup:
docker exec sshe-mysql mariadb-dump -uroot -p'<DB_ROOT>' <DB_NAME> > /opt/sshe-db-creds/<DB_NAME>.bak.sql - Accesso alternativo a phpMyAdmin: come server usa
sshe-mysql, come utente/password le credenziali del database indicate sopra.
> Nota: il file delle credenziali viene generato solo quando il CMS è distribuito tramite «installazione con un clic»; se hai distribuito manualmente con docker run, consulta tu la configurazione dell'applicazione (ad es. wp-config.php di WordPress).
Cosa contiene il dettaglio di ogni applicazione
| Informazione | Descrizione |
|---|---|
| Account / password predefiniti | Account iniziale dell'applicazione (ad es. admin di Nextcloud) |
| Porta predefinita | Porta di ascolto dell'applicazione |
| Directory dati | Posizione di persistenza dei dati |
| Passi di distribuzione | Procedura completa per le applicazioni che dipendono da un database (installare il DB → creare DB e utente → configurare le variabili d'ambiente → inizializzare) |
| Avvertenze | Conflitti di porta, consumo di risorse, avvisi di sicurezza ecc. |
Gestione delle applicazioni installate
Passando a «Installate», ogni applicazione installata offre azioni in linea: installa / disinstalla / arresta / avvia / riavvia / elimina, comodo per l'operations quotidiano.
Applicazioni che dipendono da un database
Alcune applicazioni (come Nextcloud e WordPress) dipendono da MySQL/PostgreSQL. I passi di distribuzione di queste applicazioni includono automaticamente:
1. Distribuire prima il database (MySQL/MariaDB/PostgreSQL)
2. Creare database e utente
3. Configurare le variabili d'ambiente dell'applicazione (indirizzo del database, account, password)
4. Inizializzare l'applicazione
Il pannello concatena questi passi: tu devi solo compilare le informazioni chiave come la password, seguendo le indicazioni.
Supporto a più distribuzioni
I comandi di installazione del Catalogo app si adattano automaticamente al gestore di pacchetti del server di destinazione, senza scelta manuale:
| Distribuzione | Gestore di pacchetti | Modalità di adattamento |
|---|---|---|
| Debian / Ubuntu | apt | comando nativo |
| Fedora / Rocky / CentOS / RHEL | dnf / yum | mappatura automatica (apt-get → dnf/yum) |
| Alpine | apk | mappatura automatica |
Allo stesso tempo gestisce automaticamente le differenze nei nomi dei pacchetti (ad es. apache2 → httpd, apache2-utils → httpd-tools) e nei nomi dei servizi (apache2.service → httpd.service).
> ⚠️ Attenzione: alcune applicazioni dipendono da modalità di installazione specifiche della distribuzione (ad es. ufw è esclusivo di Ubuntu, il repository deb.nodesource di Node.js esiste solo su Debian/Ubuntu) e su Fedora/Rocky potrebbero non installarsi. In caso di errore, il pannello mostra il messaggio di errore così com'è.
Avvertenze
1. Per distribuire un'applicazione il server di destinazione deve avere Docker già installato.
2. I segnaposto delle password sono chiaramente indicati (ad es. «<la-tua-password-del-database>»): sostituiscili con una tua password robusta.
3. Le applicazioni si legano per impostazione predefinita alle porte del server di destinazione; se quel server non ha IP pubblico (server NAT/di tunnel), per accedervi dall'esterno servono Tunnel di porta o Inoltro di porta.
4. Distribuzioni troppo vecchie (come Fedora 32 e altre versioni EOL): i repository non sono più mantenuti, l'installazione può andare in timeout o fallire; conviene aggiornare a una versione supportata.