MyQ X Server
10.3 10.2 8.2 EoL Print Server Central Server English French German Italian Portuguese Spanish
10.3 10.2 8.2 EoL Print Server Central Server English French German Italian Portuguese Spanish

Benutzerdefinierte Traefik-Regeln migrieren

MyQ X 10.3 enthält ein Upgrade des Traefik-Reverse-Proxys. Die MyQ-eigene Konfiguration wird automatisch migriert. Falls Sie benutzerdefinierte Regeln haben, müssen Sie Ihre Regeldatei bearbeiten, um die v3-Syntax zu verwenden.

Diese Seite ist nur relevant, wenn Sie über eine nicht leere Datei traefik.custom.rules.yaml verfügen (Standardpfad: C:\ProgramData\MyQ\).


Schritte zur Vorbereitung Ihrer benutzerdefinierten Regeldatei

  1. Öffnen Sie die Datei traefik.custom.rules.yaml.

  2. Überprüfen Sie jede Router-Regel, jede Middleware-Definition und jede TLS-Option anhand des offiziellen Traefik-v3-Migrationsleitfadens: Traefik-v3-Migrationsdokumentation

  3. Nehmen Sie die erforderlichen Änderungen vor und speichern Sie die Datei.

  4. Führen Sie das MyQ-Upgrade durch.

Häufige Änderungen von v2 auf v3

Die folgende Liste enthält die häufigsten Änderungen. Sie ist nicht vollständig – vergleichen Sie Ihre Datei mit dem offiziellen Traefik-v3-Migrationsleitfaden, um den vollständigen Umfang zu erhalten.

v2-Syntax

Ersatz in v3

ipWhiteList-Middleware

ipAllowList

Host("a", "b") (Mehrwert-Matcher)

Host("a") || Host("b") (Einzelwert mit „OR“)

Headers(...) / HeadersRegexp(...)

Header(...) / HeaderRegexp(...)

HostHeader(...)

Host(...)

PathPrefix("/foo", "/bar")

PathPrefix("/foo") || PathPrefix("/bar")

PathPrefix mit regulären Ausdrücken

PathRegexp("...")

Pfad-Platzhalter {name} innerhalb von Matchern

PathRegexp("...") mit einem Go-Regex

Optionen für die Header sslRedirect, sslTemporaryRedirect, sslHost und sslForceHost

redirectScheme-Middleware

Header-Option featurePolicy

permissionsPolicy

Option stripPrefix forceSlash

Entfernt – kein Ersatz

tls.options.default.preferServerCipherSuites

Entfernt – kein Ersatz erforderlich

Option tls.caOptional

Entfernt – kein Ersatz

Beachten Sie bei der Kombination mehrerer Matcher die Prioritätsregeln von v3: Der Operator NOT hat eine höhere Priorität als AND, der wiederum eine höhere Priorität hat als OR.

Traefik v3 kann die v2-Regelsyntax weiterhin verarbeiten, wenn core.defaultRuleSyntax auf v2 gesetzt ist oder wenn die v2-Syntax für einen einzelnen Router konfiguriert ist. Dieser Kompatibilitätsmodus ist veraltet und wird voraussichtlich in der nächsten Hauptversion von Traefik entfernt. Bestehende v2-Regeln funktionieren daher möglicherweise vorübergehend weiterhin, sollten jedoch auf die v3-Syntax umgestellt werden.

Nach dem Upgrade

Überprüfen Sie die Datei C:\ProgramData\MyQ\Logs\traefik.log auf folgende Fehler, die auf verbleibende v2-Syntax in Ihrer benutzerdefinierten Regeldatei hinweisen:

  • error while parsing rule

  • headers configuration not valid

  • unknown middleware

Sollten solche Fehler auftreten, korrigieren Sie die entsprechenden Einträge und starten Sie Traefik neu.