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

Migrar reglas personalizadas de Traefik

MyQ X 10.3 incluye una actualización del proxy inverso Traefik. La configuración propia de MyQ se migra automáticamente. Si dispone de reglas personalizadas, deberá editar su archivo de reglas para utilizar la sintaxis de la versión 3.

Esta página solo es relevante si dispone de un archivo traefik.custom.rules.yaml que no esté vacío (ubicación predeterminada: C:\ProgramData\MyQ\).


Pasos para preparar su archivo de reglas personalizadas

  1. Abra el archivo traefik.custom.rules.yaml.

  2. Revise cada regla de enrutador, definición de middleware y opción TLS según la guía oficial de migración a Traefik v3: Documentación de migración a Traefik V3

  3. Aplique los cambios necesarios y guarde el archivo.

  4. Ejecute la actualización de MyQ.

Cambios habituales de la v2 a la v3

La siguiente lista recoge los cambios más habituales. No es exhaustiva; compare su archivo con la guía oficial de migración a Traefik v3 para conocer el conjunto completo.

Sintaxis de la v2

Sustitución en la v3

Middleware ipWhiteList

ipAllowList

Host("a", "b") (comparadores de varios valores)

Host("a") || Host("b") (valor único con «OR»)

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

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

HostHeader(...)

Host(...)

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

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

PathPrefix con expresiones regulares

PathRegexp("...")

Marcadores de posición de ruta {name} dentro de los comparadores

PathRegexp("...") con una expresión regular de Go

Opciones de los encabezados sslRedirect, sslTemporaryRedirect, sslHost y sslForceHost

Middleware redirectScheme

Opción de encabezados featurePolicy

permissionsPolicy

Opción stripPrefix forceSlash

Eliminado: no hay sustituto

tls.options.default.preferServerCipherSuites

Eliminado: no se necesita sustitución


Eliminada — sin sustituto

Al combinar varios comparadores, tenga en cuenta las reglas de precedencia de la v3: el operador NOT tiene mayor prioridad que AND, que a su vez tiene mayor prioridad que OR.

Traefik v3 sigue pudiendo procesar la sintaxis de reglas de la v2 cuando core.defaultRuleSyntax está establecido en v2 o cuando se configura la sintaxis de la v2 para un enrutador concreto. Este modo de compatibilidad está en desuso y se prevé que se elimine en la próxima versión principal de Traefik. Por lo tanto, es posible que las reglas existentes de la v2 sigan funcionando temporalmente, pero deben migrarse a la sintaxis de la v3.

Tras la actualización

Compruebe en el archivo C:\ProgramData\MyQ\Logs\traefik.log si aparecen los siguientes errores, que indican la presencia de sintaxis v2 residual en su archivo de reglas personalizadas:

  • error while parsing rule

  • headers configuration not valid

  • unknown middleware

Si aparece alguno, corrija las entradas correspondientes y reinicie Traefik.