https://github.com/sonodima/fakespot
Simple captive portal implementation, that redirects to a custom landing page when connecting to it.
https://github.com/sonodima/fakespot
Last synced: 3 months ago
JSON representation
Simple captive portal implementation, that redirects to a custom landing page when connecting to it.
- Host: GitHub
- URL: https://github.com/sonodima/fakespot
- Owner: sonodima
- Created: 2020-10-04T20:06:50.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-09-24T12:54:57.000Z (over 3 years ago)
- Last Synced: 2025-02-03T12:22:34.894Z (4 months ago)
- Language: JavaScript
- Homepage:
- Size: 226 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Fakespot 📡
> Easy to understand DNS server with captive portal trigger.
### How does it work?
* Creates one DNS server and one HTTP server.
* The HTTP server handles the webpage.
* The DNS server redirects the trigger urls to the target address of the HTTP server.
### Requirements
* A router that support DNS redirection to a local device and the creation of an hotspot without the password.
* Any device that can run node.js. We'll call it server from now on.
### How to setup
* Connect the server to the router via ethernet.
* Assign a static ip address to the server.
* Set the server's ip address as the DNS server in your router's settings.
* Install node.js and npm in the server.
* Clone this repository in a directory of the server.
* cd to the directory and run `npm install`.
* Start the DNS/HTTP servers with npm start.
You can set it to start on boot so every time the server gets rebooted it will run the program.
### Supported triggers
* iOS
* macOS
* Windows
* Ubuntu (maybe other distros with Gnome, I haven't tried)
* Android
* Google Chrome
* Firefox
## Author
👤 **sonodima**
* Github: [@sonodima](https://github.com/sonodima)