https://github.com/pericena/portscanner
Herramienta PortScanner - Análisis de Vulnerabilidades con Inteligencia Artificial
https://github.com/pericena/portscanner
nmap-scan nmap-scan-script openia termux termux-hacking
Last synced: 21 days ago
JSON representation
Herramienta PortScanner - Análisis de Vulnerabilidades con Inteligencia Artificial
- Host: GitHub
- URL: https://github.com/pericena/portscanner
- Owner: Pericena
- Created: 2024-12-29T23:28:14.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-28T00:51:45.000Z (12 months ago)
- Last Synced: 2026-01-15T18:41:12.064Z (3 months ago)
- Topics: nmap-scan, nmap-scan-script, openia, termux, termux-hacking
- Language: HTML
- Homepage: https://lpericena.blogspot.com/
- Size: 1.06 MB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# PortScanner - Análisis de Vulnerabilidades con Inteligencia Artificial
Bienvenido a **PortScanner**, una herramienta de análisis de vulnerabilidades de puertos desarrollada en Python con Flask, integrada con tecnologías avanzadas como OpenAI y Nmap. Este sistema web está diseñado para realizar escaneos profundos de puertos, identificar posibles vulnerabilidades, y generar reportes detallados. Funciona en Windows, Linux y Termux.
## Características Principales
- **Inteligencia Artificial**: Uso de OpenAI para analizar y clasificar las vulnerabilidades detectadas.
- **Integración con Nmap**: Escaneos potentes y fiables.
- **Compatibilidad Multiplataforma**: Funciona en Windows, Linux y Termux.
- **Sistema Web Interactivo**: Interfaz amigable y fácil de usar.
- **Reportes Detallados**: Generación de reportes en tiempo real con gráficos y análisis.
- **Código Abierto**: Totalmente gratuito y accesible.
---
## Capturas de Pantalla
### Panel Principal

### Reporte de Vulnerabilidades

---
## Instalación
### Requisitos Previos
1. Python 3.8 o superior
2. Flask
3. Nmap instalado en el sistema
4. Acceso a internet para utilizar OpenAI
### Instalación
1. Clona el repositorio:
```bash
git clone https://github.com/Pericena/PortScanner.git
cd PortScanner
```
2. Instala las dependencias:
```bash
pip install -r requirements.txt
```
Asegúrate de que `requirements.txt` incluye lo siguiente:
```text
Flask
nmap
openai
pyyaml
```
3. Configura las credenciales de OpenAI:
- Crea un archivo `.env` en el directorio raíz.
- Añade tu clave de API de OpenAI:
- https://cookbook.openai.com/
- https://platform.openai.com/settings/organization/general
- https://platform.openai.com/settings/organization/general
```
OPENAI_API_KEY=tu_clave_api
```
4. Inicia el servidor:
```bash
python app.py
```
5. Accede a la aplicación desde tu navegador en [http://localhost:5000](http://localhost:5000).
---
# Instrucciones para levantar el Docker
## Prerrequisitos
Asegúrate de que tienes Docker y Docker Compose instalados en tu máquina:
- [Docker](https://www.docker.com/)
- [Docker Compose](https://docs.docker.com/compose/)
---
## Pasos rápidos para levantar el proyecto
### 1. **Construir y correr el contenedor**
Desde la raíz del proyecto (donde están el `Dockerfile` y `docker-compose.yml`), ejecuta este comando:
```bash
docker-compose up -d
```
Este comando:
- Construirá la imagen Docker automáticamente.
- Levantará el contenedor y lo ejecutará en segundo plano.
---
### 2. **Acceder a la aplicación**
- Una vez levantado el contenedor, abre tu navegador y ve a:
**[http://localhost](http://localhost)**
---
### 3. **Detener el contenedor**
Para detener el contenedor, utiliza este comando:
```bash
docker-compose down
```
---
### 4. **Reiniciar el contenedor con cambios**
Si realizas modificaciones al código, reconstruye y reinicia el contenedor con:
```bash
docker-compose up -d --build
```
---
## Uso
1. Selecciona el rango de IP o dominio a analizar.
2. Configura las opciones de escaneo (puertos específicos, velocidad, etc.).
3. Ejecuta el escaneo y revisa los resultados.
4. Genera reportes detallados con un clic.
---
## Redes Sociales
- **Blog**: [lpericena.blogspot.com](https://lpericena.blogspot.com)
- **GitHub**: [Pericena](https://github.com/Pericena)
- **Twitter**: [@LuishinioP](https://twitter.com/LuishinioP)
---
## Licencia
Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo `LICENSE` para más detalles.
---
## Apoya el Proyecto
- Dale una ⭐ al repositorio para apoyar este proyecto.
- ¡Comparte con otros interesados en ciberseguridad y análisis de vulnerabilidades!
---
## Video de Demostración
[](https://www.facebook.com/reel/1695566091061439)
---
## Agradecimientos
Agradecemos a la comunidad de ciberseguridad y desarrolladores por el soporte continuo en herramientas de código abierto.