Andrainarivo/Scanner
GitHub: Andrainarivo/Scanner
一款基于Flask和Celery的异步端口扫描REST API，将Nmap网络探测能力封装为易于集成的Web服务。
Stars: 0 | Forks: 0
# Scanner
一个高性能的 REST API，使用 **python3-nmap**、**Flask**、**Celery**/**Redis** 异步执行 Nmap 扫描。
## 主要特性
* **异步架构**：长时间运行的扫描不会阻塞 API。
* **增强安全性**：以非 root 用户运行，同时通过 **Linux Capabilities** 保留必要的网络特权。
* **多技术支持**：支持 SYN 扫描、TCP Connect、UDP 和 FIN 扫描。
* **主机发现**：专用的 ARP 和 Ping 发现模块。
* **容器化**：基于 Docker Compose 的开箱即用部署方案。
## 入门指南
### 前置条件
* Docker CE
### 安装与运行
```
# Clone the repository
git clone https://github.com/Andrainarivo/Scanner.git
cd Scanner
# Build and start the stack
docker compose up -d --build
```
API 访问地址为：`http://0.0.0.0:5000`
## 📖 API 文档
### 1. 主机发现
`POST /discover`
```
{
"targets": "192.168.1.0/24",
"method": "arp",
"args": "--min-rate 1000"
}
```
### 2. 端口扫描
`POST /scan`
```
{
"targets": "scanme.nmap.org",
"ports": "80,443,22",
"techniques": ["syn", "tcp"],
"args": "-A"
}
```
### 3. 检查状态/结果
`GET /status/`
### 4. 健康检查
`GET /health`
## 技术栈
* **语言**：Python 3.12
* **框架**：Flask
* **任务队列**：Celery + Redis
* **扫描器**：Nmap
* **容器**：Docker
标签：API服务, Celery, CTI, DNS解析, Docker, Docker Compose, Facebook API, Flask, Linux Capabilities, Nmap, Python, Redis, REST API, SYN扫描, TCP扫描, Web安全, 域名解析, 安全防御评估, 开源项目, 异步任务, 插件系统, 搜索引擎查询, 数据统计, 无后门, 端口扫描, 网络安全, 蓝队分析, 虚拟驱动器, 请求拦截, 逆向工具, 隐私保护