ESP32-S31 Guangdong Campus Network Authentication Program

ESP32 ESurfing — 天翼校园网 Auto-Authentication Client

A campus network auto-authentication tool ported to the ESP32 series based on ESurfingClient-CVersion.

Target Users

University students — Dormitory users of China Telecom 天翼校园网

Need auto-authentication — Router not convenient to flash / don’t want to tinker with OpenWrt, use ESP32 bypass authentication

ESP32 series enthusiasts — Have an ESP32-C3 or other ESP32 development board, support the latest ESP32-S31.

Features

✅ Auto-authentication — Automatically completes login when a captive portal redirect is detected

✅ Heartbeat keep-alive — Sends heartbeat at server-specified intervals to stay online

✅ Disconnection reconnection — WiFi automatically reconnects when disconnected, authentication failures automatically retry (unlimited)

✅ Web configuration backend — AP ESurfing-Config always on, configure via browser at http://192.168.4.1

✅ WiFi + campus network account — Both can be modified via web page, and the device automatically restarts after saving

✅ PCB antenna adaptation — TX power reduced for ESP32-C3 SuperMini (8.5 dBm)

✅ 7×24 hour operation — Runs on power, no maintenance required