yaoweibin/nginx_tcp_proxy_module

Health v2 · maintenance only

Flags: no_releases no_license

Adoption not part of the score

1645 stars · 347 forks observed · 2026-08-28

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

A third-party Nginx module written in C that adds TCP proxying capabilities to Nginx, including upstream load balancing with ip_hash, active health checks, and a status monitor endpoint. It is frequently used for WebSocket reverse proxying and general TCP load balancing.

Use cases

• proxy raw TCP traffic through nginx
• load balance non-HTTP services with nginx
• health check upstream TCP servers
• monitor backend status via an HTTP endpoint
• reverse proxy websocket connections
• ip hash based session persistence for TCP upstreams

When to choose

• you need TCP-level proxying with nginx and cannot use nginx stream module (older nginx versions)
• you want built-in active health checks and a status page for TCP upstreams
• you need websocket reverse proxying on legacy nginx

When to avoid

• you run a modern nginx with the built-in stream module
• you need a maintained solution with active development and a license
• you only need HTTP reverse proxying

Facets

plugin · maturity maintenance

proxy networking monitoring load-testing networking web-development infrastructure-as-code c nginx-module tcp-proxy health-check websocket-proxy load-balancing reverse-proxy devops linux nginx

Member repositories

For agents

markdown · JSON · MCP: product_card(name="yaoweibin/nginx_tcp_proxy_module")