SSH-toegang (incl. Bestands overdracht)

Ubuntu 22.04 LTS draait op elke GPU Server Blib als volledig geïsoleerde instantie met volledige root-toegang. Je kunt rechtstreeks toegang krijgen tot je server via SSH met de inloggegevens die beschikbaar zijn in het beheerinterface.

Aandacht: De SSH-poort is uniek voor elke machine; zorg er dus voor dat u de juiste poort gebruikt. Het is niet standaard 22, maar meestal tussen 10000 en 59999.

LET OP MET UFW ⚠️ Je hoeft geen firewall (UFW) geactiveerd te hebben op je GPU Server Blib! Lees er meer over hier: 🛡️ Ingebouwde beveiliging voor je GPU Server. AI Agents kunnen adviseren om de server te beveiligen met hulpmiddelen die typisch worden gebruikt bij webserverscenario's. Doe dat niet. Een actieve UFW zal je toegang tot de server blokkeren.


1. SSH-inloggegevens ophalen

Om toegang te krijgen tot uw server, opent u de Trooper.AI Beheerinterface en ga naar uw actieve Blib-instance.

Klik op de «Acties»-knop om de SSH-aansluitingsdetails weer te geven:

Use Actions button to reveal SSH credentials
Gebruik de knop 'Acties' om de SSH-gegevens te tonen

U ziet de volgende informatie:

  • Hostnaam (bijv. connect01.trooper.ai)
  • SSH-port
  • Gebruikersnaam
  • Wachtwoord (klik op het oogpictogram om te tonen)

SSH Credentials revealed
SSH-gegevens onthuld

Kopieerknoppen gebruiken om de waarden direct in uw terminal te plakken.


2. De SSH-verbinding tot stand brengen

Gebruik een standaard SSH-commando om verbinding te maken met uw server:

bash
ssh USERNAME@HOSTNAME -p PORT

Vervang USERNAME, HOSTNAMEen PORT met de waarden van het dashboard.

Voorbeeld:

bash
ssh trooperai@connect01.trooper.ai -p 15012

Als dit uw eerste verbinding is, kan uw terminal u vragen om de vingerafdruk van de server te bevestigen:

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

ja en druk op Enter om door te gaan.


3. Verbindingsbevestiging

Na een succesvolle verbinding ziet u een standaard shell prompt:

Terminal connection example
Voorbeeld terminalverbinding

Dit geeft aan dat u nu bent ingelogd op uw GPU Server Blib.


4. Rootrechten gebruiken

Hoewel u bent ingelogd als een niet-root gebruiker om veiligheidsredenen, heeft uw account volledige privileges. U kunt administratieve taken uitvoeren met sudo.

Voorbeelden:

bash
sudo apt update
sudo fdisk -l

De eerste keer dat je het gebruikt sudowordt u gevraagd het verstrekte wachtwoord in te voeren.


5. Notities

  • Uw SSH-verbinding is beveiligd en geïsoleerd.
  • Alle geïnstalleerde templates (bijv. Jupyter, ComfyUI) blijven parallel actief en zijn toegankelijk via de toegewezen publieke poorten.
  • Voor geavanceerde provisioning of automatisering kunt u deze toegang integreren met rsync, scp, ofwel configuratietools zoals Ansible.

6. Bestanden overzetten met SFTP

Het veilig overzetten van bestanden naar en van uw GPU Server Blib is eenvoudig te realiseren met SFTP (Secure File Transfer Protocol). SFTP biedt een versleutelde verbinding via SSH, waardoor de vertrouwelijkheid en integriteit van uw gegevens tijdens de overdracht wordt gewaarborgd. Dit is de aanbevolen methode voor het overzetten van datasets, modellen, scripts of andere bestanden die voor uw projecten vereist zijn.

Om verbinding te maken met behulp van SFTP, heb je een SFTP-client nodig. Populaire opties zijn onder andere FileZilla, Cyberduck (ons favoriet) en WinSCP. Deze clients werken vergelijkbaar als traditionele bestandbeheerders, waardoor je bestanden kunt doorzoeken en beheren op zowel jouw lokale computer als de externe server.

Configuratie:

  1. Host: Voer de hostnaam van uw GPU-server Blib in (te vinden in het Trooper.AI Beheerinterface).
  2. Poort: Gebruik het SSH-poortnummer dat in de beheerinterface wordt verstrekt (het is een 5-cijferig nummer!)
  3. Gebruikersnaam: Voer de SSH-gebruikersnaam in die in het beheerinterface wordt verstrekt (het deel voor de @ in de SSH-aanmeldopdracht).
  4. Wachtwoord: Voer het SSH-wachtwoord in dat aan uw account is gekoppeld.

Zodra verbonden, kunt u naadloos bestanden uploaden en downloaden tussen uw lokale machine en de Blib. De SFTP-interface toont het bestandssysteem van uw server als een externe locatie, waardoor u bestanden kunt navigeren en beheren zoals u dat op uw lokale computer zou doen.

Configure with SSH username, password and port
Configureren met SSH gebruikersnaam, wachtwoord en poort

Work with your files like any other network location
Werk met uw bestanden zoals elke andere netwerklocatie

SFTP is een veilige en betrouwbare methode voor het beheren van bestanden op uw Trooper.AI GPU Server Blib, waardoor efficiënte dataoverdracht en projectontwikkeling mogelijk worden.


7. SSH Probleemoplossing

Toegangsproblemen na herstart

Indien u na een herstart problemen ondervindt met de toegang, controleer dan eerst uw SSH-configuratie en firewallspecificaties binnen het Jupyter Notebook-terminal. Een lokale firewall (UFW) is over het algemeen niet vereist en kan mogelijk interfereren met de toegang. Lees meer hierover: 🛡️ Ingebouwde Firewall voor uw GPU-server. Als het probleem aanhoudt, schakelt u alstublieft de firewall van uw server uit of neemt u contact op met ons ondersteuningsteam voor hulp: Contactgegevens Ondersteuning

Wachtwoordgebaseerde SSH-toegang

Als u een nieuwere Linux-distributie op uw lokale machine gebruikt (bijv. Ubuntu 24.04+), kan uw SSH-client standaard overschakelen op public key authenticatie, zelfs als u een wachtwoord probeert te gebruiken.

Als uw wachtwoord direct lijkt te worden afgewezen, probeer dan expliciet gedwongen wachtwoordauthenticatie:

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

Vervang USERNAME, HOSTNAMEen PORT met uw opgegeven waarden.

Dit vertelt SSH om het zoeken naar sleutels over te slaan en direct de wachtwoordmethode te gebruiken.

Bekende host-problemen na een bevroren status of migratie

Na het herstellen van een bevroren instantie of het migreren van een Blib, kunt u mogelijk een WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! Fout bij poging tot verbinding via SSH. Dit gebeurt omdat de SSH-sleutel van de server is gewijzigd en uw lokale machine de oude sleutel onthoudt.

Om dit op te lossen:

  1. Verwijder de oude sleutel uit je known_hosts-bestand:

    Het known_hosts-bestand bevat de SSH-sleutels van servers waarmee je eerder verbinding hebt gemaakt. Je moet het item voor de Trooper.AI-server verwijderen. Het bestand bevindt zich meestal op ~/.ssh/known_hosts onder Linux/macOS en %USERPROFILE%\.ssh\known_hosts onder Windows.

    • Linux/macOS:
    • Open het bestand in een teksteditor en zoek naar de regel die begint met de hostnaam of IP-adres van jouw Trooper.AI-server. Verwijder die hele regel.
    • Windows:
    • Open het bestand in een teksteditor (zoals Notepad) en volg dezelfde instructies als bij Linux/macOS.
  2. Alternatief kunt u ssh-keygen -R gebruiken:

    U kunt het commando ssh-keygen gebruiken om de sleutel direct te verwijderen:

    bash
    ssh-keygen -R HOSTNAME
    











    Vervang HOSTNAME

    door de hostnaam van uw Trooper.AI-server (bijv.: connect01.trooper.ai).
  3. Herverbinden:

    Na verwijdering van de oude sleutel, probeer je opnieuw verbinding te maken met de server via SSH. Je zult worden gevraagd om de nieuwe sleutel te verifiëren. Typ yes en druk op Enter.

Dit zal uw known_hosts bestand met de nieuwe sleutel, en je zou zonder verdere waarschuwingen verbinding moeten kunnen maken.

Voorkom SSH-verbreeking

Ervaring met wegvallende SSH-verbindingen, vooral op Windows? Houd uw verbinding in leven met dit commando:

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

Dit stuurt een keep-alive pakket elke 30 seconden, en zal het maximaal 4 keer proberen als er geen reactie wordt ontvangen. Zeg vaarwel tegen frustrerende disconnecties! 🚀

Onstabiele netwerksituaties: SSH-verbindingen kunnen broos zijn bij onstabiele netwerken. We raden sterk aan een stabiele privé WiFi of kabelgebonden Ethernet-verbinding te gebruiken. Mobiel 📱, VPN, openbaar WiFi (zoals op een Airbnb, café of universiteit), of Skylink-verbindingen kunnen intermitterende connectiviteitsproblemen veroorzaken. Gebruik je deze verbindingen, zorg er dan voor dat uw netwerk herstelpogingen ondersteunt.

Lees ook meer over HTTP(S)-toegang en Over SSL-certificaten.

Hulp bij de eerste verbinding

Bij problemen met de toegang kunt u contact opnemen met support@trooper.ai of sneller via WhatsApp: +4961269289991.