Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

WiFi Captive Portal detection program


When you connect to a WiFi network e.g. hotels or in public places, there will generally be a Captive portal page asking you for authorization information. If you don't get authorized in the portal page, you will not be able to use the Internet.

When you use a WiFi router to connect to such networks, there are more things to deal with in order to let the portal page pop up correctly. You need to:

  • Disable all VPN connections in the router.
  • Disable DNS rebind protection. This is generally true but not for all portal.
  • Disable DNS encryption. In GL.iNet routers there are CloudFlare DNS.

But if you use the router to protect data privacies, when you do the above, your data will be leaked.

This program is used to solve this problem by manipulating the firewall without disabling your VPN and DNS protection manually while not leaking your data.

How it works

The program tries to detect if there is any WiFi portal page. If there is, it will allow the portal page to pass firewall and DNS encryption so that it will pop up in your client device connected to the router. After you authorize via the portal the firewall policy will be restored.

Testing firmware URL

GL.iNet AR750S


How to use

You can enable the service by executing the following command from the command line

uci set'1'
uci commit portal-detect
/etc/init.d/portal-detect restart

You can also enable it in the luci page.Its location is in admin-->network-->portal-detect.


This program requires the following three pakages.

libcares libcurl dnsmasq-full

How to compile

First, we need curl to use libcares for asynchronous DNS resolution.patch

diff --git a/package/network/utils/curl/Makefile b/package/network/utils/curl/Makefile
index db72640..ba857b8 100644
--- a/package/network/utils/curl/Makefile
+++ b/package/network/utils/curl/Makefile
@@ -89,6 +89,7 @@ define Package/libcurl
   DEPENDS += +LIBCURL_SSH2:libssh2 +LIBCURL_NGHTTP2:libnghttp2
+  DEPENDS += libcares
   TITLE:=A client-side URL transfer library
@@ -104,7 +105,7 @@ TARGET_LDFLAGS += -Wl,--gc-sections
        --disable-debug \
-       --disable-ares \
+       --enable-ares \
        --enable-shared \
        --enable-static \
        --disable-manual \

Then,select packages

-*- libcares.. Library for asyncronous DNS Requests (including name resolves)
-*- curl.................................. A client-side URL transfer utility
<*> dnsmasq-full
<*> gl-portal-detect................. Repeater automatically detect portal AP

Then compile the package

make  ./package/portal-detect/compile


opkg install gl-portal-detect


If that doesn't work, you might want to recompile curl and install it because it needs to support libares

You can’t perform that action at this time.