Blog Blog

R3namex: La Herramienta que Todo Red Teamer Necesita para Organizar Evidencia Digital

September 12, 2025
Tutorial
R3namex: La Herramienta que Todo Red Teamer Necesita para Organizar Evidencia Digital

Introducción

En el mundo de la ciberseguridad y la administración de sistemas, la organización eficiente de archivos es crucial. Ya sea que estés gestionando evidencia digital, organizando logs de seguridad, o simplemente manteniendo orden en grandes colecciones de archivos, r3namex es la herramienta que necesitas.

Desarrollada por mi, Fabian Peña (stuxboynet), r3namex es una potente utilidad de renombrado masivo de archivos que destaca por su funcionalidad de rollback completo, manejo inteligente de duplicados y procesamiento recursivo de carpetas.


¿Por qué r3namex es especial?

Características principales

  • 🔄 Rollback completo: Deshaz cualquier operación de renombrado con un solo comando
  • 🛡️ Manejo inteligente de duplicados: Múltiples estrategias para conflictos de nombres
  • 📁 Procesamiento recursivo: Maneja carpetas y subcarpetas automáticamente
  • 📝 Logging detallado: Rastrea todas las operaciones con timestamps
  • ⚡ Modo interactivo: Controla cada paso del proceso de renombrado
  • 🔢 Renumeración por rangos: Renumera rangos específicos de archivos


Instalación

La instalación de r3namex es extremadamente sencilla:

1# Clonar el repositorio
2git clone https://github.com/stuxboynet/r3namex.git
3cd r3namex
4
5# Verificar Python 3.6+
6python --version
7
8# ¡Listo para usar! No requiere dependencias externas


Casos de uso en ciberseguridad

1. Organización de evidencia digital

1# Renombrar capturas de pantalla de una investigación
2python r3namex.py -l /evidencia/capturas -a -p Evidencia_Caso_001_ -ns 1
3
4# Resultado:
5# screenshot1.png → Evidencia_Caso_001_1.png
6# IMG_234.jpg → Evidencia_Caso_001_2.jpg
7# captura.png → Evidencia_Caso_001_3.png

2. Gestión de logs de seguridad

1# Renumerar logs de firewall del mes
2python r3namex.py -l /logs/firewall -p fw_log -cs 1 -ce 31 -ns 100
3
4# fw_log1.txt → fw_log100.txt
5# fw_log31.txt → fw_log131.txt

3. Organización de reportes de vulnerabilidades

1# Modo interactivo para organizar reportes
2python r3namex.py -l /reportes/pentest -a


Opciones y parámetros

Argumentos principales

  • 📁 --location (-l): Ruta de la carpeta objetivo
  • 🟢 --all (-a): Modo interactivo para todos los archivos
  • 🏷️ --prefix (-p): Prefijo para los archivos
  • 🔢 --current-start (-cs): Inicio del rango actual
  • 🔚 --current-end (-ce): Final del rango actual
  • 🔄 --new-start (-ns): Nuevo número de inicio
  • ↩️ --rollback (-r): Revertir última operación
  • 📦 --duplicate-strategy (-ds): Estrategia para duplicados

Estrategias para duplicados

  • ask (por defecto): Pregunta por cada conflicto
  • skip: Omite archivos si el destino existe
  • suffix: Añade sufijo numérico (_1, _2, etc.)
  • backup: Respalda archivo existente antes de renombrar
  • overwrite: Reemplaza archivo existente (con respaldo oculto)


Ejemplos prácticos avanzados

Escenario 1: Reorganización de evidencia fotográfica

1# Estado inicial:
2# /caso_001/fotos/
3# ├── DSC0001.jpg
4# ├── IMG_234.jpg
5# ├── foto.jpg
6# └── smartphone/
7# ├── WhatsApp_001.jpg
8# └── Screenshot_002.png
9
10# Comando:
11python r3namex.py -l /caso_001/fotos -a -p Evidencia_Foto_ -ns 1
12
13# Resultado:
14# /caso_001/fotos/
15# ├── Evidencia_Foto_1.jpg
16# ├── Evidencia_Foto_2.jpg
17# ├── Evidencia_Foto_3.jpg
18# └── smartphone/
19# ├── Evidencia_Foto_4.jpg
20# └── Evidencia_Foto_5.png

Escenario 2: Renumeración de logs

1# Tienes: access_log_1.txt, access_log_2.txt, access_log_5.txt, access_log_8.txt
2# Quieres: access_log_1.txt, access_log_2.txt, access_log_3.txt, access_log_4.txt
3
4python r3namex.py -l /var/log/apache -p access_log_ -cs 1 -ce 8 -ns 1 -ds suffix

Funcionalidad de rollback

Una de las características más valiosas de r3namex es su capacidad de rollback completo:

1# Realizar rollback de la última operación
2python r3namex.py -l /mi/carpeta -r
3
4# El sistema restaura automáticamente todos los nombres originales

Archivos de control

  • logs.log: Historial detallado de operaciones
  • backup_mapping.json: Información para rollback (se elimina tras rollback exitoso)
  • .rename_backups/: Carpeta oculta con respaldos (cuando se usa estrategia backup)

Modo interactivo

El modo interactivo es perfecto para casos complejos:

1python r3namex.py -l /proyecto -a
2
3# Output:
4# Processing: MAIN FOLDER
5# Files in this folder: 10
6# > Do you want to set a new prefix? [Y/N]: Y
7# > Enter new prefix: Proyecto_Alpha_
8# > Start numbering from: 100
9#
10# Found 3 subfolder(s) with files:
11# 1. documentos (15 files)
12# 2. codigo (8 files)
13# 3. recursos (20 files)
14# Do you want to rename files in these subfolders? [Y/N]: Y

Medidas de seguridad

r3namex implementa múltiples capas de seguridad:

  • Confirmaciones: Siempre pregunta antes de ejecutar operaciones
  • Verificación de permisos: Comprueba permisos de escritura antes de iniciar
  • Previsualizaciones detalladas: Muestra todos los cambios antes de aplicarlos
  • Rollback completo: Toda operación puede deshacerse
  • Opciones de respaldo: Múltiples estrategias para prevenir pérdida de datos

Actualizaciones y versión

1# Verificar versión actual
2python r3namex.py -v
3
4# Buscar actualizaciones
5python r3namex.py -u
6# Verifica GitHub automáticamente y ofrece actualizar

Conclusión

He desarrollado r3namex como una herramienta indispensable para cualquier profesional de ciberseguridad que valore la organización, eficiencia y seguridad en el manejo de archivos. Su combinación de potencia, simplicidad y características de seguridad la convierten en la elección perfecta para:

  • Investigadores forenses digitales
  • Administradores de sistemas
  • Profesionales de red team
  • Analistas de seguridad
  • Cualquiera que maneje grandes volúmenes de archivos

La funcionalidad de rollback completo garantiza que nunca pierdas datos importantes, mientras que las múltiples estrategias para duplicados te dan el control total sobre el proceso de renombrado.


Enlaces útiles

¿Has probado r3namex en tus proyectos? 💻

Comparte tu experiencia en los comentarios 📝 y ayuda a otros profesionales de ciberseguridad a descubrir esta potente herramienta. 🔧

Fabian Peña (stuxboynet)

Fabian Peña (stuxboynet)

Consultor de Ciberseguridad

eCPPTv3| eWPTxv3 | eWPT | CEH Master v12 | CPTE | eJPTv2 | eJPTv1 | LINUX ESSENTIALS | LCSPC