Gestor de shells inversas multisessión con actualización a PTY, módulos de post-explotación, tunelización de capa 3, ofuscación de payloads para evasión de EDR, registro de sesiones y un servidor MCP para control impulsado por LLM.
Descubre las herramientas más usadas por nuestra comunidad.
Sin datos de popularidad aún.
Este proyecto es mi intento de crear un manejador de shells rápido, fácil de usar (y a la vez repleto de funciones) con una interfaz atractiva.
Aviso: ten en cuenta que esto todavía está en desarrollo, y sigo trabajando en algunas de las funciones clave, mencionadas en esta sección.
✨ Funciones | 🚧 En desarrollo | 🚀 Instalación | 💻 Uso | 🔧 Actualización a PTY | 🤖 Módulos | 🧠 MCP
La documentación completa está en la wiki.
[!TIP] Esta demostración se ejecuta con un sistema operativo en Docker. Si quieres probarlo tú mismo, puedes usar las imágenes de Ubuntu o el dockur para Windows.
script/socat, Windows mediante ConPtyShell ofuscado) para autocompletado con tabulador, reenvío de Ctrl+C y redimensionamiento de terminal.connect ssh user@host convierte credenciales que ya posees en una sesión. ssh solo entrega el payload, por lo que la shell sigue viva después de que ssh finalice.tunnel start <id> <cidr> convierte una shell en un pivote de Capa 3: una pila TCP en espacio de usuario en el objetivo (sin root, sin binario desplegado, solo Python) con las rutas en tu lado. (docs)koireview. (docs)Ctrl+Z envía la sesión a segundo plano, Ctrl+C envía SIGINT al remoto, nunca mata tu listener por accidente.[!NOTE] ¡Ahora es posible usar Koi de forma remota! Lee más aquí
# Recommended: stable release from PyPI
pipx install koi-handler
# From source if you want to dev your own modules
git clone https://github.com/b3rt1ng/koi
cd koi
pipx install --editable .
koifuscator es el atajo directo al módulo ofuscador.
koireview es tu forma de ver los registros de tus sesiones.
Para actualizar:
pipx upgrade koi-handler
Más detalles en Getting Started.
# Default: bind 0.0.0.0:4010
koi
# Custom host/port
koi --host 10.10.14.5 --port 9001
koi -p 9001
Una vez dentro, help enumera todos los comandos. La referencia completa está en la Referencia de la CLI, y el manejo de sesiones (etiquetas, ejecución en segundo plano, modo screenable) en Gestión de sesiones.
Envía una reverse shell por tu cuenta o escribiendo payloads *interface* para obtener payloads pregenerados. Ten en cuenta que debe ser una shell de terminal, ya que Koi manipula shs de linux, powershells y cmd.
Koi incluye un ofuscador de payloads integrado para ayudar a evadir la detección de Windows Defender. Puedes encadenar varias técnicas, aunque la codificación XOR y las transformaciones de formato suelen ser suficientes. Ten en cuenta que apilar demasiadas capas puede corromper el payload y hacerlo ilegible para el objetivo.
El ofuscador también funciona para payloads de Linux. Aunque la mayoría de los entornos Linux no ejecutan software antivirus, los one-liners de bash suelen ser marcados por soluciones EDR, reglas IDS o monitorizados por equipos azules que vigilan patrones conocidos de reverse shell. Ofuscar tu payload ayuda a pasar desapercibido en algunos entornos endurecidos.
Cada técnica y cada tipo de payload compatible se enumeran en Payloads y Ofuscación.
Las shells sin procesar carecen de soporte de terminal adecuado: sin autocompletado con tabulador, Ctrl+C roto, salida distorsionada. El comando upgrade soluciona esto:
koi> upgrade 1
Shell #1 upgraded successfully.
koi> go 1
# now a full PTY with proper terminal behaviour
se genera un pty de Python simple
python3 -c 'import pty; pty.spawn("/bin/bash")'
con TERM=xterm-256color y algo de información de redimensionamiento
No me molesté en hacer uno para CMD, pero para powershell la técnica utiliza un conptyshell ofuscado para obtener un shell completamente implementado:
1) ConPtyShell is fetched from GitHub and cached locally for offline reuse
2) All IOC identifiers are renamed to random strings (class names, method names, PS function name)
3) Distinctive C# string literals are replaced with runtime char-array constructions (no literal in compiled MSIL)
4) The obfuscated script is served over a temporary HTTP server
5) The invocation command is base64-encoded (-EncodedCommand) with IEX and IWR obfuscated via random split techniques (concat / format string / char-array), so no plaintext cmdlet names appear on the command line
6) The target connects back with a fully interactive PTY shell, registered as a new session