Twingate mit Docker Compose auf CasaOS installieren

Derzeit lässt sich Twingate am einfachsten mit CasaOS nutzen, indem du einen Twingate Connector als Docker-Container auf dem CasaOS-Host oder einem anderen Rechner im selben LAN ausführst. Der Connector stellt ausgehende Verbindungen zu Twingate her, sodass keine Portweiterleitung für das CasaOS-Dashboard erforderlich ist.

Die Forumsanleitung von 2023 stammt aus der Zeit vor Twingates aktueller Docker-Compose-Vorlage. Verwende die aktuellen Connector-Tokens und offiziellen Compose-Variablen, anstatt blind ein altes One-Click-Store-Paket zu kopieren.

Ein Remote Network und einen Connector erstellen

Erstelle in der Twingate Admin Console ein Remote Network und einen Connector. Twingate generiert für diesen Connector ein eindeutiges Access Token und Refresh Token.

Die aktuelle Docker-Compose-Vorlage verwenden

Die aktuelle Twingate Docker Compose-Anleitung dokumentiert diese erforderlichen Variablen:

services:
  twingate-connector:
    image: twingate/connector:latest
    restart: always
    environment:
      - TWINGATE_NETWORK=YOUR_TENANT
      - TWINGATE_ACCESS_TOKEN=YOUR_ACCESS_TOKEN
      - TWINGATE_REFRESH_TOKEN=YOUR_REFRESH_TOKEN

Tokens aus öffentlichen Screenshots heraushalten

Access- und Refresh-Tokens authentifizieren den Connector eindeutig. Speichere sie in der CasaOS-App-Konfiguration oder in einer Umgebungsdatei, die nicht in Git eingecheckt oder öffentlich veröffentlicht wird.

CasaOS als Twingate Resource hinzufügen

Lege in der Twingate Admin Console die CasaOS-LAN-IP-Adresse oder den Hostnamen und den Webport als Resource fest. Gewähre nur den Benutzern und Gruppen Zugriff, die ihn benötigen.

Bridge- oder Host-Netzwerk

Laut Twingate ist der Bridge-Modus die Standardeinstellung, während der Host-Modus bei lokalen Peer-to-Peer-Verbindungen helfen kann. Beginne mit der offiziellen Standardeinstellung, sofern du keinen bestimmten Grund hast, den Netzwerk-Stack des Hosts freizugeben.

Keine Router-Portweiterleitung erforderlich

Der Connector befindet sich hinter der Firewall und stellt ausgehende Verbindungen her. Öffne den CasaOS-Admin-Port nicht für das öffentliche Internet, nur weil du Fernzugriff möchtest.

Den Twingate-Client auf Ihrem Gerät für den Fernzugriff installieren

Der Connector läuft in Ihrem Heimnetzwerk; der Twingate-Client läuft auf dem Laptop oder Smartphone, das Sie aus der Ferne verwenden. Beide registrieren sich im Twingate-Netzwerk, bevor der Datenverkehr die private Ressource erreicht.

Zugriff prüfen, bevor Sie weitere Ressourcen hinzufügen

Testen Sie zuerst das CasaOS-Dashboard und fügen Sie dann weitere NAS-Apps einzeln hinzu. So bleiben die Zugriffsrichtlinien klar definiert, statt unnötigerweise ein ganzes Subnetz freizugeben.

Der Leitfaden für privaten Fernzugriff bietet einen umfassenderen Überblick über Heimserver.

Connector-Status prüfen, bevor Sie CasaOS testen

docker ps | grep twingate
docker logs --tail 100 twingate-connector

Der Connector sollte sich erfolgreich registrieren und weiterhin laufen. Wenn er wiederholt neu startet, überprüfen Sie Mandantennamen und Tokens, bevor Sie die CasaOS-Ressource untersuchen.

Die engstmögliche Ressourcendefinition verwenden

Wenn Sie nur das CasaOS-Dashboard benötigen, geben Sie die genaue CasaOS-IP-Adresse und den Webport an, statt das gesamte LAN-Subnetz freizugeben. Fügen Sie weitere Apps bei Bedarf als separate Ressourcen hinzu.

Connector-Updates planen

Twingate veröffentlicht Container-Updates unabhängig von CasaOS. Laden Sie regelmäßig das aktuelle Connector-Image herunter und starten Sie es während eines Wartungsfensters neu. Prüfen Sie anschließend, ob der Fernzugriff weiterhin funktioniert.

FAQ

Muss ich CasaOS-Ports auf meinem Router öffnen?

Nein. Twingate-Connectoren sind dafür ausgelegt, hinter der Firewall zu laufen und ausgehende Verbindungen herzustellen.

Woher stammen die Twingate-Tokens?

Die Admin-Konsole generiert sie, wenn Sie einen Connector bereitstellen.

Sollte ich das Host-Netzwerk verwenden?

Nur wenn es für Ihre Netzwerktopologie oder Peer-to-Peer-Verbindungen nötig ist; Bridge ist die Standardeinstellung.

Kann ein Connector mehr als nur CasaOS bereitstellen?

Ja, aber definieren Sie Ressourcen und Berechtigungen bewusst, statt standardmäßig breiten Zugriff auf das Subnetz zu gewähren.