Traefik Proxy v3.8 "Salers" RC1 is out: Gateway API v1.7, ListenerSet, Tap middleware, double wildcard hosts, and more

Traefik Proxy 3.8, codenamed "Salers", has its first release candidate: v3.8.0-rc.1.

This cycle centers on Kubernetes Gateway API. Traefik now follows Gateway API v1.7.0 and supports a large set of newly standard features. Alongside that come a new traffic-inspection middleware, more flexible host matching, and finer-grained timeouts. 98 contributors were involved in this cycle. Thank you all!

Highlights

  • Enhanced Gateway API support. This includes ListenerSet support (GEP-1713, #12909) and TCPRoute through its v1 Standard channel version. HTTPRoute gains new filters and policies:
    • CORS filter (#13437)
    • RequestMirror (#14123)
    • Retry (#14127)
    • backendRequest timeouts
    • Gateway API TLS, end to end. Client certificate validation on Gateways (#14129) and backend client certificates (#14119). BackendTLSPolicy now covers TLSRoute and gRPC backends, with SAN validation and ClusterTrustBundle CA references.
    • Isolated Gateway listeners. Each listener now only serves the requests it is the best match for. Misdirected requests get a proper 421.
  • New tap middleware. Sends a copy of the requests and responses going through it to a Traefik service as JSON records. Useful for auditing, debugging, or feeding an analytics pipeline. (#13962)
  • Double wildcard host matching. Host(.example.com) and HostSNI(.example.com) match every subdomain, nested ones included. *.example.com keeps matching direct subdomains only. (#13882)
  • Per-router responding timeouts. Set them directly on a router, from Docker labels, Ingress, CRDs, or Gateway API. ServersTransport also gets new forwarding timeouts. (#13537)
  • Plugins can read ConfigMaps. A plugin configuration value written as urn:k8s:configmap:<name>:<key> is replaced with the ConfigMap value. (#14118)
  • ingress-nginx keeps closing the gap:
    • limit-allowlist annotation
    • disableHTTPEntryPoint option
    • Optional X-Forwarded-Scheme/X-Scheme headers
    • NTLM and Kerberos support in auth-url
    • A long list of compatibility fixes
  • And more:
    • Circuit breaker minimum request count
    • Buffering middleware disableRequestBuffer/disableResponseBuffer
    • QUERY method in metrics labels
    • Entry point options to harden request header handling (max header size, value count, underscores, aliasing)

Before you upgrade

Please read the v3.8 migration guide. The main points:

  • The Gateway API provider requires the v1.7.0 CRDs. Manifests still written as v1alpha2 TCPRoute must move to gateway.networking.k8s.io/v1.
  • New RBAC rights are required for listenersets.
  • The default TLS options no longer apply to Gateway API HTTPS listeners, which now carry their own TLS options.
  • Deprecations:
    • labelSelector on the Gateway API provider is replaced by the new gatewayClass option.
    • peerCertURI on ServersTransport is replaced by peerCertSANs. Using it requires updating the Traefik CRDs.

Try it

  • GitHub Release: v3.8.0-rc.1
  • Docker Hub: traefik:v3.8.0-rc.1
  • Helm chart: (chart version to confirm)
  • Documentation: doc.traefik.io

This is a release candidate, so it's the best time to test it against your own setup. Please report anything unexpected on GitHub issues.

Thank you

This release is community-driven again. Whether you opened an issue, reviewed a PR, ran the Gateway API conformance suite, or contributed a feature, thank you.

Want to add yours to the next release? Contributions are welcome across the entire codebase, on any topic.

Happy routing!

1 Like