MuxMaster
A radix-tree HTTP router for Go, with HTTP QUERY method (RFC 10008) support.
MuxMaster is an HTTP router for Go built on a radix tree: route lookup costs O(k) in the length of the URL path, static routes allocate nothing, and every handler and middleware keeps the standard net/http signatures. It has zero external dependencies, supports the HTTP QUERY method (RFC 10008), and requires Go 1.27.1 or later. The current release is v1.3.0.
Released as v1.3.0 · MIT-licensed · Requires Go 1.27.1 or later.
Highlights
HTTP QUERY method (RFC 10008)
QUERY is a safe, idempotent method, like GET, that carries its query in the request body, like POST. MuxMaster has supported it since v1.2.0, with MethodQuery, Mux.QUERY, Mux.QUERYE, Mux.QUERYFast, Group.QUERY, and Group.QUERYE; ANY includes QUERY, the Allow header lists it, and automatic redirects use 307 so the method and body are preserved. Read the HTTP QUERY method (RFC 10008) guide.
net/http compatible, zero external dependencies
A *muxmaster.Mux is an http.Handler, handlers are http.HandlerFunc, and middleware is func(http.Handler) http.Handler, so existing handlers and middleware work unchanged. The router and the middleware package use only the Go standard library.
Allocation-aware routing
Static routes allocate nothing. By default a request to a route with path parameters makes one allocation; with the opt-in PoolRequestBundle, parameterised routes allocate nothing, under a stricter handler lifetime contract. See the Maximum performance guide.
Rich path patterns
Named (:id), regex-constrained ({id:[0-9]+}), optional ({/:id}), and catch-all (*filepath) parameters, with typed accessors for int, int64, uint64, float64, and bool.
Middleware and error-returning handlers
Pre runs before routing, for every request; Use wraps standard routes; UseFast wraps FastHandler routes. The middleware package provides 21 middleware constructors, including logging, panic recovery, CORS, Basic Auth, API keys, JWT, OAuth 2.0 introspection, compression, throttling, timeouts, and request IDs. HandlerFuncE handlers return an error, and one ErrorHandler turns errors into responses.
What's new
- v1.3.0 (2026-09-26): Go 1.27.1 is now the minimum version; the default
OAuth2Introspect client no longer exhausts ephemeral ports under load; Group.ServeFiles applies the same raw-path security guard as Mux.ServeFiles. The exported API is unchanged. Release notes v1.3.0.
- v1.2.0 (2026-09-26): HTTP QUERY method (RFC 10008);
Mount fixes for nested routers; routing fixes (no empty-segment parameter matches, correct group prefix joins); behaviour changes to redirects and to BasicAuth, CORS, OAuth2Introspect, and Recoverer; route registration that copies O(depth) instead of O(tree size). Release notes v1.2.0.
A quick look
package main
import (
"log"
"net/http"
"github.com/FlavioCFOliveira/MuxMaster"
)
func main() {
mux := muxmaster.New()
mux.GET("/users/:id", func(w http.ResponseWriter, r *http.Request) {
id, err := muxmaster.ParamsFromContext(r.Context()).Int("id")
if err != nil {
http.Error(w, "invalid id", http.StatusBadRequest)
return
}
if err := muxmaster.JSON(w, http.StatusOK, map[string]int{"id": id}); err != nil {
log.Printf("write response: %v", err)
}
})
if err := http.ListenAndServe(":8080", mux); err != nil {
log.Fatal(err)
}
}
Read Getting started for the full walkthrough, or jump to the API reference.
Frequently asked questions
What is MuxMaster?
MuxMaster is a zero-dependency HTTP router for Go that uses a radix tree for O(k) route lookups and keeps full compatibility with the net/http Handler interface.
Static routes allocate nothing, parameterised routes make one allocation by default or none with the opt-in PoolRequestBundle, and the middleware package provides 21 middleware constructors.
What Go version does MuxMaster require?
MuxMaster v1.3.0 requires Go 1.27.1 or later, as declared by the go directive in its go.mod.
With the default GOTOOLCHAIN=auto, an older Go toolchain switches to Go 1.27.1 or newer automatically. See Compatibility for the version policy.
Does MuxMaster support the HTTP QUERY method?
Yes: MuxMaster has supported the HTTP QUERY method defined in RFC 10008 since v1.2.0, through MethodQuery and the QUERY, QUERYE, and QUERYFast registration methods.
The HTTP QUERY method (RFC 10008) guide shows how to register a QUERY route, validate its request body, and call it with curl.
Is MuxMaster compatible with net/http?
Yes: a *muxmaster.Mux implements http.Handler, handlers use the http.HandlerFunc signature, and middleware uses func(http.Handler) http.Handler.
Any code that accepts an http.Handler, such as http.Server or httptest.NewServer, accepts the router, so adoption can be incremental.
How fast is MuxMaster compared with other routers?
In this website's 2026-09-26 benchmark campaign, MuxMaster v1.3.0 was the fastest of five measured Go routers (MuxMaster, httprouter, bunrouter, chi, and gorilla/mux) in six of the eight route categories of the upstream competitor suite, and httprouter was the fastest on catch-all routes.
MuxMaster led on static, not-found, and parallel static routes in its default mode, on 1-parameter routes with HandleFast, and on 3-parameter and parallel 1-parameter routes with PoolRequestBundle; on 2-parameter routes, MuxMaster with PoolRequestBundle and httprouter showed no significant difference. MuxMaster's default mode was slower than httprouter on every parameterised route. The full data, host, and method are on the Benchmarks page.
What is the catch with PoolRequestBundle?
PoolRequestBundle recycles the per-request bundle through sync.Pool, so handlers must not retain *http.Request after they return, for example in a goroutine that outlives the handler.
Reverse proxies built on net/http.Transport and handlers that hijack the connection must keep the pool off. The Maximum performance guide lists the rules and an audit checklist.
What is MuxMaster's license?
MuxMaster is released under the MIT License.
The full text is in the upstream repository at LICENSE.