Accesso SSH (inclusa la trasferimento file)

Ogni GPU Server Blib esegue un'istanza completamente isolata di Ubuntu 22.04 LTS con controllo a livello root. Può accedere direttamente al Suo server tramite SSH utilizzando le credenziali fornite nell'interfaccia di gestione.

Attenzione: La porta SSH è unica per ogni macchina, quindi assicuri di utilizzare la corretta porta SSH. Non è 22, solitamente si trova tra 10000 e 59999.

ATTENZIONE UFW 🚨 Non è necessario attivare un firewall (UFW) sulla Sua GPU Server Blib! Legga di più qui: 🛡️ Firewall di livello rete personalizzabile di Trooper.AI Gli AI Agents potrebbero suggerirLe di proteggere il server con strumenti tipicamente utilizzati in scenari di webserver. Non lo faccia. Un UFW attivo bloccherà l’accesso al Suo server.


1. Recupero delle credenziali SSH

Per accedere alla Sua macchina, apra il Trooper.AI Management Interface e navighi verso l'istanza Blib attiva.

Fai clic sul pulsante «Actions» per visualizzare i dettagli della connessione SSH:

Use Actions button to reveal SSH credentials
Utilizzi il pulsante Actions per visualizzare le credenziali SSH

Troverà le seguenti informazioni:

  • Nome host (es. connect01.trooper.ai)
  • Porta SSH
  • Nome utente
  • Password (fare clic sull'icona eye icon per visualizzare)

SSH Credentials revealed
Credenziali SSH visualizzate

Modificare la password SSH del Suo GPU Server Blib potrebbe interrompere i template preinstallati, poiché questi si basano sulle credenziali di default. Assicuri di conservare la password originale per mantenere la funzionalità su tutte le applicazioni configurate.

Desidera utilizzare le chiavi SSH? Installi il template Security Tools by Trooper.AI per configurare l'autenticazione con chiave SSH. Potrà quindi aggiungere la propria chiave pubblica per accessi sicuri, disabilitando eventualmente l'autenticazione basata sulla password o implementando fail2ban (raccomandato) per migliorare la sicurezza SSH.


2. Configurazione della connessione SSH

Utilizzi un comando SSH standard per connettersi alla Sua macchina:

bash
ssh USERNAME@HOSTNAME -p PORT

Sostituisca USERNAME, HOSTNAME, e PORT con i valori visualizzati nel cruscotto.

Esempio:

bash
ssh [email protected] -p 15012

Se è la Sua prima connessione, il terminale potrebbe chiederLe di confermare l’impronta digitale del server:

Codice
The authenticity of host 'connect01.trooper.ai (IP)' can't be established.
Are you sure you want to continue connecting (yes/no)? 

Digitare sì e premere Invio per procedere.


3. Conferma della connessione

Dopo una connessione riuscita, Lei dovrebbe vedere un prompt della shell standard:

Terminal connection example
Esempio di connessione al terminale

Questo indica che Lei è ora connesso al Suo GPU Server Blib.


4. Utilizzo dei privilegi di root

Sebbene Lei sia connesso come utente non-root per motivi di sicurezza, il Suo account è completamente privilegiato. Può eseguire compiti amministrativi utilizzando sudo.

Esempi:

bash
sudo apt update
sudo fdisk -l

La prima volta che Lei usa sudo, Le verrà richiesto di inserire la password fornita.


5. Note

  • La Sua connessione SSH è sicura e isolata.
  • Tutti i template installati (ad esempio Jupyter, ComfyUI) rimangono attivi in parallelo e accessibili tramite le porte pubbliche assegnate.
  • Per la configurazione avanzata o l'automazione, potrà integrare questo accesso con rsync, scp, o strumenti di configurazione come Ansible.

6. Trasferimento file con SFTP

Il trasferimento sicuro di file verso e dalla Sua GPU Server Blib può essere effettuato facilmente tramite SFTP (Secure File Transfer Protocol). Lo SFTP offre una connessione crittografata tramite SSH, garantendo la riservatezza e l’integrità dei Suoi dati durante il trasferimento. Questo è il metodo consigliato per trasferire dataset, modelli, script o qualsiasi altro file necessario per i Suoi progetti.

Per connettersi tramite SFTP, avrà bisogno di un client SFTP. Opzioni popolari includono FileZilla, Cyberduck (il nostro preferito), e WinSCP. Questi client operano in modo simile agli esploratori di file tradizionali, permettendole di sfogliare e gestire i file sia sulla Sua macchina locale che sul server remoto.

Configurazione:

  1. Host: Inserisca il nome host della Sua GPU Server Blib (trovato nell’interfaccia di gestione di Trooper.AI).
  2. Port: Utilizzi il numero di porta SSH fornito nell’interfaccia di gestione (è un numero a 5 cifre!).
  3. Nome utente: Inserisca il nome utente SSH fornito nell'interfaccia di gestione (la parte prima del @ nel comando di connessione SSH).
  4. Password: Inserisca la password SSH associata al Suo account.

Una volta connessa, Lei potrà caricare e scaricare file in modo fluido tra la Sua macchina locale e il Blib. L’interfaccia SFTP presenterà il sistema di file del Suo server come una posizione remota, permettendole di navigare e gestire i file proprio come farebbe sulla Sua macchina locale.

Configure with SSH username, password and port
Configuri con nome utente SSH, password e porta

Work with your files like any other network location
Lavorare con i Suoi file come con qualsiasi altra posizione di rete

Lo SFTP è un metodo sicuro e affidabile per gestire i file sul Suo Trooper.AI GPU Server Blib, consentendo trasferimenti dati efficienti e lo sviluppo di progetti.


7. Risoluzione dei problemi con l’accesso SSH

Problemi di accesso dopo il riavvio

Se riscontra problemi di accesso dopo un riavvio, verifichi prima la configurazione SSH e le impostazioni del firewall all'interno del Terminale di Jupyter Notebook. Un firewall locale (UFW) di solito non è necessario e potrebbe interferire con l’accesso. Legga di più qui: 🛡️ Firewall di livello rete personalizzabile di Trooper.AI Se il problema persiste, disabiliti il firewall del Suo server o contatti il nostro team di assistenza: Contatti Assistenza

Accesso SSH basato su password

Se sta utilizzando una distribuzione più recente di Linux sulla Sua macchina locale (ad esempio Ubuntu 24.04+), il client SSH potrebbe impostare automaticamente l'autenticazione con chiave pubblica, anche se Lei sta tentando di utilizzare una password.

Se il Suo password sembra essere rifiutato immediatamente, provi a forzare esplicitamente l'autenticazione tramite password:

bash
ssh -vvv -o PreferredAuthentications=password -o PubkeyAuthentication=no USERNAME@HOSTNAME -p PORT

Sostituisca USERNAME, HOSTNAME, e PORT con i valori forniti da Lei.

Questo indica a SSH di ignorare la ricerca delle chiavi e utilizzare direttamente il metodo di autenticazione con password.

Problemi con Known_Host dopo stato congelato o migrazione

Dopo aver ripristinato un’istanza congelata o aver migrato un Blib, potrebbe riscontrare un WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! errore durante il tentativo di connessione tramite SSH. Questo accade perché la chiave SSH del server è cambiata e la Sua macchina locale ricorda quella vecchia.

Per risolvere questo problema:

  1. Rimuova la vecchia chiave dal Suo file known_hosts:

    Il file known_hosts archivia le chiavi SSH dei server ai quali si è connessa in precedenza. Dovrà rimuovere l’entrata relativa al server Trooper.AI. Il file si trova tipicamente in ~/.ssh/known_hosts su Linux/macOS e in %USERPROFILE%\.ssh\known_hosts su Windows.

    • Linux/macOS: Apra il file con un editor di testo e cerchi la riga che inizia con l’hostname o l’indirizzo IP del Suo server Trooper.AI. Elimini quella riga intera.
    • Windows: Apra il file con un editor di testo (ad esempio Notepad) e segui le stesse istruzioni di Linux/macOS.
  2. In alternativa, utilizzi ssh-keygen -R:

    Può utilizzare il comando ssh-keygen per rimuovere direttamente la chiave:

    bash
    ssh-keygen -R HOSTNAME
    

    Sostituisca HOSTNAME con l'hostname del Suo server Trooper.AI (ad esempio, connect01.trooper.ai).

  3. Ripristina la connessione:

    Dopo aver rimosso la vecchia chiave, provi nuovamente a connettersi al server tramite SSH. Le verrà richiesto di verificare la nuova chiave. Digiti sì e prema Invio.

Questo aggiornerà il Suo known_hosts il file con la nuova chiave, e Lei dovrebbe poter connettersi senza ulteriori avvisi.

Il server entra in stato di sospensione/sleep dopo inattività

Se la Sua connessione funziona per un po’ e poi si interrompe completamente — con SSH e VNC diventati irraggiungibili — il Suo server potrebbe entrare in uno stato di sospensione / sleep state dopo un periodo di inattività. Questo accade quando è installato un ambiente desktop grafico (ad esempio GNOME, XFCE) sul server. Gli ambienti desktop attivano di default la sospensione automatica e il risparmio energetico, solitamente dopo circa ~20 minuti di inattività. Su un server GPU ciò fa addormentare l’intera macchina e interrompe ogni connessione. Per risolvere il problema:

  1. Riavviare la macchina tramite Azioni > Riavvia e riconnettersi velocemente.
  2. Disabiliti la sospensione e la gestione dell'alimentazione automatiche. Eseguire:
bash
   sudo systemctl mask sleep.target suspend.target hibernate.target hybrid-sleep.target suspend-then-hibernate.target
This prevents the server from ever suspending, regardless of desktop settings.
  1. Facoltativamente, rimuova completamente l'ambiente desktop — un GPU server non ne ha bisogno.

Nota: Un GPU Server Blib è una macchina server, non una macchina desktop. Le consigliamo di evitare del tutto ambienti desktop grafici e le loro funzionalità di gestione dell'alimentazione, poiché possono interrompere lavori in esecuzione prolungati e la connettività.

Eviti le disconnessioni SSH

Sta riscontrando interruzioni delle connessioni SSH, soprattutto su Windows? Mantenere la connessione attiva con questo comando:

bash
ssh -o ServerAliveInterval=30 -o ServerAliveCountMax=4 USERNAME@PUBLIC_HOST -p PORT

Questo invia un pacchetto di keep-alive ogni 30 secondi e riproverà fino a 4 volte se non viene ricevuta risposta. Addio alle fastidiose disconnessioni! 🚀

Situazioni di rete instabile: Le connessioni SSH possono essere fragili con reti instabili. Consigliamo vivamente una connessione stabile tramite Wi-Fi privato o Ethernet cablato. Mobile 📱, VPN, Wi-Fi pubblico (come in un Airbnb, caffè o università) o connessioni Skylink potrebbero introdurre problemi di connettività intermittenti. Se utilizza queste connessioni, assicuri che la rete supporti tentativi di riconnessione.

Per ulteriori informazioni su HTTP(S) Access e Informazioni su certificati SSL, legga di più.

Assistenza alla prima connessione

Per qualsiasi problema relativo all'accesso, La preghiamo di contattare [email protected] oppure in modo più veloce su WhatsApp: +4961269289991.