156 lines
3.8 KiB
Markdown
156 lines
3.8 KiB
Markdown
# CBS CyberScan - Escaner Web Antivirus
|
|
|
|
<p align="center">
|
|
<img src="https://condorbs.net/favicon.ico" alt="CBS Logo" width="50"/>
|
|
</p>
|
|
|
|
## Descripción
|
|
CBS CyberScan es una aplicación web que proporciona un servicio de escaneo de archivos y URLs en tiempo real. Utiliza ClamAV como motor de análisis antivirus y ofrece una interfaz moderna y cibernética para una experiencia de usuario mejorada.
|
|
|
|
## Características Principales
|
|
- 🔍 Escaneo de archivos locales
|
|
- 🌐 Análisis de archivos desde URLs
|
|
- 🔄 Verificación de hashes (MD5, SHA1, SHA256)
|
|
- 💾 Almacenamiento de resultados en base de datos
|
|
- ⚡ Interfaz en tiempo real con WebSockets
|
|
- 📊 Estadísticas detalladas de escaneo
|
|
- 🎯 Detección y conteo de amenazas
|
|
|
|
## Requisitos del Sistema
|
|
- Python 3.8+
|
|
- MySQL/MariaDB
|
|
- ClamAV
|
|
- Navegador web moderno
|
|
|
|
## Dependencias Principales
|
|
```plaintext
|
|
Flask==3.0.2
|
|
flask-socketio==5.3.6
|
|
python-dotenv==1.0.1
|
|
mysql-connector-python==8.3.0
|
|
filetype==1.2.0
|
|
requests==2.31.0
|
|
```
|
|
|
|
## Instalación
|
|
|
|
1. Clonar el repositorio:
|
|
```bash
|
|
git clone https://condorcs.net/mrhacker/cbs-web-antivirus-scanner.git
|
|
cd cbs-web-antivirus-scanner
|
|
```
|
|
|
|
2. Crear y activar entorno virtual:
|
|
```bash
|
|
python -m venv venv
|
|
|
|
# En Linux/Mac:
|
|
source venv/bin/activate
|
|
|
|
# En Windows:
|
|
.\venv\Scripts\activate
|
|
```
|
|
|
|
3. Instalar dependencias:
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
4. Configurar la base de datos:
|
|
```sql
|
|
CREATE DATABASE cbswebscan;
|
|
USE cbswebscan;
|
|
|
|
CREATE TABLE file_scans (
|
|
id INT AUTO_INCREMENT PRIMARY KEY,
|
|
filename VARCHAR(255),
|
|
md5_hash VARCHAR(32),
|
|
sha1_hash VARCHAR(40),
|
|
sha256_hash VARCHAR(64),
|
|
file_type VARCHAR(50),
|
|
scan_result TEXT,
|
|
scan_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
);
|
|
```
|
|
|
|
5. Configurar variables de entorno:
|
|
Crear archivo `.env`:
|
|
```plaintext
|
|
DB_HOST=localhost
|
|
DB_USER=your_username
|
|
DB_PASSWD=your_password
|
|
DB_NAME=cbswebscan
|
|
DB_CHARSET=utf8mb4
|
|
DB_COALLITION=utf8mb4_unicode_ci
|
|
```
|
|
|
|
## Uso
|
|
|
|
1. Iniciar el servidor:
|
|
```bash
|
|
python app.py
|
|
```
|
|
|
|
2. Acceder a la aplicación:
|
|
Abrir en el navegador: `http://localhost:5000`
|
|
|
|
## Historial de Versiones
|
|
|
|
### v2.0.0 (Actual)
|
|
|
|
- Interfaz completamente rediseñada con estilo cibernético
|
|
- Sistema de escritura tipo terminal
|
|
- Panel de estadísticas en tiempo real
|
|
- Efectos visuales y animaciones mejoradas
|
|
- Mejor manejo de amenazas y resultados
|
|
|
|
### v1.0.0
|
|
|
|
- Primera versión estable
|
|
- Funcionalidades básicas de escaneo
|
|
- Interfaz simple y funcional
|
|
|
|
## Estructura del Proyecto
|
|
```plaintext
|
|
cbs-cyberscan/
|
|
├── app.py # Aplicación principal
|
|
├── requirements.txt # Dependencias del proyecto
|
|
├── .env # Variables de entorno
|
|
├── static/ # Archivos estáticos
|
|
├── templates/ # Plantillas HTML
|
|
│ └── index.html # Interfaz principal
|
|
└── README.md # Documentación
|
|
```
|
|
|
|
## Seguridad
|
|
- Los archivos se escanean en un entorno aislado
|
|
- Verificación de hashes para evitar escaneos duplicados
|
|
- Limpieza automática de archivos temporales
|
|
- Validación de tipos de archivo y URLs
|
|
|
|
## Contribuir
|
|
1. Fork del repositorio
|
|
2. Crear rama para nueva característica (`git checkout -b feature/nueva-caracteristica`)
|
|
3. Commit de cambios (`git commit -am 'Agregar nueva característica'`)
|
|
4. Push a la rama (`git push origin feature/nueva-caracteristica`)
|
|
5. Crear Pull Request
|
|
|
|
## Screenshots
|
|
|
|
Para agregar capturas de pantalla de nuevas versiones:
|
|
1. Crear carpeta `screenshots` si no existe
|
|
2. Nombrar las imágenes siguiendo el formato `vX.X.X.png`
|
|
3. Actualizar la sección "Historial de Versiones" de este README
|
|
|
|
|
|
## Autores
|
|
- Kevin Muñoz
|
|
|
|
## Soporte
|
|
Para reportar problemas o solicitar ayuda:
|
|
- Crear un issue en GitHub
|
|
- Contactar a helpdesk@condorbs.net
|
|
|
|
---
|
|
Desarrollado con ❤️ por Kevin Muñoz
|