Dokumentation
Tailscale VPN
Benötigt: Symcon >= 7.1
Dieses Modul bietet die Möglichkeit, Tailscale VPN auf der SymBox zu verwenden.
Dieses Modul ist ausschließlich für die SymBox verfügbar!
Funktionsumfang
- Herunterladen und Aktualisieren von Tailscale VPN
- Authentifizieren über Auth Keys
- Zugriff per VPN auf die SymBox (inkl. SSH)
- Zugriff auf Geräte hinter der SymBox (Subnets)
- VPN aktivieren/deaktivieren per Variable
- VPN beim Starten der SymBox automatisch aktivieren
- MagicDNS optional verwenden
Software-Installation
- Über den Module Store das 'Tailscale VPN'-Modul installieren.
Einrichten der Instanzen in IP-Symcon
- Unter "Instanz hinzufügen" kann das 'Tailscale VPN'-Modul mithilfe des Schnellfilters gefunden werden.
- Weitere Informationen zum Hinzufügen von Instanzen in der Dokumentation der Instanzen
Einrichten von Tailscale
- Auth Key erstellen: https://login.tailscale.com/admin/settings/keys
- Tailscale Instanz öffnen
- Buttons drücken, um Tailscale herunterzuladen, zu installieren und zu starten.
- Danach kann die Authentifizierung durchgeführt werden mit Hilfe des am Anfang erstellen Auth Keys. Der Auth Key wird im Anschluss nicht mehr benötigt und muss nirgends gespeichert werden.
Die Tailscale-Binärdateien sowie der Zustand (Authentifizierung, Einstellungen) werden dauerhaft unter /mnt/data auf der SymBox abgelegt und bleiben auch nach einem Neustart erhalten.
Netzwerk freigeben
- Das VPN in IP-Symcon einmal aus- und wieder einschalten.
- Um Geräte hinter der SymBox freizugeben, muss die "Advertise Routes" Funktion eingerichtet werden
- Dazu in die Liste das Subnet z.B. 192.168.178.0/24 in der CIDR Notation eintragen und die Konfiguration übernehmen.
- Die Freigabe muss noch im Tailscale Dashboard aktiviert werden. Dazu folgende Seite öffnen: https://login.tailscale.com/admin/machines
- Dort die korrekte Maschine auswählen, Review klicken und die Freigabe des Subnets bestätigen.
Änderungen an den Advertise Routes werden direkt übernommen, sofern der Tailscale-Dienst läuft. Ein Neustart des Tunnels ist nicht erforderlich.
MagicDNS
Tailscale kann die DNS-Konfiguration der SymBox übernehmen (MagicDNS), sodass andere Geräte im Tailnet über ihren Namen erreichbar sind. Da MagicDNS auf der SymBox gelegentlich die komplette DNS-Auflösung stört, ist diese Funktion standardmäßig deaktiviert und sollte nur bei Bedarf über die Option "MagicDNS verwenden" aktiviert werden.
Sollte die Namensauflösung auf der SymBox nicht mehr funktionieren, die Option "MagicDNS verwenden" deaktivieren und die Konfiguration übernehmen. Tailscale stellt die ursprüngliche DNS-Konfiguration daraufhin wieder her.
Aktualisieren von Tailscale
Jede Version des Moduls enthält eine feste Tailscale-Version. Weicht die installierte Version davon ab, wird in der Instanz anstelle des "Herunterladen"-Buttons ein "Aktualisieren"-Button angeboten. Beim Aktualisieren werden Tunnel und Dienst kurzzeitig gestoppt und anschließend automatisch wieder gestartet. Die Authentifizierung bleibt erhalten.
Konfigurationsseite
| Name | Beschreibung |
|---|---|
| VPN beim Starten automatisch aktivieren | Startet den Tailscale-Dienst und den Tunnel automatisch nach dem Start der SymBox |
| MagicDNS verwenden | Erlaubt Tailscale die Übernahme der DNS-Konfiguration. Standardmäßig deaktiviert, siehe Abschnitt MagicDNS |
| Advertise Routes | Subnet, welches freigegeben werden soll in der CIDR Notation z.B. 192.168.178.0/24 |
Aktionen
| Name | Beschreibung |
|---|---|
| Herunterladen/Aktualisieren | Lädt die zum Modul passende Tailscale-Version herunter, prüft die Signatur und installiert sie |
| Dienst starten | Startet den Tailscale-Dienst (tailscaled). Wird nur angezeigt, wenn der Dienst nicht läuft |
| Mit Tailscale authentifizieren | Meldet die SymBox mit einem Auth Key im Tailnet an. Wird nur angezeigt, solange die SymBox nicht authentifiziert ist |
| Tunnel starten/stoppen | Baut die VPN-Verbindung auf bzw. ab. Entspricht dem Schalten der Variable "VPN" |
| Komplett zurücksetzen | Stoppt Tailscale und entfernt die Binärdateien sowie alle Daten inkl. Authentifizierung |
| Zeige Status (Debug) | Zeigt die vollständige Statusausgabe von Tailscale zur Fehlersuche an |
Statusvariablen
| Name | Typ | Beschreibung |
|---|---|---|
| VPN | Boolean | Schaltet den Tunnel ein bzw. aus. Wird alle 10 Sekunden mit dem tatsächlichen Zustand abgeglichen |
| Status | String | "Verbunden!" bei aktivem Tunnel. Andernfalls die Hinweise von Tailscale (z.B. "Tailscale is stopped.") oder die Fehlermeldung des letzten Startversuchs |
Fehlersuche
- Schlägt das Starten des Tunnels fehl, wird die Fehlermeldung von Tailscale in der Variable "Status" angezeigt und der Schalter "VPN" bleibt aus.
- Alle Aufrufe von Tailscale werden inklusive Exit-Code und Ausgabe im Debug-Fenster der Instanz protokolliert.
- Das Modul verwaltet ausschließlich den Hostnamen, die Advertise Routes, das Annehmen von Routen (immer deaktiviert) und MagicDNS. Alle anderen Tailscale-Einstellungen, die z.B. per SSH über
tailscale setgeändert wurden, bleiben beim Starten des Tunnels erhalten. - Über den Button "Komplett zurücksetzen" kann Tailscale vollständig entfernt werden. Danach muss die SymBox erneut authentifiziert werden.