CyberPhish — Instalación y Uso

🎣

Instalación de CyberPhish

Instalación limpia con entorno virtual Python en Ubuntu / Debian

CyberPhish se instala mediante entorno virtual Python (venv) para aislar sus dependencias del sistema operativo. Esto evita conflictos con otros paquetes y hace la instalación completamente limpia y reversible.

⚠️ Uso ético: CyberPhish es una herramienta de auditoría de seguridad. Úsala únicamente en entornos controlados y con autorización explícita. Su uso en sistemas ajenos sin permiso es ilegal.

Actualizar sistema e instalar dependencias críticas

Antes de nada, asegúrate de tener las herramientas necesarias para crear entornos virtuales y manejar Python.

bash

sudo apt update && sudo apt upgrade -y
sudo apt install python3-full python3-pip git -y

Clonar el repositorio

Si ya tienes la carpeta CyberPhish, entra directamente en ella con cd CyberPhish. Si no, clónala desde GitHub:

bash

git clone https://github.com/Cyber-Dioxide/CyberPhish
cd CyberPhish

Crear el entorno virtual

Esto crea una carpeta llamada env dentro de CyberPhish donde se guardarán todas las librerías sin tocar el sistema operativo.

bash

python3 -m venv env

ℹ️ La carpeta env/ contiene su propio intérprete Python y pip aislados. Los paquetes instalados dentro no afectan al Python del sistema.

Activar el entorno virtual

Notarás que tu terminal ahora muestra (env) al principio de la línea. Debes hacer esto cada vez que quieras usar la herramienta.

bash

source env/bin/activate

Antes y después de activar el venv:

sin venv jose@ubuntu:~/CyberPhish$

(env) jose@ubuntu:~/CyberPhish$

Instalar los requerimientos

Con el entorno activo, pip funcionará perfectamente sin errores de sistema. Instala todas las dependencias listadas en requirements.txt:

bash — con venv activo

pip install -r requirements.txt

💡 Si intentas pip install sin el venv activo en Ubuntu 24.04, recibirás el error "externally-managed-environment". El venv resuelve esto completamente.

Ejecutar la herramienta

Con el entorno activo, lanza el script principal:

bash — con venv activo

python3 CyberPhish.py

✅ Instalación completada. Para salir del entorno virtual cuando termines, ejecuta deactivate.

⚡

Referencia Rápida

Comandos esenciales para el uso diario

🔁 Flujo de uso cada vez que quieras ejecutar CyberPhish

1 cd CyberPhish entrar al directorio

2 source env/bin/activate activar venv → (env)

3 python3 CyberPhish.py ejecutar herramienta

4 deactivate salir del venv al terminar

📜

Script de Instalación Completo

Todos los pasos en un solo bloque — copiar y pegar

bash — instalación completa de CyberPhish

# 1. Actualizar sistema e instalar dependencias
sudo apt update && sudo apt upgrade -y
sudo apt install python3-full python3-pip git -y

# 2. Clonar el repositorio
git clone https://github.com/Cyber-Dioxide/CyberPhish
cd CyberPhish

# 3. Crear el entorno virtual
python3 -m venv env

# 4. Activar el entorno virtual
source env/bin/activate

# 5. Instalar dependencias
pip install -r requirements.txt

# 6. Ejecutar CyberPhish
python3 CyberPhish.py