SantiBTW/port-scanner
GitHub: SantiBTW/port-scanner
一个纯 Python 实现的教育型命令行端口扫描工具，用于检测目标主机的 TCP 开放端口及服务信息。
Stars: 0 | Forks: 0
# 🔍 端口扫描器
使用 Python 开发的端口扫描器，仅出于**教育与道德**目的而开发。
## ⚠️ 法律声明
## 📋 描述
一款命令行工具，用于扫描目标 IP 或主机名的 TCP 端口，以检测哪些端口处于开放状态以及运行着哪些服务。适用于：
- 审计你自己的网络或服务器
- 学习 TCP/IP 连接的工作原理
- 了解系统暴露了哪些服务
## 🛠️ 技术栈
- Python 3.10+
- `socket` — TCP 连接
- `argparse` — 命令行接口
- `concurrent.futures` — 使用线程进行并行扫描
## 🚀 安装
无需外部依赖库。只需安装 Python 3 即可。
```
git clone https://github.com/tu-usuario/port-scanner.git
cd port-scanner
```
## 💻 使用方法
```
# 基础扫描（端口 1-1024）
python port_scanner.py 192.168.1.1
# 自定义范围扫描
python port_scanner.py 192.168.1.1 --inicio 1 --fin 65535
# 仅常见已知端口（更快）
python port_scanner.py mi-servidor.com --comunes
# 包含更多细节（服务的 banner）
python port_scanner.py 10.0.0.1 --verbose
# 调整速度（更多线程 = 更快、更嘈杂）
python port_scanner.py 192.168.1.1 --hilos 200 --timeout 0.5
```
## ⚙️ 选项
| 参数 | 描述 | 默认值 |
|-----------|-------------|---------|
| `host` | 目标 IP 或主机名 | 必填 |
| `--inicio` | 扫描的起始端口 | 1 |
| `--fin` | 扫描的结束端口 | 1024 |
| `--comunes` | 仅扫描常用端口 | False |
| `--timeout` | 每个端口的超时等待秒数 | 1.0 |
| `--hilos` | 并发线程数 (1-500) | 100 |
| `--verbose` | 显示服务 Banner 信息 | False |
## 📊 输出示例
```
=======================================================
PORT SCANNER — Uso educativo y ético
=======================================================
⚠️ Solo escanear hosts propios o con permiso.
=======================================================
[*] Inicio: 2026-03-31 14:22:10
[*] Escaneando 192.168.1.1 — puertos 1 al 1024
[ABIERTO] Puerto 22/tcp → SSH
[ABIERTO] Puerto 80/tcp → HTTP
[ABIERTO] Puerto 443/tcp → HTTPS
=======================================================
RESUMEN DEL ESCANEO
=======================================================
Host : 192.168.1.1 (192.168.1.1)
Puertos : 3 abiertos encontrados
Duración : 4.31 segundos
```
## 📁 项目结构
```
port-scanner/
├── port_scanner.py # Script principal
└── README.md # Este archivo
```
## 🤝 贡献
欢迎参与贡献！你可以提交 issue 或 pull request。
*教育项目 —— 我的 Python 安全工具作品集的一部分。*
标签：Awesome, Python, Qt框架, Socket编程, TCP/IP, 开源安全工具, 插件系统, 教育项目, 数据统计, 无后门, 服务识别, 端口扫描, 系统管理, 网络安全, 网络编程, 逆向工具, 逆向工程平台, 隐私保护