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:3369ist 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.
Warum die zusätzlichen Schritte
Abschnitt betitelt „Warum die zusätzlichen Schritte“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.
Bevor du anfängst
Abschnitt betitelt „Bevor du anfängst“-
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 socatEs ist nichts zu installieren: Ein Windows-Host stellt den Browser bereits über einen Port an
127.0.0.1bereit, und ein Windows-Computer, von dem aus du im Browser arbeitest, verwendet stattdessen einen eingebauten Befehl.Terminal window sudo apt install socatVerwende den Paketmanager deiner Distribution (
dnf,pacmanund so weiter), wenn es nichtaptist. -
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).
Auf dem Host
Abschnitt betitelt „Auf dem Host“-
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.
Ö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. Notiere dir außerdem die Zahl unter Browser-Port.
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.
Führe dies als der Benutzer aus, als der octoboardd läuft, und kopiere die ausgegebene Adresse, die mit
http://127.0.0.1:3369/beginnt. Ignoriere den SSH-Befehl, den es danach ausgibt.Terminal window octoboardd address -
Starte das Relay auf dem Host, das einen Port an
127.0.0.1des 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.Es ist nichts auszuführen: Octoboard selbst lauscht auf dem Browser-Port, ausschließlich auf
127.0.0.1. Der Host-Port ist der Browser-Port (3369, sofern du ihn nicht geändert hast).Führe dies als derselbe Benutzer aus, in einem Terminal oder einer
tmux-Sitzung, die geöffnet bleibt. Es lauscht ausschließlich auf127.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. -
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:3370Wenn du die Tailscale-App aus dem App Store hast, führe den Befehl als
/Applications/Tailscale.app/Contents/MacOS/Tailscaleanstelle vontailscaleaus. Bei der eigenständigen App installiere den Befehl zuerst in ihren Einstellungen unter „CLI integration“.In PowerShell oder in der Eingabeaufforderung:
Terminal window tailscale serve --tcp=3369 tcp://127.0.0.1:3369Verwende deinen Port, wenn du den Browser-Port geändert hast.
Terminal window tailscale serve --tcp=3370 tcp://127.0.0.1:3370Wenn Tailscale meldet, dass dir die Berechtigung fehlt, erlaube deinem Benutzer einmalig die Verwaltung mit
sudo tailscale set --operator="$USER"oder führe den Befehl mitsudoaus.Zur Kontrolle führe in einem anderen Fenster
tailscale serve statusaus: 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“-
Suche den Host in der Tailscale-App auf diesem Computer und notiere seinen Namen (wie
my-mac) oder seine Adresse (eine Zahl wie100.x.y.z). -
Starte das Relay auf diesem Computer, das den Host hier unter
127.0.0.1:3369erscheinen 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:3370Führe ihn im Terminal aus und lass das Fenster geöffnet.
Öffne PowerShell als Administrator. Ersetze im folgenden Befehl
<host IP>durch die100.x.y.z-Adresse des Hosts (dieser Befehl braucht die Zahl; ein Name funktioniert nicht) und<host port>durch den Host-Port.Terminal window netsh interface portproxy add v4tov4 listenaddress=127.0.0.1 listenport=3369 connectaddress=<host IP> connectport=<host port>Diese Weiterleitung bleibt bestehen, auch über Neustarts hinweg, bis du sie löschst (siehe unten), daher gibt es kein Fenster, das geöffnet bleiben muss. Sie braucht den Dienst „IP-Hilfsdienst“ (IP Helper), der standardmäßig läuft.
-
Ö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.
Wenn es nicht funktioniert
Abschnitt betitelt „Wenn es nicht funktioniert“- 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 statusauf 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.1geöffnet hast und nicht über den Tailscale-Namen des Hosts oder seine100.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).
Ausschalten
Abschnitt betitelt „Ausschalten“-
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 mittailscale serve --tcp=3370 off(unter Windows mittailscale 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.
Sicherheit
Abschnitt betitelt „Sicherheit“- 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 einem127.0.0.1-Port. - Niemals Funnel: Tailscale Funnel würde den Port für das gesamte Internet veröffentlichen.