apfree-wifidog

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.

View project on GitHub
ApFree WiFiDog Logo

License PRs Welcome Issues Welcome Release Version OpenWRT Join the QQ Group

English Version 中文版本

ApFree WiFiDog: A High-Performance Captive Portal Solution for HTTP(S)

ApFree WiFiDog is an open-source, high-performance captive portal solution for HTTP and HTTPS, specifically designed for authenticating users on wireless networks operating on the OpenWrt platform. It boasts the capability to handle high concurrency and traffic volumes seamlessly.

Introduction Videos

ApFree WiFiDog Introduction Video

Why Choose ApFree WiFiDog?

  1. Stability: Employing API-based iptables rules, it enhances stability in multithreaded environments.
  2. Performance: Built on libevent2 with epoll support, it significantly outperforms the original WiFiDog.
  3. HTTPS Support: Ensures secure HTTPS redirection, aligning with modern web security standards.
  4. Long Connection Support: Accommodates long connections, including WebSocket and MQTT, for real-time communication.
  5. Flexible Authentication: Offers both local and cloud-based authentication methods, catering to diverse user needs.
  6. Advanced Rules Management: Enables dynamic management of access rules, including MAC address and IP/domain management, without requiring restarts.

LuCI Integration

For simplified configuration, ApFree WiFiDog includes a LuCI interface. Manage your settings easily through a user-friendly web interface via the luci-app-apfree-wifidog repository.

Using ApFree WiFiDog in Cloud Auth Mode

To operate ApFree WiFiDog in cloud auth mode, you must first establish an authentication server. Once set up, configure ApFree WiFiDog to connect to your server by specifying its IP address or domain in the configuration file.

Building the Auth Server

You can build your authentication server using the official server provided by the ApFree WiFiDog developers, known as WWAS. Unfortunately, WWAS is no longer maintained, as I am currently focused on a closed version called AWAS. If you need assistance, please feel free to contact me to discuss private service options.

Important Note on SSL Certificates: When redirecting HTTPS requests, the SSL certificate presented by the captive portal may trigger untrusted warnings on client devices. This is typical behavior for captive portal solutions and can be safely ignored by users who can proceed past the warning.

How to Contribute

We welcome contributions to ApFree WiFiDog! You can create issues or submit pull requests on our GitHub repository. Please review our CONTRIBUTING.md to ensure your contributions align with the project standards.

Contact Us

Join our QQ group for discussions and support: 331230369.