Wolkra

Docs

Verbinden met SSH

Maak verbinding met een Wolkra-server met SSH-sleutels of het rootwachtwoord uit de e-mail, vanaf Linux, macOS of Windows, en kom weer binnen via de browserconsole of rescue mode.

Bijgewerkt 3 min. leestijd

Om verbinding te maken, voer je ssh root@<server-ip> uit met de SSH-sleutel die je bij het aanmaken van de server hebt gekozen, of met het rootwachtwoord dat naar je e-mail is gestuurd. Is SSH niet bereikbaar, gebruik dan de browserconsole of rescue mode vanuit het serveroverzicht in de console.

Het adres vinden

Open de server in de console. Het overzicht toont het publieke IPv4-adres (als de server er een heeft) en het IPv6-adres. Servers in een privénetwerk hebben alleen privéadressen; zie verderop het deel over servers zonder publiek IP.

Verbinden vanaf Linux of macOS

bash
ssh [email protected]          # example IPv4
ssh root@2001:db8::10          # example IPv6

Is je sleutel niet de standaard ~/.ssh/id_ed25519, geef hem dan expliciet op:

bash
ssh -i ~/.ssh/wolkra_ed25519 [email protected]

Bevestig bij de eerste verbinding de fingerprint van de host met yes.

Verbinden vanaf Windows

Windows 10 en 11 hebben OpenSSH ingebouwd. In PowerShell:

powershell
ssh [email protected]

Met PuTTY vul je het adres in als Host Name, laad je je .ppk-sleutel onder Connection → SSH → Auth → Credentials en log je in als root.

Met een rootwachtwoord

Heb je geen SSH-sleutel gekozen, dan komt het rootwachtwoord per e-mail. Log in en wijzig het meteen:

bash
passwd

Nog beter: voeg je sleutel toe en zet inloggen met een wachtwoord uit. De handleiding over SSH-sleutels laat zien hoe.

Een snelkoppeling opslaan

Voeg de server toe aan ~/.ssh/config:

text
Host web-1
  HostName 203.0.113.10
  User root
  IdentityFile ~/.ssh/id_ed25519

Nu is ssh web-1 genoeg.

Servers zonder publiek IP bereiken

Servers die alleen in een privénetwerk staan, hebben geen publiek adres. Maak verbinding via een server die er wel een heeft, een zogeheten jump host:

bash
ssh -J [email protected] [email protected]     # example addresses

Of in ~/.ssh/config:

text
Host db-1
  HostName 10.0.0.5
  User root
  ProxyJump web-1

Een WireGuard VPN naar het privénetwerk is voor teams ook een goede optie.

Browserconsole

Open de server en kies Console. Die toont het scherm van de server, alsof er een monitor op is aangesloten, en werkt zelfs als het netwerk of SSH kapot is. Log in met een gebruiker die een wachtwoord heeft. Heeft root alleen een sleutel, stel dan eerst een wachtwoord in zolang je nog SSH-toegang hebt:

bash
passwd

Gebruik de console om een firewallregel, een fout in de SSH-configuratie of een netwerkinstelling te herstellen.

Rescue mode

Start het systeem niet meer op, kies dan Rescue in het serveroverzicht. De server herstart in een klein rescuesysteem. Log in zoals de console aangeeft, mount daarna je schijf en repareer die:

bash
lsblk                       # find the system disk and its partitions
mount /dev/vda1 /mnt        # device names vary, check lsblk first

Ben je klaar, unmount dan, verlaat rescue mode en start normaal opnieuw op.

Problemen oplossen

Symptoom Wat je controleert
Connection timed out Draait de server? Is poort 22 toegestaan in UFW en in de firewall? Klopt het IP?
Connection refused SSH-service gestopt of op een andere poort: controleer in de console met systemctl status ssh
Permission denied (publickey) Juiste gebruiker en sleutel? Rechten 700 op ~/.ssh en 600 op authorized_keys?
REMOTE HOST IDENTIFICATION HAS CHANGED De server is opnieuw opgebouwd: ssh-keygen -R 203.0.113.10

Voer ssh -v uit voor een gedetailleerd log. Kom je er nog steeds niet uit? Open een ticket in de console.

Volgende stap: hard de server met zo beveilig je een Ubuntu-server.

Veelgestelde vragen

Welke gebruikersnaam gebruik ik?

root voor een nieuwe server. Bij apps met één klik geldt hetzelfde, tenzij de notities van de app iets anders zeggen. Maak daarna je eigen sudo-gebruiker aan.

Ik heb geen SSH-sleutel gekozen. Hoe log ik in?

Er wordt een rootwachtwoord naar je e-mailadres gestuurd. Log daarmee in, wijzig het met passwd en voeg daarna een sleutel toe.

SSH zegt permission denied. Wat nu?

Controleer de gebruiker, de sleutel en het IP. Lukt het nog steeds niet, open dan de browserconsole vanuit het serveroverzicht en controleer ~/.ssh/authorized_keys en de SSH-configuratie.

Kan ik vanuit de console een sleutel toevoegen aan een bestaande server?

Opgeslagen sleutels worden toegevoegd wanneer een server wordt aangemaakt. Bij een draaiende server voeg je de publieke sleutel zelf toe aan ~/.ssh/authorized_keys, bijvoorbeeld via de browserconsole.