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
v1Standard channel version. HTTPRoute gains new filters and policies:- CORS filter (#13437)
- RequestMirror (#14123)
- Retry (#14127)
backendRequesttimeouts- 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
tapmiddleware. 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)andHostSNI(.example.com)match every subdomain, nested ones included.*.example.comkeeps 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-allowlistannotationdisableHTTPEntryPointoption- Optional
X-Forwarded-Scheme/X-Schemeheaders - NTLM and Kerberos support in
auth-url - A long list of compatibility fixes
- And more:
- Circuit breaker minimum request count
- Buffering middleware
disableRequestBuffer/disableResponseBuffer QUERYmethod 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
v1alpha2TCPRoute must move togateway.networking.k8s.io/v1. - New RBAC rights are required for
listenersets. - The
defaultTLS options no longer apply to Gateway API HTTPS listeners, which now carry their own TLS options. - Deprecations:
labelSelectoron the Gateway API provider is replaced by the newgatewayClassoption.peerCertURIon ServersTransport is replaced bypeerCertSANs. 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!