如何为SSID搭建强制重定向门户并实现连接后自动跳转至指定本地PHP项目页面

阿华AIGC实验室

2026-4-17

首先得明确，要实现这个需求，核心是搭建一个带强制门户（Captive Portal）功能的无线接入点（AP），让连接该SSID的设备自动被引导到你的PHP项目页面。下面分步骤给你讲具体怎么实现：

一、选择合适的硬件/软件平台

最稳定的方案是用支持OpenWrt的路由器（比如小米部分型号、TP-Link兼容机型，或者树莓派+无线网卡），因为OpenWrt对Captive Portal的支持成熟且配置灵活。如果暂时没有额外硬件，也可以用电脑搭建软AP，但功能受限较多，这里优先讲OpenWrt的方案。

二、配置无线AP（创建专属SSID）

登录OpenWrt管理后台（默认一般是192.168.1.1），进入网络 > 无线页面。
点击“添加”创建新的无线接口：
- 设置SSID名称（比如MyProjectPortal），这就是设备能搜到的网络名称。
- 安全选项可设为“无加密”（方便测试）或WPA2-PSK（设置简单密码）。
- 给这个AP分配独立IP段（比如192.168.2.0/24），避免和现有家庭网络冲突。

三、安装并配置Captive Portal服务（Nodogsplash）

OpenWrt里最常用的轻量Captive Portal工具是Nodogsplash，步骤如下：

进入系统 > 软件包，搜索并安装nodogsplash。
用SSH登录OpenWrt，编辑配置文件：
```
vi /etc/config/nodogsplash
```
修改核心配置项：
- option redirecturl 'http://192.168.0.41/myserver'：替换成你的PHP项目地址。
- option gatewayinterface 'wlan0'：填写你刚创建的无线接口名称（可在无线页面查看）。
- 可添加允许跳过验证的IP（比如你的PHP项目服务器）：
```
list allowed_ip '192.168.0.41'
```
重启服务生效：
```
/etc/init.d/nodogsplash restart
```

四、配置DNS劫持（确保设备自动触发跳转）

大部分设备连接网络后，会自动访问固定域名（比如captive.apple.com、connectivitycheck.gstatic.com）检测网络可用性。我们需要劫持这些请求到AP的IP，让设备自动打开门户页面：

编辑dnsmasq配置文件：
```
vi /etc/dnsmasq.conf
```

添加以下内容（覆盖常见检测域名）：

address=/captive.apple.com/192.168.2.1
address=/connectivitycheck.gstatic.com/192.168.2.1
address=/www.msftconnecttest.com/192.168.2.1
address=/nmcheck.gnome.org/192.168.2.1

这里的192.168.2.1是新AP的网关IP，要和之前设置的网段对应。

重启dnsmasq服务：
```
/etc/init.d/dnsmasq restart
```

五、测试验证

用手机或其他设备搜到MyProjectPortal SSID并连接。
设备应该会自动弹出浏览器并跳转到你的PHP项目页面；如果没自动弹出，手动打开浏览器随便输入一个网址，也会被重定向过去。

其他替代方案（无OpenWrt硬件时）

如果暂时没有合适的路由器，也可以试试这些方法，但稳定性不如OpenWrt：

Windows软AP+简易门户：用netsh命令创建软AP，再用Python写一个简单的HTTP服务器，监听80端口将所有请求重定向到你的项目地址。不过这种方法需要手动处理DNS劫持，对不同设备兼容性较差。
第三方工具：比如Connectify Hotspot的付费版本，自带Captive Portal功能，可直接设置重定向URL。