humitos / pyfispot

Hotspot running with Python 2.7 + Flask + nginx + uWSGI + dnsmasq + hostapd

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

PyFi Spot

PyFi Spot is a HotSpot (Captive Portal) to be ran in a RaspberryPi.

There is a lot of information about Captive Portals on the Internet but none of them is complete. That's why I wrote PyFi Spot -the definitive guide.

PyFi Spot

How it works?

  1. The user gets connected to the WiFi network
  • if he is connected via a Smartphone, a notification is shown in his phone
  1. The user enters a URL in the browser
  2. He is redirected to our portal
  • this is done by using some iptables rules
  1. Our portal is shown
  • nginx + uwsgi + python 2.7 + flask
  1. The user logs in into the portal
  2. A new iptable rule is executed to allow him use the connection

Homepage

Requirements

NOTE: click on each link to read their docs.

Optional

This was meant to be used in courses and other events organized by the project Argentina en Python, so there are some other services offered by the RaspberryPi server.

Notes

  • There is no official release yet, although the code is working properly (I should have bugs -I'm sure).
  • It was tested in a Django Girls Workshop at PyCon Argentina with more that 50 users. Yes, it worked, but the wireless connection was really congested. On the other hand, the RaspberryPi with ArchLinux ARM worked without any problem.

References

Authors

Manuel Kaufmann (https://twitter.com/reydelhumo)

License

GNU GENERAL PUBLIC LICENSE Version 2

About

Hotspot running with Python 2.7 + Flask + nginx + uWSGI + dnsmasq + hostapd

License:GNU General Public License v2.0


Languages

Language:JavaScript 75.2%Language:CSS 17.7%Language:HTML 3.2%Language:Shell 2.1%Language:Lua 1.1%Language:Python 0.7%