wifidog/wifidog-auth-laravel

Wifidog Auth (Laravel 11)

镜像概述和主要用途

该镜像提供wifidog认证服务器功能，遵循https://github.com/wifidog/wifidog-auth-laravel/wiki%EF%BC%8C%E7%94%A8%E4%BA%8EWiFi%E7%83%AD%E7%82%B9%E7%9A%84%E7%94%A8%E6%88%B7%E8%AE%A4%E8%AF%81%E7%AE%A1%E7%90%86%E3%80%82%E9%80%9A%E8%BF%87%E8%AF%A5%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E5%8F%AF%E5%AE%9E%E7%8E%B0%E5%AF%B9%E8%BF%9E%E6%8E%A5WiFi%E7%9A%84%E7%94%A8%E6%88%B7%E8%BF%9B%E8%A1%8C%E7%99%BB%E5%BD%95%E9%AA%8C%E8%AF%81%E3%80%81%E6%9D%83%E9%99%90%E6%8E%A7%E5%88%B6%E7%AD%89%E6%93%8D%E4%BD%9C%E3%80%82

核心功能和特性

页面功能

• /login：用户登录页面
• /logout：用户登出页面
• /portal：门户页面
• /messages 或 gw_message.php：消息展示页面

API接口

• /ping：心跳检测接口
• /auth：认证接口

使用场景和适用范围

适用于需要通过wifidog协议进行用户认证的WiFi网络环境，如公共WiFi热点、企业内部WiFi、校园WiFi等场景，实现对连接设备的认证和访问控制。

详细使用方法和配置说明

Docker部署

SQLite数据库配置

shell
docker run -p 8000:80 \
    --env APP_NAME="Wifidog Auth" \
    --env APP_ENV=local \
    --env APP_KEY=base64:silhtn4zkyodaaDIRSU0QEqq4CwKfjdzLqZectaHIi8= \
    --env DB_CONNECTION=sqlite \
    docker.xuanyuan.run/wifidog/wifidog-auth-laravel

启动后访问 http://127.0.0.1:8000 即可使用。

MySQL数据库配置

shell
docker run -p 8000:80 \
    --env APP_NAME="Wifidog Auth" \
    --env APP_ENV=local \
    --env APP_KEY=base64:silhtn4zkyodaaDIRSU0QEqq4CwKfjdzLqZectaHIi8= \
    --env DB_CONNECTION=mysql \
    --env DB_HOST=172.17.0.1 \
    --env DB_PORT=3306 \
    --env DB_DATABASE=wifidog \
    --env DB_USERNAME=root \
    --env DB_PASSWORD=1 \
    docker.xuanyuan.run/wifidog/wifidog-auth-laravel

关键环境变量说明

Wifidog配置（OpenWrt路由器）

基础配置

1. 登录OpenWrt路由器，添加认证服务器IP到/etc/hosts：

   shell
   ssh root@192.168.1.1
   echo "192.168.1.42 wifidog-auth" >> /etc/hosts  # 替换为实际认证服务器IP
   /etc/init.d/dnsmasq restart
   

2. 修改/etc/wifidog.conf配置认证服务器和可信MAC：

   txt
   AuthServer {
       Hostname wifidog-auth.lan  # 与hosts中配置的主机名一致
       Path /
   }
   TrustedMACList 00:00:DE:AD:BE:AF  # 替换为允许的设备MAC
   

3. 重启wifidog服务：

   shell
   /etc/init.d/wifidog restart
   sleep 10
   /etc/init.d/wifidog status  # 检查服务状态
   

连接WiFi后访问HTTP网站，将显示认证登录页面，登录/注册后即可访问网络。

社交登录配置（以***为例）

1. 配置认证服务器

在.env中添加***登录参数：

ini
FACEBOOK_APP_ID=123456  # 替换为实际App ID
FACEBOOK_APP_SECRET=secret  # 替换为实际App Secret
FACEBOOK_VALID_OAUTH_REDIRECT_URI="http://wifidog-auth.lan/login/facebook/callback"  # 替换为实际回调URL
AUTH_SOCIAL_LOGIN_PROVIDERS="Facebook"

2. 配置路由器

安装必要组件并配置ipset：

shell
ssh root@192.168.1.1
opkg update
opkg install dnsmasq-full
echo "ipset create facebook hash:ip" >> /etc/firewall.user
echo "ipset=/facebook.com/fbcdn.net/facebook" >> /etc/dnsmasq.conf
fw3 reload
/etc/init.d/dnsmasq restart

修改/etc/wifidog.conf添加防火墙规则：

txt
FirewallRuleSet unknown-users {
    FirewallRule allow to-ipset facebook
}

若路由器不支持ipset，可直接添加域名规则（可靠性较低）：

txt
FirewallRuleSet global {
    FirewallRule allow tcp to www.facebook.com
    FirewallRule allow tcp to m.facebook.com
    FirewallRule allow tcp to static.xx.fbcdn.net
}

重启wifidog服务：

shell
/etc/init.d/wifidog restart

调试方法

1. 认证服务器调试：检查访问日志和错误日志，通常位于/var/log/apache2/目录。
2. Wifidog调试：编辑/usr/bin/wifidog-init，将"start"部分的"wifidog $OPTIONS"修改为"wifidog -f -d 9"以开启详细调试模式。

技术栈

• PHP框架：https://laravel.com/
• 编码标准：遵循PSR-12，可通过./lint.sh检查
• 单元测试：使用PHPUnit，执行php artisan test运行测试