Zum Inhalt springen
Octoboard Dokumentation

Über SSH verbinden

Nutze Octoboard auf einem Linux-Server oder einem anderen Computer von diesem Computer aus, in der Desktop-App oder in einem Browser, per SSH: eine verschlüsselte Verbindung direkt zu diesem Rechner, ohne Relay oder Cloud-Dienst.

Du bist nicht sicher, ob das der richtige Weg für dich ist? Verbindungsart wählen vergleicht ihn mit den Wegen nur über den Browser, die kein SSH brauchen.

Desktop-App auf diesem Computer · Browser über eine SSH-Weiterleitung ⟷ SSH ⟷ Linux-Server oder anderer Computer

Neu hier?
  • Host: der Rechner, auf dem Octoboard läuft und den du erreichen möchtest, ein Linux-Server oder ein anderer Mac oder Windows-PC.
  • Server: hier ein Linux-Rechner, bei dem du dich über das Netzwerk anmeldest, meist einer, den du mietest und der keinen eigenen Bildschirm hat.
  • SSH: ein standardisierter, verschlüsselter Weg, sich an einem anderen Rechner anzumelden und dort Befehle einzugeben. Er ist in macOS, Windows und Linux eingebaut.
  • Terminal: das Fenster, in das du Befehle eingibst: Terminal unter macOS, PowerShell unter Windows.
  • SSH-Weiterleitung: ein SSH-Befehl, der etwas auf dem Host auf deinem eigenen Computer erscheinen lässt, sodass dein Browser es dort öffnen kann.
  • Fingerabdruck (Host-Schlüssel): ein kurzer Code, der das SSH eines Rechners identifiziert. Wenn du ihn einmal prüfst, weißt du, dass du den richtigen Rechner erreicht hast.
  • Schlüsseldatei: eine Datei, die dich statt eines Passworts anmeldet. Manche Serveranbieter geben dir eine.
  • Eine Möglichkeit, dich per SSH am Host anzumelden. Bei einem Linux-Server nennt dir der Anbieter die Adresse und deinen Benutzernamen. Um zu prüfen, ob es funktioniert, öffne das Terminal (macOS) oder PowerShell (Windows) und führe den folgenden Befehl mit deinem Benutzernamen und der Adresse des Servers aus. Antworte beim ersten Mal mit yes, wenn gefragt wird, ob du dem Server vertraust.

    Terminal window
    ssh <you>@<server>

    Bei einem Mac oder Windows-PC als Host schaltest du die SSH-Anmeldung in den Systemeinstellungen ein; Einen anderen Computer als Host verwenden zeigt, wie.

  • Bei einem Linux-Server: Octoboard darauf installiert und gestartet. Installation › Linux-Server zeigt, wie. Das Serverprogramm von Octoboard, octoboardd, nennt die App den Hintergrunddienst.

  • Die Octoboard-App auf diesem Computer, für macOS oder Windows, es sei denn, du nutzt nur einen Browser.

  1. Melde dich per SSH als der Benutzer, der Octoboard ausführt, am Server an, führe diesen Befehl aus und kopiere die Zeile, die mit octoboard+ssh:// beginnt: die Verbindungsdaten, die der App sagen, wo und wie sie sich verbinden soll.

    Terminal window
    octoboardd connection

    Wenn dieser Computer den Server unter einer anderen Adresse oder einem anderen SSH-Port erreicht, hänge --host oder --ssh-port an den Befehl an, damit er die richtigen Verbindungsdaten ausgibt.

    Der QR-Code, den er ebenfalls ausgibt, enthält dieselbe Zeile. Bisher scannt ihn keine App.

  2. Öffne in der Octoboard-App auf diesem Computer Remote-Geräte in der Leiste links oder wähle unter macOS Fernverbindung › Remote-Geräte in der Menüleiste. Unter Windows kannst du Remote-Geräte auch im Systemmenü des Fensters oder in der Sprungliste des Taskleistensymbols wählen.

  3. Wähle Hintergrunddienst hinzufügen und dann Einfügen unter Verbindungsdaten, um die Felder auszufüllen.

  4. Wähle unter Anmeldung die Option Passwort, wenn du dich mit deinem Kontopasswort anmeldest. Wähle Schlüsseldatei, wenn dir dein Serveranbieter stattdessen eine Schlüsseldatei gegeben hat (oft mit einem Namen wie id_ed25519 oder mit der Endung .pem), und gib an, wo sie sich auf diesem Computer befindet.

  5. Wähle Sichern und dann Verbinden. Gib dein Passwort ein, falls danach gefragt wird.

    Wenn du die Verbindungsdaten eingefügt hast, kam die Identität des Servers (sein Fingerabdruck) mit, und die App prüft sie für dich. Wenn du die Adresse von Hand eingegeben hast, zeigt die App beim ersten Mal einen Fingerabdruck an. Um sicherzugehen, dass du den richtigen Rechner erreicht hast, vergleiche ihn mit dem, den dieser Befehl auf dem Server ausgibt, und verbinde dich nur, wenn beide übereinstimmen:

    Terminal window
    ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

Es hat geklappt, wenn sich ein eigenes Octoboard-Fenster öffnet, das die Projekte und Sitzungen des Servers zeigt.

Du kannst auch einen Mac oder Windows-PC erreichen, auf dem die Octoboard-App läuft.

  1. Öffne auf dem Computer, den du erreichen möchtest, in Octoboard Einstellungen › Fernzugriff.
  2. Wähle dort Systemeinstellungen öffnen (macOS) oder Einstellungen öffnen (Windows) und schalte Entfernte Anmeldung (macOS) oder OpenSSH Server (Windows) ein, wie es der Pfad in der Zeile angibt, damit dieser Computer SSH-Anmeldungen annimmt. Dafür sind Administratorrechte nötig. Zurück in Octoboard zeigt die Zeile dann Ein.
  3. Schalte Fernzugriff erlauben ein, bestätige mit Erlauben und lass Octoboard geöffnet: Wenn du es beendest, endet der Fernzugriff.
  4. Wähle auf dem Tab Octoboard-App die Option Verbindungsdaten kopieren und sende sie an den anderen Computer, zum Beispiel per E-Mail oder Chat.
  5. Füge den Host auf dem Computer, von dem aus du arbeitest, wie in den Schritten 2 bis 5 von Verbindung zu einem Linux-Server herstellen hinzu und füge die gesendeten Daten ein. Melde dich mit deinem Benutzernamen und Passwort auf dem Host an.

Es hat geklappt, wenn sich ein eigenes Fenster mit den Projekten und Sitzungen des Hosts öffnet.

  1. Besorge dir den Befehl für die SSH-Weiterleitung:

    • Bei einem Mac- oder Windows-Host führe zuerst die Schritte 1 bis 3 von Einen anderen Computer als Host verwenden aus. Sieh dir dann auf dem Tab Browser den Abschnitt Schritt 1: SSH-Weiterleitung an. Klicke auf die Adresse im Befehl, um zu wählen, wie dein anderer Computer diesen erreicht (oder wähle Adresse selbst eingeben und ersetze <server> später), und wähle dann Weiterleitungsbefehl kopieren. Wähle außerdem unter Schritt 2: Browser-Adresse die Option Adresse kopieren.

    • Bei einem Linux-Server führe dies auf dem Server aus. Es gibt die Browser-Adresse aus und danach den SSH-Befehl, den du ausführen sollst.

      Terminal window
      octoboardd address

      Ersetze <server> im Befehl durch die Adresse des Servers.

  2. Führe auf dem Computer, von dem aus du im Browser arbeitest, den SSH-Befehl im Terminal (macOS) oder in PowerShell (Windows) aus. Das Fenster fragt möglicherweise nach deinem Passwort und zeigt danach nichts mehr an; das ist normal. Lass es geöffnet, während du arbeitest: Wenn du es schließt, wird der Browser getrennt.

  3. Öffne die Browser-Adresse, die mit http://127.0.0.1: beginnt, in deinem Browser.

Es hat geklappt, wenn sich Octoboard im Browser-Tab öffnet, ohne dass du dich anmelden musst.

Nur wer Octoboard über die SSH-Weiterleitung erreicht, kann diese Adresse verwenden. Halte sie geheim: Ihr Schlüssel gibt die volle Kontrolle, und sie bleibt im Verlauf und in den Lesezeichen des Browsers und wird mit deinen anderen Geräten synchronisiert, wenn die Browser-Synchronisierung eingeschaltet ist.

  • „Server nicht erreichbar“ oder der SSH-Befehl meldet „Connection refused“ oder läuft in ein Zeitlimit: Die SSH-Anmeldung ist auf dem Host ausgeschaltet, oder die Adresse oder der SSH-Port stimmt nicht. Prüfe, ob Entfernte Anmeldung oder OpenSSH Server eingeschaltet ist und ob du dich mit dem obigen ssh-Befehl anmelden kannst.
  • „Anmeldung fehlgeschlagen“ oder „Permission denied“: Benutzername, Passwort oder Schlüsseldatei sind falsch.
  • „Der Host-Schlüssel stimmt nicht überein“: Der Rechner, der antwortet, ist nicht derselbe, mit dem du dich zuvor verbunden hast. Das passiert, nachdem ein Server neu installiert wurde, kann aber auch bedeuten, dass etwas nicht stimmt. Mache erst weiter, wenn du den Grund kennst.
  • Die Browser-Seite lädt nicht: Das SSH-Fenster wurde geschlossen, oder sein Befehl wurde beendet. Führe ihn erneut aus und lade die Seite neu.
  • Keine zusätzlichen öffentlichen Ports: Octoboard nimmt nur Verbindungen vom Host selbst an, daher musst du dich für eine Verbindung von einem anderen Computer zuerst per SSH am Host anmelden. Deshalb brauchst du SSH oder eines der Relays.
  • Prüfe, welchen Rechner du erreichst: Die App merkt sich beim ersten erfolgreichen Verbinden den Host-Schlüssel, die SSH-Identität des Rechners, und blockiert die Verbindung mit einer Meldung, wenn sich diese Identität später ändert.
  • Kein Passwort gespeichert: Nachdem du dich zum ersten Mal mit einem Passwort oder deiner eigenen Schlüsseldatei angemeldet hast, richtet die App einen eigenen SSH-Schlüssel ein, den dieser Computer für künftige Anmeldungen verwendet.
  • Einem Computer den Zugriff entziehen: Entferne den Eintrag dieses Computers aus der Liste der erlaubten SSH-Schlüssel des Hosts (~/.ssh/authorized_keys unter Linux und macOS). Dieser Schlüssel kann sich dann nicht mehr anmelden; eine bereits geöffnete Verbindung bleibt bestehen, bis sie endet.
  • Ein Fenster pro SSH-Ziel: Verbindungen mit einem anderen Benutzernamen, Host oder SSH-Port öffnen jeweils ein eigenes Fenster, sodass sich ihre Projekte, Sitzungen und Mitteilungen nie vermischen.
  • Den Status jeder Verbindung sehen: Öffne das Menüleistensymbol der App unter macOS oder ihr Symbol im Infobereich unter Windows, um für jede Verbindung einen Tab zu sehen.
  • Entfernte Websites hier öffnen: Wenn ein Agent auf dem Host eine Website startet, klicke auf den Link localhost, den er angibt, und die App öffnet diese Website per SSH auf diesem Computer.
  • Entfernte Dateien hier öffnen: Sieh dir eine Datei im Remote-Fenster an oder lade eine Kopie herunter, um sie in der Standard-App dieses Computers für diese Datei zu öffnen.
  • Automatisch neu verbinden: Wenn das Netzwerk ausfällt, versucht das Fenster so lange, sich neu zu verbinden, bis es klappt oder du es schließt.