Ymsniper/RRW
GitHub: Ymsniper/RRW
一个基于强制门户的 Wi‑Fi 演示项目，通过播放 Rick Roll 视频来展示 captive portal 行为，适用于授权的安全教育与实验室场景。
Stars: 17 | Forks: 2
# RRW — Rick Roll Wifi
RRW 是一个 Wi‑Fi 强制门户（captive portal）演示项目，适用于授权的安全实验室、课堂练习以及在明确许可下进行的无恶意恶作剧。
## 概述
本项目会呈现一个网络登录页面，并在用户与页面交互后播放全屏的 Rick Astley 视频。它仅适用于您已获得明确授权测试或演示强制门户行为的受控环境。
## 仅限教育与授权使用
请仅在您拥有或被允许测试的环境中使用此项目。
请勿用于：
- 未经同意拦截流量
- 冒充公共或私人网络
- 收集凭据或个人数据
- 破坏第三方设备或网络
## 功能
- 自定义强制门户风格的登录页面
- 适配移动端的布局
- 可配置的 SSID 和频道
- 用于实验室用途的本地日志记录
- 退出时易于清理
## 环境要求
### 系统软件包
Debian / Ubuntu / Kali：
```
sudo apt update
sudo apt install hostapd dnsmasq iptables python3 iw
```
### 硬件
支持接入点（Access Point）模式的 Wi‑Fi 适配器。
使用以下命令检查是否支持：
```
iw list | grep -A 10 "Supported interface modes"
```
在输出中查找 `* AP`。
## 使用说明
1. 克隆仓库：
```
git clone https://github.com/Ymsniper/RRW.git
cd RRW
```
2. 配置视频路径：
将 `RRW.py` 中的 `VIDEO_PATH` 设置为您的 `rickroll.mp4` 文件所在的路径。
3. 以 root 身份运行脚本：
```
sudo python3 RRW.py
```
4. 按照提示操作：
- 输入 Wi‑Fi 名称
- 选择适配器
- 启动演示
5. 停止演示：
按下 `Ctrl+C` 以清理后台服务并恢复系统状态。
## 配置
`RRW.py` 中的常用设置：
- `VIDEO_PATH`：Rick Roll 视频的路径
- `SSID`：默认的 Wi‑Fi 名称
- `CHANNEL`：Wi‑Fi 频道
## 注意事项
- 某些设备在强制门户演示中可能会显示连接警告。
- 在 iOS / Safari 上，媒体播放可能需要直接的用户手势触发。
- 如果启用日志，日志将本地存储以供实验室使用。
## 许可证
MIT 许可证。详情请参见 `LICENSE` 文件。
## 依赖文件
本项目使用标准的 Python 3 库以及上面列出的系统依赖项。
## 概述
本项目会呈现一个网络登录页面，并在用户与页面交互后播放全屏的 Rick Astley 视频。它仅适用于您已获得明确授权测试或演示强制门户行为的受控环境。
## 仅限教育与授权使用
请仅在您拥有或被允许测试的环境中使用此项目。
请勿用于：
- 未经同意拦截流量
- 冒充公共或私人网络
- 收集凭据或个人数据
- 破坏第三方设备或网络
## 功能
- 自定义强制门户风格的登录页面
- 适配移动端的布局
- 可配置的 SSID 和频道
- 用于实验室用途的本地日志记录
- 退出时易于清理
## 环境要求
### 系统软件包
Debian / Ubuntu / Kali：
```
sudo apt update
sudo apt install hostapd dnsmasq iptables python3 iw
```
### 硬件
支持接入点（Access Point）模式的 Wi‑Fi 适配器。
使用以下命令检查是否支持：
```
iw list | grep -A 10 "Supported interface modes"
```
在输出中查找 `* AP`。
## 使用说明
1. 克隆仓库：
```
git clone https://github.com/Ymsniper/RRW.git
cd RRW
```
2. 配置视频路径：
将 `RRW.py` 中的 `VIDEO_PATH` 设置为您的 `rickroll.mp4` 文件所在的路径。
3. 以 root 身份运行脚本：
```
sudo python3 RRW.py
```
4. 按照提示操作：
- 输入 Wi‑Fi 名称
- 选择适配器
- 启动演示
5. 停止演示：
按下 `Ctrl+C` 以清理后台服务并恢复系统状态。
## 配置
`RRW.py` 中的常用设置：
- `VIDEO_PATH`：Rick Roll 视频的路径
- `SSID`：默认的 Wi‑Fi 名称
- `CHANNEL`：Wi‑Fi 频道
## 注意事项
- 某些设备在强制门户演示中可能会显示连接警告。
- 在 iOS / Safari 上，媒体播放可能需要直接的用户手势触发。
- 如果启用日志，日志将本地存储以供实验室使用。
## 许可证
MIT 许可证。详情请参见 `LICENSE` 文件。
## 依赖文件
本项目使用标准的 Python 3 库以及上面列出的系统依赖项。标签：AP模式, Captive Portal, Dnsmasq, Hostapd, Iptables, Pyton3, Rickroll, SSID配置, WiFi钓鱼, 中间人攻击演示, 安全演示, 强制门户, 恶搞工具, 无线热点, 网络安全实验室