MikeWang000000/Natter

Health v2 · maintenance only

Adoption not part of the score

2206 stars · 180 forks observed · 2026-08-28

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

Natter is a Python CLI tool that exposes local TCP/UDP ports behind a full-cone NAT to the public Internet by discovering the external mapped address via STUN and keeping the mapping alive. It supports multiple forwarding methods (iptables, nftables, socat, gost, socket), UPnP/IGD discovery, and Docker deployment.

Use cases

• expose a local web server behind NAT to the internet
• make a game server reachable without port forwarding
• share a self-hosted service when behind full-cone NAT
• punch through NAT for P2P connections
• forward a local port using iptables on a router
• keep a NAT port mapping alive with STUN keep-alives

When to choose

• you are behind a full-cone NAT and want a public endpoint without router access
• you need a lightweight dependency-free Python tool for NAT hole punching
• you want to expose TCP or UDP services with automatic keep-alive and address-change notification

When to avoid

• you are behind symmetric NAT or CGNAT where hole punching fails
• you need a full VPN or tunnel solution like WireGuard or frp
• you require guaranteed stable public ports

Facets

cli-tool · maturity active

networking proxy developer-tools networking self-hosted privacy python cli cross-platform nat-traversal hole-punching full-cone-nat stun port-forwarding upnp p2p linux macos docker

Member repositories

For agents

markdown · JSON · MCP: product_card(name="MikeWang000000/Natter")