Documentazione

Avvio rapido + descrizione di ogni funzione per ogni sezione e dispositivo (in continuo aggiornamento)

Domande frequenti FAQ

Questo documento raccoglie i problemi più frequenti nell'uso del pannello e come diagnosticarli.

Installazione e accesso

D: Quali requisiti servono per installare il pannello?

Un server Linux con IP pubblico (si consigliano distribuzioni diffuse come Debian / Ubuntu / CentOS), con almeno 512MB di memoria per funzionare fluido. I server gestiti non richiedono l'installazione di nulla: basta che sia possibile connettersi via SSH.

D: Quali sono utente e password predefiniti?

Account predefinito admin, password 123456. Cambiala subito dopo il primo accesso (icona utente in alto a destra nel pannello → Impostazioni utente).

D: Ho dimenticato la password di accesso, cosa faccio?

Se l'hai modificata e non la ricordi, puoi reimpostarla sul server del pannello. Esegui il comando seguente per riportarla a quella predefinita (o per impostarne una nuova):

# Entra nella directory di installazione del pannello e usa lo script integrato per reimpostare la password
cd /opt/ssh-everywhere
python3 -c "from app import reset_password; reset_password('nuova-password')"

> Il nome esatto dello script può variare con le versioni; in alternativa puoi modificare direttamente la tabella users del database data/ssheverywhere.db.

D: Come si cambia la porta del pannello (5501)?

Modifica Environment=PORT=5501 nel servizio systemd, poi ricarica:

systemctl edit ssh-everywhere.service
# Aggiungi o modifica: Environment=PORT=tua-porta
systemctl daemon-reload && systemctl restart ssh-everywhere.service

Dopo la modifica ricordati di aprire la nuova porta nel firewall cloud/security group.

D: Non riesco ad accedere al pannello (porta 5501)?

Diagnostica in ordine:

1. Verifica che il servizio del pannello sia in esecuzione: systemctl status ssh-everywhere.service

2. Controlla che il firewall cloud/security group del server del pannello consenta la 5501 (è la causa più comune)

3. Verifica che l'indirizzo di accesso sia http://IP-pubblico-del-server:5501 (non https, a meno che tu non abbia configurato un reverse proxy)

Server

D: Il server risulta «offline», cosa fare?

«Offline» significa solo che il pannello non riesce a connettersi via SSH, non che il server sia caduto. Diagnostica in ordine:

1. Verifica che il server sia acceso: controlla lo stato di alimentazione nella console del provider

2. Prova la raggiungibilità della porta SSH: dal server del pannello esegui nc -zv <IP-destinazione> <porta> per vedere se la porta risponde

3. Controlla firewall/security group: il firewall cloud/security group del server di destinazione consente la porta SSH?

4. Per i server NAT controlla la mappatura di porta: verifica che la mappatura NAT esista ancora e che l'IP interno di destinazione sia corretto

5. Controlla la whitelist degli IP di origine: alcuni provider limitano la porta SSH per IP di origine: va aggiunto in whitelist l'IP del server del pannello

6. Verifica utente e password: utente, password/chiave privata sono corretti?

D: Non riesco a connettermi quando aggiungo un server?

  • Verifica che porta SSH, utente e password siano corretti
  • Verifica che sshd sia in esecuzione sul server di destinazione
  • Verifica che il firewall consenta la porta SSH
  • I grandi cloud (Tencent Cloud/Alibaba Cloud) disabilitano root per impostazione predefinita: accedi con un utente normale (ad es. ubuntu)

D: Non riesco a connettermi a un server NAT (porta diversa dalla 22)?

La mappatura di porta del server NAT deve essere raggiungibile dalla rete in cui si trova il server del pannello. Cause comuni:

  • Mappatura di porta non più valida (controlla/ricreala nella console del provider)
  • Il provider ha una whitelist per IP di origine (aggiungi in whitelist l'IP del server del pannello)
  • L'IP/porta interno di destinazione della mappatura è sbagliato

Tunnel di porta / inoltro di porta

D: Il tunnel di porta risulta «offline»?

  • Il tunnel dipende dall'Agent online. Se l'Agent è offline (dispositivo spento, rete assente, Agent fermo) il tunnel si interrompe
  • Dopo il riavvio del servizio del pannello il tunnel si ripristina automaticamente alla riconnessione dell'Agent: basta attendere un momento
  • Verifica che il firewall cloud del server del pannello consenta la porta in ascolto

D: L'inoltro di una porta diversa dalla 22 non funziona?

Per inoltrare una porta diversa da SSH (ad es. 9117) il server in tunnel deve avere la nuova versione dell'Agent (le versioni vecchie supportano solo la 22). Reinstalla l'Agent.

D: Ho creato un inoltro di porta ma non funziona?

L'inoltro di porta tradizionale va eseguito sulla macchina del server con IP pubblico dedicato. Controlla:

1. Il server di destinazione o il firewall intermedio consente la porta di destinazione?

2. L'IP di destinazione indicato è un indirizzo realmente raggiungibile?

3. Il security group cloud blocca la porta in ascolto?

D: Qual è la differenza tra tunnel di porta e inoltro di porta?

  • Tunnel di porta: per dispositivi senza IP pubblico, passa dal tunnel inverso e apre una porta pubblica sul server del pannello.
  • Inoltro di porta: per server con IP pubblico, passa dal DNAT del firewall di sistema ed è eseguito sulla macchina di destinazione.

Vedi Tunnel di porta e Inoltro di porta.

Docker / installazione delle applicazioni

D: Cosa fare se l'installazione da Catalogo app/Docker fallisce?

Il pannello mostra il messaggio di errore così com'è (non dichiara falsi successi). Cause comuni:

1. Distribuzione troppo vecchia: versioni EOL come Fedora 32, i cui repository non sono più mantenuti; l'installazione va in timeout o fallisce. Conviene aggiornare il sistema.

2. Rete non raggiungibile: il repository ufficiale Docker (get.docker.com / download.docker.com) può essere inaccessibile in certi ambienti di rete (ad es. server NAT in Cina continentale). In tal caso configura un mirror Docker nazionale, oppure usa la funzione «Cambio dei mirror» per passare al mirror Alibaba Cloud.

3. Nomi di pacchetti diversi: alcune applicazioni (come ufw o deb.nodesource di Node.js) dipendono da distribuzioni specifiche e su sistemi non Debian/Ubuntu potrebbero non installarsi; il messaggio di errore lo indica chiaramente.

D: Su un server in Cina il download delle immagini Docker è lento o va in timeout?

È un problema di rete, non del pannello. Si consiglia di configurare un acceleratore di mirror Docker (acceleratori pubblici come docker.1ms.run / docker.m.daocloud.io), oppure di eseguire prima sul server:

# Riferimento: configurare l'acceleratore personale Alibaba Cloud (sostituisci con il tuo indirizzo acceleratore)
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{ "registry-mirrors": ["https://il-tuo-indirizzo-acceleratore"] }
EOF
sudo systemctl restart docker

Tecniche generali di diagnostica

1. Prima prova se la porta risponde, poi controlla utente e password: nc -zv <IP> <porta>

2. Confronta con altri server: se i server dello stesso tipo si connettono e solo questo no, il problema è specifico di questa macchina (firewall/mappatura/whitelist)

3. Guarda i log: i log del pannello sono in service.log; i log del tunnel/Agent aiutano a individuare i problemi di connessione