L-ubu/flipper-portals
GitHub: L-ubu/flipper-portals
一套面向 Flipper Zero 与 ESP32 的预制门户模板集合，用于快速搭建 WiFi 钓鱼测试场景。
Stars: 2 | Forks: 0
# 🐬 Flipper Portals
```
┌──────────────────────────────────────┐
│ FLIPPER PORTALS │
│ │
│ ╔═══════════════════╗ │
│ ║ 🔒 Free WiFi ║ │
│ ║ ┌───────────┐ ║ │
│ ║ │ Email │ ║ ← 🐬 │
│ ║ │ Password │ ║ │
│ ║ │ [CONNECT] │ ║ │
│ ║ └───────────┘ ║ │
│ ╚═══════════════════╝ │
└──────────────────────────────────────┘
```
## ⚠️ 免责声明
**仅用于授权的渗透测试和安全研究。** 仅在你拥有或明确获得书面许可的网络上使用这些工具。未经授权的凭证收集是非法的。作者不对滥用行为承担责任。
## 📦 内容包含
| 类别 | 数量 | 描述 |
|----------|-------|-------------|
| 🎨 **自定义** | 4 | 采用现代 UI 的手工制作门户 |
| 🇺🇸 **预制（美国）** | 26 | Google、Facebook、Apple、Microsoft、航空公司、ISP |
| 🇪🇺 **欧洲** | 124 | 航空公司、铁路、酒店、健身房、ISP、超市、品牌 |
| **总计** | **154** | 已准备好部署 |
### 自定义门户
| 门户 | 风格 | 最佳用途 |
|--------|-------|----------|
| `CafeWiFi` | 玻璃拟态深色主题与 Google SSO | 公共 WiFi、咖啡馆、共享办公 |
| `HotelGuest` | 豪华酒店（深色 + 金色） | 酒店、民宿、短租公寓 |
| `CoffeeShop` | 温暖大地色调，带新闻通讯订阅 | 咖啡店、面包房 |
| `CorporateWiFi` | 企业蓝色并带安全警告 | 办公网络、企业环境 |
### 欧洲门户（适合 EU 渗透测试）
- **航空公司**：Brussels Airlines、Ryanair、EasyJet、KLM、Lufthansa、Air France、British Airways、Turkish Airlines、SwissAir
- **铁路**：SNCB/NMBS（比利时铁路 🇧🇪）、Thalys、SNCF、Deutsche Bahn、NS（荷兰铁路）、National Rail、Renfe
- **酒店**：Hilton、Ibis、Novotel、Sheraton、Radisson、Best Western
- **快餐与咖啡**：McDonald's、Starbucks、KFC、Quick、Pizza Hut
- **超市**：Delhaize 🇧🇪、IKEA、Tesco
- **健身房**：Basic-Fit、Anytime Fitness、McFIT、Fitness First
- **ISP**：Proximus 🇧🇪、Vodafone、Deutsche Telekom、Orange、BT、Telefónica
- **品牌**：Apple、Nike、Coca-Cola、Red Bull、Carlsberg
- **WiFi 路由器**：TP-Link、NETGEAR、Linksys、Ubiquiti/UniFi、D-Link、Tenda、Apple AirPort
- **主题公园**：Walibi 🇧🇪、Efteling、Disneyland Paris
许多欧盟门户包含 **“忘记密码”** 变体以增强真实感。
## 🚀 快速开始
### 先决条件
- [Flipper Zero](https://flipperzero.one/) 搭配 WiFi 开发板
- [ESP32 Marauder](https://github.com/justcallmekoko/ESP32Marauder) 固件已刷入开发板
- [Marauder 配套应用](https://lab.flipper.net/apps/esp32_wifi_marauder) 已安装在 Flipper 上
### 1. 下载所有门户
```
git clone https://github.com/L_ubu/flipper-portals.git
cd flipper-portals
```
### 2. 预览门户
```
# 在浏览器中打开以查看外观
./deploy.sh preview custom/CafeWiFi.html
./deploy.sh preview european/Railway-Companies_SNCB-NMBS-\(Belgian-Rail\).html
```
### 3. 部署到 Flipper
```
# 使用自定义 AP 名称创建门户
./deploy.sh deploy custom/CafeWiFi.html "Free_Coffee_WiFi"
# 然后将暂存文件复制到 Flipper SD 卡：
# SD Card/apps_data/marauder/index.html
# SD Card/apps_data/marauder/ap.config.txt
```
### 4. 运行
1. 将 WiFi 开发板插入 Flipper 的 GPIO
2. 打开 **Apps > GPIO > ESP32 WiFi Marauder**
3. 运行：`evilportal -c start`
4. 受害者连接到你的 AP → 看到门户 → 输入凭证
5. 凭证会显示在串口输出中。停止扫描请使用 `stopscan`
## 🛠️ 部署工具
`deploy.sh` 脚本用于管理并部署门户：
```
./deploy.sh list # List all portals with sizes
./deploy.sh preview # Open in browser
./deploy.sh size # Check 20KB limit
./deploy.sh deploy [AP name] # Stage for Flipper transfer
./deploy.sh deploy-all # Stage ALL portals
./deploy.sh set-ap "WiFi Name" # Change AP name
```
## 📂 项目结构
```
flipper-portals/
├── portals/
│ ├── custom/ # 4 hand-crafted portal templates
│ ├── bigbrodude/ # 26 US-focused portals
│ └── european/ # 124 European brand portals
├── staging/ # Ready-to-deploy files for Flipper
├── configs/ # AP config files
├── deploy.sh # Deploy & management tool
├── download-portals.sh # Re-download premade portals
└── README.md
```
## 🎨 创建自定义门户
门户 HTML 文件必须满足以下要求：
- 为单个自包含的 `.html` 文件（不依赖外部资源）
- 表单使用 `
```
## 🗺️ 路线图
- [ ] 重新设计现有门户以更逼真、像素级还原
- [ ] 创建与现实世界中遇到的真实 captive portal 完全一致的副本
- [ ] 添加比利时特定门户（Telenet、De Lijn、Flixbus、大学门户）
- [ ] 移动端优先的响应式设计（大多数受害者通过手机连接）
- [ ] 添加“成功”重定向页面（登录后界面以增强真实感）
- [ ] 门户生成器脚本 —— 输入品牌名称/颜色/logo SVG，输出门户
- [ ] 尺寸优化器，自动压缩超过 20KB 的门户
- [ ] 在 README 中为每个门户提供截图画廊
## 📄 许可证
MIT —— 随意使用，但不要作恶（虽然这有点讽刺意味）。
标签：Cutter, ESP32, Flipper Zero, ISP门户, SEO, UI模板, WiFi钓鱼, 二进制发布, 代码生成, 企业WiFi, 免费WiFi, 凭证收集, 后端开发, 咖啡馆门户, 品牌克隆, 响应式网页, 多模态安全, 应用安全, 开源工具, 欧洲品牌, 渗透测试工具, 物理渗透, 现代UI, 玻璃态设计, 社会工程, 网络模拟, 美国品牌, 自定义门户, 航空公司门户, 邪恶门户, 部署工具, 酒店门户