FASTPANELWIKI

Avvio rapido

Come aggiornare FASTPANEL®

In questa pagina

Per impostazione predefinita, FASTPANEL® viene aggiornato automaticamente in base alla pianificazione impostata dallo scheduler Cron. Non è necessario eseguire alcuna azione aggiuntiva affinché il pannello venga aggiornato.

Aggiornamento manuale

Se per qualche motivo è necessario forzare un aggiornamento, eseguire il seguente comando della console tramite SSH:

/usr/local/fastpanel2/app/updater

Verrà avviato un file eseguibile che aggiornerà FASTPANEL® all'ultima versione.

Configurare le chiavi SSH

In questa pagina

In FASTPANEL® puoi aggiungere chiavi SSH per gli utenti per semplificare e rendere più sicuro l'accesso al server.

Le chiavi SSH (Public Key Authentication) offrono un modo sicuro e pratico per accedere a un server senza usare password, basato su una coppia di chiavi private e pubbliche. Invece di inserire una password ogni volta, il client usa la chiave privata, mentre il server la verifica rispetto alla chiave pubblica, migliorando sia la sicurezza sia la facilità d'uso.

Creazione della coppia di chiavi

avviso

Conserva la tua chiave privata in un luogo sicuro e non condividerla mai con nessuno.

Per prima cosa, devi generare la tua coppia di chiavi privata e pubblica.

macOS / Linux

Apri un terminale ed esegui:

ssh-keygen

Premi Enter per accettare il percorso predefinito del file e imposta una passphrase se necessario.
Le tue chiavi verranno salvate in ~/.ssh/id_ed25519 (privata) e ~/.ssh/id_ed25519.pub (pubblica).

Windows

OpenSSH

Apri PowerShell ed esegui:

ssh-keygen

Premi Enter per accettare il percorso predefinito del file e imposta una passphrase se necessario.
Le tue chiavi verranno salvate in C:\Users\YourUser\.ssh\id_ed25519 (privata) e C:\Users\YourUser\.ssh\id_ed25519.pub (pubblica).

PuTTYgen
  1. Scarica e installa PuTTYgen.
  2. Avvia PuTTYgen e fai clic su "Generate".
  1. Sposta il cursore del mouse in modo casuale sulla finestra di PuTTYgen finché il processo di generazione non è terminato.
  2. Salva la chiave privata (.ppk) e copia il testo della chiave pubblica.

Aggiungere una chiave pubblica al pannello

Apri FASTPANEL® e fai clic sul tuo nome utente nell'angolo in alto a destra dello schermo. Quindi seleziona "SSH Keys".

Fai clic sul pulsante "Add SSH key".

  • Nel primo campo, incolla la tua chiave pubblica (di solito inizia con ssh-ed25519 o ssh-rsa, a seconda dell'algoritmo scelto) dalla sezione precedente.

  • Nel secondo campo, puoi aggiungere una descrizione per distinguere la chiave.

Dopo di che, potrai connetterti al tuo server tramite SSH usando le credenziali del proprietario del sito, senza inserire una password.

Abilitare l'accesso SSH e gestire le chiavi esistenti

Se hai bisogno di gestire le chiavi di altri utenti o rimuovere le chiavi per l'utente corrente, vai su "Management" → "Users". Fai clic sui tre puntini accanto all'utente di cui vuoi gestire le chiavi.

Nella sezione aperta puoi:

  1. Aggiungere una nuova chiave.
  2. Eliminare una chiave esistente.
  3. Abilitare o disabilitare l'accesso SSH per l'utente.

Configurazione NAT

In questa pagina

Il NAT è un meccanismo di traduzione degli indirizzi di rete che traduce gli indirizzi IP dei pacchetti. Il NAT consente ai server su una rete locale di comunicare con i server su una rete esterna.

Se il server con FASTPANEL® ha un indirizzo IP privato e sulla rete locale è configurato il NAT, per garantire il corretto funzionamento dei domini DNS, dei siti web e dei servizi di posta, è necessario configurare la mappatura degli indirizzi IP privato e pubblico del server.

Per impostare la mappatura degli indirizzi IP:

  1. Apri il menu laterale sinistro → "Gestione IP" → "Mappatura IP"

  2. Fai clic su "Aggiungi"

  3. Per gli indirizzi IP locali, inserisci il corrispondente indirizzo IP pubblico

  4. Fai clic su "Salva"

Dopo aver configurato la mappatura degli indirizzi, gli indirizzi IP interni verranno convertiti in indirizzi IP esterni durante la creazione dei domini DNS.

Elenco delle porte per il forwarding

Per il corretto funzionamento dei servizi principali, è necessario configurare il forwarding per le seguenti porte:

  • FASTPANEL: 8888, 7777

  • FTP: 21, 65000-65500

  • SSH: 22

  • SFTP: 2222

  • HTTP, HTTPS: 80, 443

  • IMAP, IMAPS: 143, 993

  • POP3, POP3S: 110, 995

  • SMTP, SMTPS: 25, 587, 465

  • DNS(se viene utilizzato bind9): 53

Altri servizi, come MySQL, in genere vengono eseguiti solo su IP locali e non richiedono accesso pubblico.

Come disinstallare FASTPANEL®

importante

Se desideri passare da FASTPANEL® a un pannello di controllo diverso, l'unico modo per procedere è reinstallare il sistema operativo (OS). Prima di farlo, è fondamentale eseguire il backup di tutti i dati importanti su un archivio esterno. Questo ti permetterà di ripristinare i tuoi progetti dopo la reinstallazione.

FASTPANEL® può essere disinstallato senza interrompere il funzionamento dei siti. Tuttavia, ciò comporterà conseguenze come:

  • Interruzione del rinnovo automatico dei certificati SSL di Let's Encrypt emessi tramite FASTPANEL®.
  • Disattivazione delle attività di backup precedentemente configurate in FASTPANEL®.
  • Potrai modificare le impostazioni dei siti, creare e modificare utenti, caselle di posta, account FTP/SFTP, ecc. solo tramite configurazione manuale.

Se sei certo di voler disinstallare FASTPANEL® e comprendi pienamente le conseguenze, puoi farlo eseguendo i seguenti comandi nella console del server come root:

Debian/Ubuntu:

apt-get remove fastpanel2 fastpanel2-nginx

CentOS/AlmaLinux/RockyLinux:

yum remove fastpanel2 fastpanel2-nginx

Se in futuro avrai bisogno di ripristinare il funzionamento di FASTPANEL®, potrai reinstallare i pacchetti precedentemente disinstallati. Tuttavia, non vi è alcuna garanzia che il pannello di controllo riprenda a funzionare correttamente dopo questa operazione.
Per installare i pacchetti di FASTPANEL®, utilizza i comandi:

Debian/Ubuntu:

apt-get update
apt-get install fastpanel2 fastpanel2-nginx
/usr/local/fastpanel2/updater

CentOS/AlmaLinux/RockyLinux:

yum makecache
yum install fastpanel2 fastpanel2-nginx
/usr/local/fastpanel2/updater

Impostare l'indirizzo del pannello

In questa pagina

Introduzione

Oltre all'accesso standard a FASTPANEL® tramite indirizzo IP, puoi anche impostare qualsiasi dominio o sottodominio che punti al tuo server con FASTPANEL® installato come indirizzo del pannello.

Per iniziare, assicurati che esista un record A valido per il nome di dominio che desideri utilizzare come indirizzo del pannello. Puoi verificarlo usando i comandi:

Windows:

nslookup example.com

Linux/MacOS:

host example.com

Se il record A è corretto, vedrai il seguente output:

example.com has address $IP_ADDRESS

Dove al posto di $IP_ADDRESS deve essere specificato l'indirizzo IP del tuo server. Se è presente un indirizzo diverso, correggilo nell'account del tuo provider DNS e attendi l'aggiornamento della cache DNS. Questo processo richiede solitamente da 20 a 60 minuti.

Impostazione dell'indirizzo del pannello

Per impostare uno dei tuoi domini o sottodomini come indirizzo del pannello, vai su “Settings” -> “Main” -> “Panel addresses” e fai clic sul pulsante blu “Add address”.

Nella finestra successiva, aggiungi il dominio che desideri utilizzare come indirizzo del pannello e fai clic su "Save".

Dopodiché FASTPANEL® sarà disponibile all'indirizzo:

example.com:8888

Accesso diretto

Per configurare l'accesso diretto senza specificare la porta 8888, fai clic sull'icona della matita accanto all'indirizzo del pannello impostato:

Quindi attiva la casella di controllo "Direct access" e seleziona gli indirizzi IP che desideri utilizzare per questo nome di dominio:

E fai clic su "Save".

Certificato SSL per l'indirizzo del pannello

Per l'indirizzo del pannello, puoi emettere un certificato SSL gratuito di Let's Encrypt, un certificato a pagamento esistente o un certificato autofirmato. Per farlo, fai clic sul testo blu "SSL" accanto all'indirizzo del pannello:

Quindi, nella finestra che si apre, seleziona il tipo di certificato:

E fai clic su "Save".

Possibili problemi

Tieni presente che è meglio utilizzare come indirizzo di FASTPANEL® un dominio che non sia dietro Cloudflare, poiché ciò può causare problemi con FASTPANEL® quando vi si accede tramite nome di dominio a causa di limitazioni lato Cloudflare.

Se si verificano problemi durante l'utilizzo di tale dominio, verifica se si riproducono anche quando accedi al pannello tramite indirizzo IP. In caso contrario, disabilita il proxy per il nome di dominio utilizzato come indirizzo di FASTPANEL® nella sezione DNS di Cloudflare.

Come installare FASTPANEL®

importante

Il pannello può essere installato solo su un sistema operativo pulito, senza alcun software preinstallato. L'installazione su un server con software preconfigurato non è possibile!

Per installare FASTPANEL®, è necessario un server virtuale (VPS) o dedicato con accesso root.

L'hardware del server deve soddisfare i requisiti minimi di sistema:

RAM: 1G
Spazio libero: 5Gb
CPU: 1 core, 1 Ghz

I sistemi operativi supportati sono i seguenti (solo architettura a 64 bit):

Debian: 9, 10, 11, 12

Ubuntu: 18.04, 20.04, 22.04, 24.04

CentOS: 7

AlmaLinux: 8

Rocky Linux: 8


Dopo aver installato uno dei sistemi operativi supportati, è necessario eseguire le seguenti operazioni:

  1. Connettiti al server tramite SSH utilizzando la password di root:

    ssh root@your.server
  2. Installa gli ultimi aggiornamenti del sistema operativo e l'utilità wget, necessaria per eseguire lo script di installazione del pannello di controllo. Dopo di che, riavvia il server:

    Debian / Ubuntu:

    apt-get update && apt-get upgrade && apt-get install ca-certificates wget && reboot

    CentOS / AlmaLinux / Rocky Linux:

    yum makecache && yum update && yum install ca-certificates wget && reboot
  3. Dopo il riavvio del server, avvia il processo di installazione di FASTPANEL® eseguendo il seguente comando:

    suggerimento

    Durante l'installazione del pannello, puoi scegliere la versione di MySQL. Puoi saperne di più in questo articolo.

    wget https://repo.fastpanel.direct/install_fastpanel.sh -O - | bash -
  4. Dopo l'installazione di FASTPANEL®, riceverai un messaggio con i dati di accesso:

    Congratulazioni! FASTPANEL installato correttamente e disponibile per te all'indirizzo https://1.2.3.4:8888
    Login: fastuser
    Password: password

FASTPANEL Extended è abilitata per impostazione predefinita per tutti gli utenti. Non è necessario attivare una licenza.

Come reimpostare la password

In questa pagina

Introduzione

FASTPANEL® offre due modi diversi per cambiare la password di qualsiasi utente:

Cambiare la password tramite FASTPANEL stesso

Questo metodo è adatto se la password precedente è nota (l'accesso al pannello non è stato perso).

Per usare questa opzione, devi accedere a FASTPANEL® e andare al menu "Management" → "Users", quindi fare clic su "Change Password"

Nella finestra modale che si apre, inserisci la tua vecchia password, quindi inseriscine una nuova due volte e, dopo, fai clic sul pulsante "Save"

Cambiare la password tramite SSH

Questo metodo è adatto se la password precedente è sconosciuta (l'accesso al pannello è perso). Per cambiare la password tramite SSH, la vecchia password non è richiesta.

Per usare questa opzione devi:

  1. Connettiti al tuo server tramite SSH usando la tua root-password:

    ssh root@your.server
  2. Usa un comando passwd user_name

    Ad esempio, per cambiare la password dell'utente chiamato fastuser, il comando dovrebbe essere:

    passwd fastuser

    Dopo aver eseguito il comando, ti verrà richiesto di inserire e confermare una nuova password

    nota

    nessun carattere verrà visualizzato sullo schermo durante l'inserimento e la conferma di una nuova password.

  3. Se il cambio password è andato a buon fine, riceverai il seguente messaggio:

    passwd: password updated successfully

Dopo di che potrai accedere al pannello usando la tua nuova password