117 lines
3.0 KiB
Markdown
117 lines
3.0 KiB
Markdown
|
# 🕸️ URLf4ck3r 🕵️♂️
|
|||
|
|
|
|||
|
|
> Repositorio original: [URLf4ck3r](https://github.com/n0m3l4c000nt35/urlf4ck3r)
|
|||
|
|
|
|||
|
|
URLf4ck3r es una herramienta de reconocimiento diseñada para escanear y extraer URLs del código fuente de sitios web.
|
|||
|
|
|
|||
|
|
📝 **Tabla de contenidos**
|
|||
|
|
- [🕸️ URLf4ck3r 🕵️♂️](#️-urlf4ck3r-️️)
|
|||
|
|
- [🚀 Características principales](#-características-principales)
|
|||
|
|
- [📋 Requisitos](#-requisitos)
|
|||
|
|
- [🛠️ Instalación](#️-instalación)
|
|||
|
|
- [💻 Uso](#-uso)
|
|||
|
|
- [Con docker](#con-docker)
|
|||
|
|
- [Construir la imagen de Docker](#construir-la-imagen-de-docker)
|
|||
|
|
- [Ejecutar el contenedor](#ejecutar-el-contenedor)
|
|||
|
|
- [Ejecutar con Docker Compose:](#ejecutar-con-docker-compose)
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 🚀 Características principales
|
|||
|
|
|
|||
|
|
- 🔍 Escaneo recursivo de URLs
|
|||
|
|
- 🌐 Detección de subdominios
|
|||
|
|
- ✍️ Detección de palabras sensibles en los comentarios
|
|||
|
|
- 🔗 Clasificación de URLs absolutas y relativas
|
|||
|
|
- 💠 Detección de archivos JavaScript
|
|||
|
|
- 🎨 Salida colorida para una fácil lectura
|
|||
|
|
- ⏱️ Interrumpible en cualquier momento
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 📋 Requisitos
|
|||
|
|
|
|||
|
|
- Python 3.x
|
|||
|
|
- Bibliotecas: `requests`, `beautifulsoup4`, `pwntools` (Ver en el fichero [requirements.txt](requirements.txt))
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 🛠️ Instalación
|
|||
|
|
|
|||
|
|
1. Descarga esta carpeta
|
|||
|
|
2. Instalá las dependencias:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3. Haz el script ejecutable:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
chmod +x urlf4ck3r.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
4. Para ejecutar el script desde cualquier ubicación:
|
|||
|
|
|
|||
|
|
- Mueve el script a un directorio que esté en el PATH, por ejemplo:
|
|||
|
|
```
|
|||
|
|
sudo mv urlf4ck3r.py /usr/bin/urlf4ck3r
|
|||
|
|
```
|
|||
|
|
- O añade el directorio del script al PATH editando el archivo `.bashrc` o `.zshrc`:
|
|||
|
|
```
|
|||
|
|
echo 'export PATH=$PATH:/ruta/al/directorio/de/urlf4ck3r' >> ~/.bashrc
|
|||
|
|
source ~/.bashrc
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 💻 Uso
|
|||
|
|
|
|||
|
|
Si seguiste el paso 4 de la instalación, puedes ejecutar el script desde cualquier ubicación simplemente con:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
urlf4ck3r -u <URL> -o output.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
De lo contrario, desde el directorio donde se encuentra ubicado el script:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
./urlf4ck3r.py -u <URL> -o output
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Ejemplo:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
urlf4ck3r -u https://ejemplo.com -o output.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Con docker
|
|||
|
|
|
|||
|
|
### Construir la imagen de Docker
|
|||
|
|
|
|||
|
|
Para construir la imagen desde el Dockerfile, navega al directorio donde se encuentra tu Dockerfile y ejecuta el siguiente comando:
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
docker build -t urlf4ck3r .
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Ejecutar el contenedor
|
|||
|
|
|
|||
|
|
Después de construir la imagen, puedes ejecutar tu script dentro de un contenedor de la siguiente manera:
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
docker run --rm urlf4ck3r -u https://ejemplo.com -o output.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
El flag --rm asegura que el contenedor se elimina automáticamente después de que se complete su ejecución.
|
|||
|
|
|
|||
|
|
|
|||
|
|
### Ejecutar con Docker Compose:
|
|||
|
|
|
|||
|
|
En la línea de comandos, navega hasta el directorio donde guardaste estos archivos.
|
|||
|
|
|
|||
|
|
Ejecuta el siguiente comando para construir la imagen y ejecutar el contenedor usando Docker Compose:
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
docker-compose up --build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Esto ejecutará urlf4ck3r y generará el archivo output.txt en el directorio ./output de tu máquina local.
|
|||
|
|
|