Skip to content

A captive portal for the NodeMCU ESP8266 with a dashboard, multy language support, password validation and a deauthing function.

License

Notifications You must be signed in to change notification settings

heinzguenter/ESP8266-Captive-Portal

Repository files navigation

ESP8266 Captive Portal

Introduction

This Captive Portal Provides Multiple Languages, a Dashboard to view and change all settings in one place, password validation that is still a little bit buggy and doesnt always work and a deauthing function(while the ESP is deauthing the websites will be unresponsive). This project is a proof of concept for testing and educational purposes. Use it only against networks and devices that you have permission to! If you have any questions or suggestions just create an issue or DM me on Discord under the username heinzguenter.

Currently Supportet languages: English and German.

Credits: Spacehuhn for inspiration on the Design of the dashboard, adamff-dev for the idea and inspiration for the design of the captive portal pages, sankethj for inspiration for parts of the code and justcallmekoko without theire projects this would probably not exist.

Screenshots

192.168.1.1/ Here the User gets informed that there is an "error" and puts in there Password.

192.168.1.1/restarting This page is displayed after a Password is submitted

192.168.1.1/dashboard Here you can change the Language, SSID and view your captured Passwords

Logs of every action are printed on the serial connection

Usage

Simple

  1. Upload the binary file or to your ESP8266 device.
  2. Connect to the ESP8266's Wi-Fi network (default SSID is "Portal-Update").
  3. Open a web browser, and type in "192.168.1.1/dashboard" to get to the dashboard or "192.168.1.1" for the page that a normal user would see.
  4. There you can view the captured passwords and edit the SSID and other settings.

Advanced

  1. Download and add Spacehuhn's custom board to your IDE(you can follow this guide)
  2. Change or add things if you want
  3. Connect your ESP8266 to your PC and chose the right port and Board for you
  4. Press the upload button and wait for it to complete
  5. Open a web browser, and type in "192.168.1.1/dashboard" to get to the dashboard or "192.168.1.1" for the page that a normal user would see.