Neura Market
liudf0716/apfree-wifidog logo

liudf0716/apfree-wifidog

Free

apfree-wifidog is a high-performance captive portal solution that serves as a gateway between your wireless networks and the Internet. Optimized for both HTTP and HTTPS traffic, it ensures secure border control while enabling seamless user authentication and efficient network management. 技术交流QQ群 331

FreeFree tier
Type
Open Source
Visit Website GitHub (38 stars)

About liudf0716/apfree-wifidog

ApFree WiFiDog is an open-source, high-performance captive portal solution optimized for HTTP and HTTPS traffic on the OpenWrt platform. It serves as a network gateway ensuring secure user authentication and efficient network management. Built with libevent2 and epoll, it offers superior speed and concurrency. Features include full HTTPS redirection, real-time WebSocket and MQTT long connections, flexible local/cloud authentication, dynamic rule management (MAC, IP, domains), eBPF-based traffic control DPI, and a LuCI web interface. It is actively maintained with a responsive community and supports cloud and splash-page authentication modes.

Key Features

Stable API-based iptables integration, thread-safe
Fast – Built with libevent2 + epoll, far outperforms original WiFiDog
Secure – Full HTTPS redirection support
Real-time – Long connection support (WebSocket, MQTT)
Flexible – Local + Cloud authentication and splash page mode
Dynamic Rules – Manage MAC, IP, domains without restart
eBPF Support – Traffic control DPI via eBPF
Active Community – Fast responses and continuous updates
LuCI Web Interface integration for easy configuration

Pros & Cons

Pros
  • High performance suitable for high-concurrency environments
  • Optimized specifically for OpenWrt and embedded routers
  • Full HTTPS redirection ensures security for all traffic
  • Real-time capabilities via WebSocket/MQTT for live status
  • Flexible authentication: local splash or cloud with custom auth server
  • Dynamic rule changes (MAC, IP, domain) without service restart
  • eBPF support for advanced traffic control and DPI
  • Open source (free) with active community and quick updates
Cons
  • Primarily designed for OpenWrt, may not work on other platforms
  • Requires technical knowledge to set up and configure
  • Cloud authentication mode requires an external auth server
  • Limited out-of-the-box features without LuCI integration addon
  • eBPF features depend on kernel and hardware support

Best For

Public Wi-Fi hotspot authentication and captive portalCloud-based authentication for Wi-Fi networksLocal splash page (click-to-continue) for guest networksEnterprise network access control with dynamic rulesOpenWrt router firmware with integrated captive portal

FAQ

What is ApFree WiFiDog?
It is an open-source, high-performance captive portal solution for HTTP and HTTPS, tailored for the OpenWrt platform. It provides secure authentication, high concurrency handling, and flexible rule management for Wi-Fi networks.
How do I install ApFree WiFiDog on OpenWrt?
On the latest OpenWrt, run 'apk update && apk add apfree-wifidog'. On older OpenWrt, use 'opkg update && opkg install apfree-wifidog'. A LuCI web interface is available via 'luci-app-apfree-wifidog'.
What authentication modes are supported?
It supports cloud authentication (requires an external auth server) and local splash page mode (no external server needed). You can configure both via LuCI or configuration files.
How can I troubleshoot no redirection?
Check the GatewayInterface, firewall rules, and DNS settings. Increase debug level by setting 'DaemonLogLevel 7' in wifidogx.conf and view logs with 'logread'.