mirror of
https://github.com/openNDS/openNDS.git
synced 2026-05-04 03:01:32 -04:00
85 lines
2.9 KiB
ReStructuredText
85 lines
2.9 KiB
ReStructuredText
Installing Nodogsplash
|
|
######################
|
|
|
|
OpenWrt (LEDE)
|
|
*******
|
|
|
|
* Have a router working with OpenWrt. At the time of writing, Nodogsplash has been tested with OpenWrt/LEDE 17.01.4;
|
|
it may or may not work on older versions of OpenWrt or on other kinds of Linux-based router firmware.
|
|
* Make sure your router is basically working before you try to install
|
|
Nodogsplash. In particular, make sure your DHCP daemon is serving addresses on the interface that nodogsplash will manage.
|
|
The default is br-lan but can be changed to any interface by editing the /etc/config/nodogsplash file.
|
|
* To install Nodogsplash, you may use the OpenWrt Luci web interface or alternatively, ssh to your router and run the command:
|
|
|
|
``opkg update``
|
|
|
|
followed by
|
|
|
|
``opkg install nodogsplash`` (for version 1x).
|
|
|
|
or
|
|
|
|
``opkg install nodogsplash2`` (for version 2x).
|
|
|
|
* Nodogsplash is enabled by default and will start automatically on reboot or can be started and stopped manually.
|
|
|
|
|
|
* If the interface that you want Nodogsplash to manage is not br-lan,
|
|
edit /etc/config/nodogsplash and set GatewayInterface.
|
|
* To start Nodogsplash, run the following, or just reboot the router:
|
|
|
|
``/etc/init.d/nodogsplash start``
|
|
|
|
* To test the installation, connect a client device to the interface on your
|
|
router that is managed by Nodogsplash (for example, connect to the router's
|
|
wireless lan).
|
|
Most client device operating systems and browsers support Captive Portal Detection (CPD) and the operating system or browser on that device will attempt to contact a pre defined port 80 web page.
|
|
CPD will trigger Nodogsplash to serve the default splash page where you can click or tap Continue to access the Internet.
|
|
|
|
See the Authentication section for details of setting up a proper authentication process.
|
|
|
|
If your client device does not display the splash page it most likely does not support CPD. You should then manually trigger Nodogsplash by trying to access a port 80 web site (for example, google.com:80 is a good choice).
|
|
|
|
* To stop Nodogsplash:
|
|
|
|
``/etc/init.d/nodogsplash stop``
|
|
|
|
* To uninstall Nodogsplash:
|
|
|
|
``opkg remove nodogsplash``
|
|
|
|
Debian
|
|
******
|
|
|
|
There isn't a package in the repository (yet). But we have support for a debian package.
|
|
Requirements beside debian tools are:
|
|
|
|
- libmicrohttpd-dev (>= 0.9.51) [avaiable in **stretch**]
|
|
|
|
But you can also compile libmicrohttpd on your own if you're still running jessie or older.
|
|
|
|
|
|
``sudo apt-get install debhelper dpkg-dev dh-systemd libmicrohttpd-dev``
|
|
|
|
|
|
.. code::
|
|
|
|
apt-get install build-essential debhelper devscripts hardening-includes
|
|
|
|
Run this command in the repository root folder to create the package:
|
|
|
|
.. code::
|
|
|
|
dpkg-buildpackage
|
|
|
|
The package will be created in the parent directory.
|
|
|
|
|
|
Use this command if you want to create an unsigned package:
|
|
|
|
.. code::
|
|
|
|
dpkg-buildpackage -b -rfakeroot -us -uc
|
|
|
|
You will find the .deb packages in parent directory.
|