Zum Inhalt springen
Octoboard Dokumentation

Browser über Tailscale

Öffne Octoboard in einem Browser auf einem anderen Computer über dein eigenes Tailscale-Netzwerk, ohne SSH und ohne Remote-Desktop. Der Host ist der Computer, auf dem Octoboard läuft: ein Mac, ein Windows-PC oder ein Linux-Server, auf dem octoboardd läuft. Die SSH-Anmeldung (Entfernte Anmeldung unter macOS) kann ausgeschaltet bleiben.

Du bist nicht sicher, ob das der richtige Weg für dich ist? Siehe Verbindungsart wählen.

Browser auf deinem Computer → Relay auf deinem Computer (127.0.0.1) ⟷ Tailscale ⟷ Relay auf dem Host (127.0.0.1) → Octoboard

Neu hier?
  • Tailscale: ein Dienst, der deine Geräte über das Internet zu einem privaten Netzwerk verbindet, egal wo sie stehen. Du meldest dich dort mit deinem eigenen Konto an.
  • Tailnet: dein Tailscale-Netzwerk: die Geräte, die bei deinem Tailscale-Konto angemeldet sind.
  • 127.0.0.1 (Loopback): eine Adresse, die immer „genau dieser Computer“ bedeutet.
  • Port: eine Zahl, die ein Programm auf einem Computer auswählt, wie eine Türnummer. 127.0.0.1:3369 ist Port 3369 auf diesem Computer.
  • socat: ein kleines, kostenloses Programm, das eine Verbindung von einem Ort an einen anderen weitergibt. Hier ist es das Relay.
  • Tailscale Serve: ein Tailscale-Befehl, der einen Port nur für dein Tailnet freigibt. Sein Verwandter, Tailscale Funnel, würde ihn für das gesamte Internet freigeben; verwende ihn hier niemals.
  • Terminal: das Fenster, in das du Befehle eingibst: Terminal unter macOS, PowerShell unter Windows.

Aus Sicherheitsgründen nimmt Octoboard nur einen Browser an, der es unter 127.0.0.1 öffnet, einer Adresse, die immer „genau dieser Computer“ bedeutet (auch Loopback genannt). Du kannst also nicht einfach die Tailscale-Adresse des Hosts in den Browser eingeben. Stattdessen führst du auf jedem Computer ein kleines Relay-Programm aus: Auf deinem Computer lässt es den Host unter 127.0.0.1 lokal erscheinen; auf dem Host übergibt es die Verbindung an Octoboard. Tailscale transportiert den Datenverkehr zwischen den beiden.

  • Tailscale auf beiden Computern, angemeldet im selben Tailnet. Verwende ein Tailnet, das nur deine eigenen Geräte enthält: Jedes Gerät, das es zum Host durchlässt, kann den freigegebenen Port erreichen.

  • socat auf jedem Computer, der ein Mac ist oder Linux nutzt. Ein Windows-Computer braucht es nicht.

    Installiere zuerst Homebrew, falls du es nicht hast (macOS bringt kein Werkzeug mit, das diese Aufgabe erledigen kann), und führe dann dies im Terminal aus:

    Terminal window
    brew install socat
  • Zwei oder drei geöffnete Fenster, während du arbeitest: das Relay und Tailscale Serve auf dem Host (außer dem Relay unter Windows) und das Relay auf deinem Computer (außer unter Windows).

  1. Besorge dir die Browser-Adresse, die den Schlüssel trägt, mit dem sich der Browser anmeldet.

    Öffne in Octoboard Einstellungen › Fernzugriff, schalte Fernzugriff erlauben ein und bestätige mit Erlauben. Unter dem Schalter erscheinen dann zwei Tabs. Wähle auf dem Tab Browser unter Schritt 2: Browser-Adresse die Option Adresse kopieren.

    Bring die Adresse so zum anderen Computer, dass nur du sie lesen kannst, zum Beispiel als Notiz an dich selbst: Sie funktioniert wie ein Passwort.

    Überspringe Schritt 1: SSH-Weiterleitung. Die Einstellungen der App erwähnen SSH an mehreren Stellen; das kannst du hier ignorieren, denn diese Anleitung nutzt nur die Browser-Adresse.

    Lass Octoboard geöffnet: Wenn du es beendest, endet der Fernzugriff.

  2. Starte das Relay auf dem Host, das einen Port an 127.0.0.1 des Hosts mit Octoboard verbindet. Dieser Port ist in den folgenden Schritten der Host-Port.

    Führe dies im Terminal aus und lass das Fenster geöffnet. Es lauscht ausschließlich auf 127.0.0.1:3370.

    Terminal window
    socat TCP-LISTEN:3370,bind=127.0.0.1,reuseaddr,fork UNIX-CONNECT:"$HOME/.octoboard/browser.sock"

    Der Host-Port ist 3370.

  3. Gib den Host-Port mit Tailscale Serve für dein Tailnet frei und lass das Fenster geöffnet. Verwende niemals Tailscale Funnel, das ihn im öffentlichen Internet bereitstellen würde.

    Terminal window
    tailscale serve --tcp=3370 tcp://127.0.0.1:3370

    Wenn du die Tailscale-App aus dem App Store hast, führe den Befehl als /Applications/Tailscale.app/Contents/MacOS/Tailscale anstelle von tailscale aus. Bei der eigenständigen App installiere den Befehl zuerst in ihren Einstellungen unter „CLI integration“.

    Zur Kontrolle führe in einem anderen Fenster tailscale serve status aus: Es sollte den Host-Port auflisten.

Auf dem Computer, von dem aus du im Browser arbeitest

Abschnitt betitelt „Auf dem Computer, von dem aus du im Browser arbeitest“
  1. Suche den Host in der Tailscale-App auf diesem Computer und notiere seinen Namen (wie my-mac) oder seine Adresse (eine Zahl wie 100.x.y.z).

  2. Starte das Relay auf diesem Computer, das den Host hier unter 127.0.0.1:3369 erscheinen lässt. Wenn Port 3369 auf diesem Computer bereits belegt ist, wähle einen anderen Port und ändere ihn auch in der Browser-Adresse.

    Ersetze im folgenden Befehl <host> durch den Namen oder die Adresse des Hosts und <host port> durch den Host-Port.

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:<host>:<host port>

    Zum Beispiel für einen Mac-Host namens my-mac:

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:my-mac:3370

    Führe ihn im Terminal aus und lass das Fenster geöffnet.

  3. Öffne die Browser-Adresse, die du auf dem Host kopiert hast. Sie beginnt mit http://127.0.0.1:3369/.

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

  • Die Seite lädt nicht: Eines der Fenster wurde geschlossen, oder sein Befehl wurde beendet. Prüfe, ob die Relays und Tailscale Serve noch laufen und ob tailscale serve status auf dem Host den Host-Port auflistet.
  • socat meldet „Address already in use“: Dieser Port ist auf diesem Computer belegt. Wähle einen anderen Port; auf deinem Computer ändere ihn auch in der Browser-Adresse.
  • Die Seite wird abgelehnt oder bleibt leer: Prüfe, ob du die Adresse unter 127.0.0.1 geöffnet hast und nicht über den Tailscale-Namen des Hosts oder seine 100.x.y.z-Adresse.
  • Das Relay auf dem Host gibt „Connection refused“ oder „No such file or directory“ aus, wenn du die Seite öffnest: Fernzugriff erlauben ist ausgeschaltet, oder Octoboard läuft auf dem Host nicht (unter Linux: octoboardd läuft nicht).
  • Auf dem Computer, von dem aus du im Browser gearbeitet hast: Beende socat mit Strg+C oder lösche unter Windows die Weiterleitung in PowerShell, als Administrator ausgeführt:

    Terminal window
    netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369
  • Auf dem Host: Beende den Tailscale-Serve-Befehl und socat mit Strg+C. Prüfe mit tailscale serve status, dass nichts mehr freigegeben ist; wenn der Port noch aufgelistet wird, entferne ihn mit tailscale serve --tcp=3370 off (unter Windows mit tailscale serve --tcp=3369 off).

  • Bei einem Mac- oder Windows-Host schalte Fernzugriff erlauben aus, wenn du ihn nicht mehr brauchst. Das schließt den Browser-Zugang und trennt jede Seite, die mit dem Schlüssel geöffnet wurde.

  • Wenn die Adresse möglicherweise durchgesickert ist, gib ihr mit Schlüssel erneuern auf dem Tab Browser einen neuen Schlüssel, oder unter Linux mit octoboardd address --rotate. Seiten, die mit der alten Adresse geöffnet sind, werden getrennt.

  • Die Adresse ist das Passwort: Ihr Schlüssel gibt die volle Kontrolle über Octoboard auf dem Host, einschließlich der Ausführung beliebiger Befehle. Er gilt, bis du ihn erneuerst. Er bleibt im Verlauf und in den Lesezeichen des Browsers und wird mit deinen anderen Geräten synchronisiert, wenn die Browser-Synchronisierung eingeschaltet ist.
  • Wer sie erreichen kann: jeder, der den Host-Port erreicht und den Schlüssel hat. Die Relays lauschen nur auf 127.0.0.1, daher können andere Geräte im Netzwerk des Hosts oder in deinem lokalen Netzwerk sie nicht erreichen; Tailscale Serve macht den Host-Port nur aus deinem Tailnet erreichbar, soweit dessen Zugriffsregeln es erlauben.
  • Nur auf Computern, an denen sich sonst niemand anmeldet: Ein anderes Benutzerkonto auf dem Host oder auf deinem Computer kann sich mit diesen 127.0.0.1-Ports verbinden, und solange ein Relay nicht läuft, kann es dessen Port übernehmen und den Schlüssel erhalten, wenn sich dein Browser neu verbindet. Über SSH verbinden hat bei einem Mac- oder Linux-Host diese Schwäche nicht, und auch dein eigener Computer hat sie nicht, wenn du die Desktop-App nutzt. Im Browser hat dein Computer sie weiterhin, denn dort lauscht die SSH-Weiterleitung ebenfalls auf einem 127.0.0.1-Port.
  • Niemals Funnel: Tailscale Funnel würde den Port für das gesamte Internet veröffentlichen.