Zum Hauptinhalt springen

SEW-Gateway-Anforderungen

Betriebssysteme ​

Linux ​

Der SDA Glue-Dienst für Linux basiert auf dem SoftEther VPN Client und nutzt den nativen Linux-IP-Stack sowie iptables für die Firewall-Verwaltung. Der Dienst kann zwar auch unter anderen Linux-Distributionen funktionieren, wurde jedoch auf nftables-basierten Systemen wie Red Hat Enterprise Linux nicht umfassend getestet. Für optimale Kompatibilität und Unterstützung empfehlen wir dringend, das Gateway auf Debian-basierten Distributionen bereitzustellen.

Systemanforderungen:

  • Architektur: ARM, ARM64, i386 oder AMD64
  • CPU & Arbeitsspeicher: Mindestens 1-GHz-Dual-Core-Prozessor und 512 MB RAM
  • Dienstverwaltung: systemd
  • Kernel-Version: 5.6+
  • Distribution: Debian- oder Ubuntu-basierte Distributionen
  • Abhängigkeiten: SoftEther VPN Client (wird während der Einrichtung automatisch installiert); OpenVPN (optional, manuelle Installation erforderlich)

Windows ​

Die Windows-Implementierung von SDA Glue nutzt den OpenVPN Community Client und ist für die Netzwerkfunktionalität auf Windows Network Address Translation (WinNAT/NetNat) angewiesen. Beachten Sie, dass WinNAT nicht auf allen Windows-Versionen standardmäßig aktiviert ist und möglicherweise manuell aktiviert werden muss.

Systemanforderungen:

  • Betriebssystem: Windows 10 Professional/Enterprise oder Windows Server 2016 oder höher
  • Architektur: ARM, ARM64, i386 oder AMD64
  • CPU & Arbeitsspeicher: Mindestens 2-GHz-Dual-Core-Prozessor und 2 GB RAM
  • Berechtigungen: Der Dienst benötigt erhöhte Berechtigungen zur Verwaltung von Netzwerkressourcen
  • Abhängigkeiten: OpenVPN Community Client (wird während der Einrichtung automatisch installiert)
  • Netzwerkfunktionen: WinNAT/NetNat (siehe Konfigurationsanweisungen unten)

WinNAT überprüfen

So prüfen Sie, ob die WinNAT-Funktion auf Ihrem System aktiviert ist:

  1. Öffnen Sie PowerShell als Administrator
  2. Führen Sie den folgenden Befehl aus:
Get-NetNat

Erwartete Ergebnisse:

  • Funktion aktiviert: Der Befehl wird erfolgreich ausgeführt (kann ein leeres Ergebnis zurückgeben, wenn keine NAT-Konfigurationen vorhanden sind)
  • Funktion deaktiviert: Es wird die Fehlermeldung "Get-NetNat : Invalid class" angezeigt

WinNAT aktivieren

Falls WinNAT nicht aktiviert ist, führen Sie die folgenden Schritte zur Aktivierung aus:

  1. Öffnen Sie PowerShell als Administrator
  2. Führen Sie die folgenden Befehle aus:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart
  1. Starten Sie den Computer nach erfolgreicher Ausführung neu
  2. Überprüfen Sie die Aktivierung, indem Sie Get-NetNat erneut ausführen

Docker & Kubernetes ​

SDA Glue kann in containerisierten Umgebungen bereitgestellt werden, wobei spezifische Konfigurationsanforderungen erfüllt sein müssen, um die VPN-Funktionalität zu ermöglichen. Der Dienst benötigt Zugriff auf das TUN-Gerät des Hosts sowie Netzwerkadministrationsrechte, um sichere Tunnel aufzubauen.

Systemanforderungen:

  • Host-Architektur: ARM64 oder AMD64
  • Zugriff auf TUN-Gerät: --device=/dev/net/tun — Zugriff auf die virtuelle Netzwerktunnel-Schnittstelle
  • Netzwerkberechtigungen: --cap-add=NET_ADMIN — Konfiguration von Netzwerkschnittstellen und Routing-Verwaltung

TUN-Gerät (/dev/net/tun): Die TUN-Schnittstelle ist ein virtuelles Netzwerkgerät, das auf Schicht 3 (IP-Ebene) des Netzwerkstacks arbeitet und häufig von VPN-Clients zum Aufbau sicherer Tunnel verwendet wird. VPN-Clients nutzen TUN-Geräte, um Daten zu verschlüsseln, bevor sie diese über den Tunnel an den VPN-Server weiterleiten. Ohne Zugriff auf dieses Gerät kann das containerisierte SDA Glue die für die Konnektivität erforderlichen Netzwerktunnel nicht erstellen.

NET_ADMIN-Berechtigung: Diese Linux-Capability ermöglicht es dem Container, netzwerkbezogene Operationen durchzuführen, darunter die Konfiguration von Schnittstellen, die Änderung der Routing-Tabelle und die Firewall-Verwaltung. VPN-Container benötigen die NET_ADMIN-Berechtigung, um Netzwerkressourcen zu verwalten und ein ordnungsgemäßes Routing für die sichere Kommunikation mit SEW Cloud-Diensten einzurichten.

 docker run -d \
   --name glue \
   --restart always \
   --device=/dev/net/tun \
   -p 8080:8080 \
   -v glue-data:/var/lib/sdaglue \
   --cap-add=NET_ADMIN \
   public.ecr.aws/t9c5s2d1/sdaglue:latest

Vollständige Bereitstellungsdetails, Konfigurationsbeispiele und Hinweise zur Fehlerbehebung.