esp_wifi_repeater is a WiFi NAT router and L2 bridge implementation for ESP8266 and ESP8285 microcontrollers.
The project solves the problem of extending WiFi coverage and creating isolated networks on resource-constrained devices. It implements network address translation to forward IP traffic transparently between a connected uplink network and local stations, requiring no routing configuration on either side. Stations receive DHCP addresses from a local subnet and DNS resolution from the uplink network. The tool also includes packet filtering with access control lists, port mapping, traffic shaping, MQTT management, GPIO interaction, and power management features. A newer L2 bridge mode provides true repeater functionality without NAT overhead, while the standard NAT router edition retains advanced networking capabilities.
The project suits developers building range extenders, battery-powered mesh networks, guest networks, IoT device isolation, or WiFi traffic analysis tools. It achieves approximately 5 Mbps throughput in both directions, supporting streaming use cases. The web installer enables direct flashing without command-line tools. Typical deployments include translating WPA2 Enterprise networks to WPA-PSK, setting up restricted networks for IoT devices, and conducting network experiments with routing and traffic control. The README identifies an ESP32 variant as the advanced option for that platform and references an Arduino integration library for projects requiring NAT as a component rather than a standalone device.
Development activity shows consistent maintenance with incremental feature additions over an extended period. The project recently introduced true L2 bridge repeater functionality while preserving backward compatibility with the existing NAT router implementation. Configuration options are accessible through both a simplified web interface and a full console interface. The tool includes a web-based installer for streamlined deployment without requiring local development environments.
