soheilhy/cmux

Health v2 · maintenance only

Adoption not part of the score

2767 stars · 206 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

cmux is a Go library that multiplexes TCP connections based on their payload, allowing multiple protocols like gRPC, HTTP, HTTPS, and SSH to be served on the same port. It matches the first bytes of each connection and routes it to the appropriate protocol-specific listener.

Use cases

• serve grpc and http on the same port
• multiplex multiple protocols on one tcp listener
• run ssh and https behind a single port
• route connections by protocol payload in go
• expose rest and grpc apis on one endpoint
• share a port between multiple go servers

When to choose

• you need to serve multiple protocols on a single port behind a firewall or load balancer
• you want to combine gRPC and HTTP/REST on one endpoint in Go
• you need lightweight protocol sniffing with negligible overhead on long-lived connections

When to avoid

• you need http.Request.TLS populated in handlers for HTTPS
• a single connection must switch between protocols mid-stream
• you use Java gRPC clients and cannot use MatchWithWriters

Facets

library · maturity maintenance

networking middleware http-server rpc networking backend developer-tools apis go cross-platform connection-multiplexing tcp grpc protocol-matching single-port

Member repositories

For agents

markdown · JSON · MCP: product_card(name="soheilhy/cmux")