liudf0716/apfree_wifidog
FreeA hight performance and lightweight captive portal solution for HTTP(s)
FreeFree tier
About liudf0716/apfree_wifidog
ApFree WiFiDog is an open-source, high-performance captive portal solution for HTTP(s) designed for the OpenWrt platform. It authenticates users on wireless networks, handling high concurrency and traffic volumes. The solution supports both HTTP and HTTPS protocols and integrates with an external authentication server (wwas) for SMS verification and user management. It includes keep-alive and counter v2 processes for ongoing session validation and statistics collection. Note: This repository was archived by the owner on Mar 23, 2023 and is read-only.
Key Features
High-performance captive portal supporting HTTP and HTTPS
Optimized for OpenWrt platform
Handles high concurrency and high traffic volumes
Integrates with external authentication server (wwas) for SMS verification
Keep-alive mechanism to maintain authenticated sessions
Counter v2 process for user statistics and online/offline management
Pros & Cons
Pros
- High performance capable of handling many concurrent users
- Open source (free to use and modify)
- Supports both HTTP and HTTPS for secure redirection
- Designed specifically for OpenWrt, a popular embedded Linux platform
- Integrates with external auth servers for flexible authentication methods like SMS
Cons
- Repository archived and no longer maintained (read-only as of March 2023)
- Designed primarily for OpenWrt, limiting use on other platforms
- Requires setting up an external authentication server (wwas) for full functionality
- Documentation is primarily in Chinese (README diagrams and notes use Chinese characters)
Best For
Public Wi-Fi hotspot authentication on OpenWrt routersCaptive portal for wireless networks requiring user verification via SMSHigh-traffic enterprise or community Wi-Fi deploymentsIntegration with custom authentication backends (wwas)
FAQ
What is ApFree WiFiDog?
ApFree WiFiDog is an open-source, high-performance captive portal solution for HTTP(s) used to authenticate users on wireless networks, especially on OpenWrt platforms.
What platforms does it support?
It is designed for the OpenWrt platform, an embedded Linux distribution for routers.
How does user authentication work?
The router intercepts HTTP/HTTPS requests and redirects users to an external authentication server (wwas). Users may authenticate via SMS verification, and the server maintains sessions with keep-alive and counter processes.