freackygam35/safenet-ghana
GitHub: freackygam35/safenet-ghana
面向小型企业的开源集成安全系统，提供漏洞扫描、WiFi 入侵检测和 CCTV 监控能力，旨在以低成本方案替代昂贵的商业安全工具。
Stars: 0 | Forks: 0
# SafeNet Ghana 🇬🇭
由 **Patrick Idan** 开发 | 加纳通信科技大学 (GCTU) 学生 | 毕业设计项目
## 什么是 SafeNet Ghana？
加纳的大多数小型企业无法负担 Nessus 或 Cisco Umbrella 等企业级安全工具。SafeNet Ghana 是一个开源的集成安全系统，可为任何小型企业网络提供专业级的保护——支持通过 PC 和移动端访问。
## 模块
| 模块 | 状态 | 描述 |
|--------|--------|-------------|
| Vulnerability Scanner | ✅ 上线 | 扫描网络中的开放端口和已知漏洞 |
| WiFi Intrusion Detection | ✅ 开发中 | 检测恶意 AP、解除认证攻击和 ARP 欺骗 |
| CCTV Network Monitor | 🔨 开发中 | 监控 IP 摄像头流量，防止未经授权的访问 |
## 技术栈
- **后端** — Python + FastAPI
- **扫描引擎** — nmap + python-nmap
- **数据库** — PostgreSQL（即将推出）
- **Web 控制台** — React.js（即将推出）
- **移动应用** — Flutter（即将推出）
- **部署** — Docker + DigitalOcean（即将推出）
## 快速入门
### 前置条件
- Python 3.10+
- nmap 已安装并添加至 PATH → [nmap.org](https://nmap.org/download.html)
### 安装依赖
```
cd scanner
pip install -r requirements.txt
```
### 运行扫描器 (CLI)
```
python scanner.py
```
### 运行 API 服务器
```
python -m uvicorn api:app --reload --host 127.0.0.1 --port 8000
```
### 查看 API 文档
在浏览器中打开：`http://127.0.0.1:8000/docs`
## API 接口
| 方法 | 接口 | 描述 |
|--------|----------|-------------|
| GET | `/` | 系统信息 |
| GET | `/health` | 健康检查 |
| POST | `/scan` | 触发漏洞扫描 |
| GET | `/scans/history` | 所有历史扫描记录 |
| GET | `/scans/latest` | 最近一次扫描 |
| GET | `/scans/stats` | 控制台统计数据 |
### 扫描请求示例
```
POST /scan
{
"target": "192.168.1.1",
"scan_type": "basic"
}
```
## 项目路线图
- [x] Vulnerability Scanner 核心引擎
- [x] 带有 REST 接口的 FastAPI 后端
- [x] JSON 扫描报告
- [x] PostgreSQL 数据库集成
- [x] React.js Web 控制台
- [x] WiFi 入侵检测模块
- [x] CCTV 网络监控模块
- [ ] Flutter 移动应用
- [ ] Docker 部署
- [ ] Google Play Store 发布
## 许可证
MIT 许可证 — 可免费使用、修改和分发。
*SafeNet Ghana —— 为每一家企业提供安全防护，而不仅仅是大型企业。*
标签：API, AV绕过, CCTV监控, Docker, FastAPI, Flutter, Nmap, PostgreSQL, Python, React.js, WiFi入侵检测, 中小企业, 加纳, 安全系统, 安全防御评估, 插件系统, 无后门, 未授权访问, 模拟器, 欺骗攻击, 测试用例, 网络测绘, 自定义脚本, 虚拟驱动器, 请求拦截, 逆向工具, 集成安全