ZeroPulse

---

📋 Tabela de Conteúdo

• Visão Geral
• Funcionalidades
• Arquitetura
• Pré-requisitos
• Instalação
• Configuração
• Uso
• Documentação da API
• Segurança
• Estrutura do Projeto
• Desenvolvimento
• Contribuição
• Licença
• Agradecimentos
• Suporte

🎯 Visão Geral

ZeroPulse é uma plataforma abrangente de Comando e Controle (C2) projetada para gerenciamento e monitoramento remotos seguros. Ela utiliza a tecnologia Cloudflare Tunnel para fornecer conexões seguras e criptografadas sem expor sua infraestrutura à internet pública.

⚠️ Status de Desenvolvimento: Este projeto está atualmente em desenvolvimento ativo. Esta versão é uma versão demo/alpha e alguns recursos podem estar:

• Instáveis ou sujeitos a mudanças significativas
• Incompletos ou parcialmente implementados
• Em desenvolvimento ativo com atualizações frequentes

Recomendamos usar este software apenas para fins de teste e avaliação. Para uso em produção, aguarde uma versão estável ou use por sua conta e risco.

Destaques Principais

• 🔒 Seguro por Padrão: Autenticação interna, gerenciamento de sessão e sistema de token de API
• 🌐 Integração com Cloudflare: Gerenciamento contínuo de DNS e túneis via API da Cloudflare
• 🖥️ Gerenciamento Remoto: Suporte a WinRM e SSH com integração evil-winrm para shells interativos
• 📊 Interface Moderna: Interface React bonita e responsiva com integração de terminal em tempo real
• 🚀 Performance Otimizada: I/O não bloqueante, consultas de banco de dados otimizadas e prevenção de vazamento de memória
• 🖥️ Acesso a Shell Local: Shell local interativo via WebSocket com emulação de terminal em tempo real

✨ Funcionalidades

Capacidades Principais

• Gerenciamento de Túneis

  • Criar e gerenciar túneis Cloudflare
  • Configurar regras de ingresso (HTTP, HTTPS, TCP)
  • Gerenciamento automático de registros DNS
  • Gerenciamento de proxy de rota

• Execução Remota de Comandos

  • Executar comandos em sistemas Windows remotos via WinRM
  • Shell interativo com integração evil-winrm (autenticação por senha e hash NTLM)
  • Execução de comandos SSH e sessões interativas
  • Execução de scripts PowerShell
  • Rastreamento de histórico de comandos
  • Streaming de saída em tempo real
  • Painel de Controle de Módulos com execução dinâmica de módulos

• Área de Trabalho Remota

  • Detecção e gerenciamento de servidor VNC
  • Cliente de área de trabalho remota baseado na web noVNC
  • Suporte para sistemas Windows e Linux
  • Conexões seguras baseadas em túnel

• Sessão e Segurança

  • Autenticação baseada em JWT
  • Gerenciamento ativo de sessão
  • Sistema de token de API com permissões granulares
  • Lista negra e revogação de tokens
  • Controle de acesso baseado em funções (RBAC)

• Gerenciamento de DNS

  • Criação/atualização automática de registros DNS
  • Suporte para registros CNAME, A, AAAA
  • Configuração de proxy Cloudflare
  • Resolução de conflitos

• Acesso a Shell Local

  • Shell local interativo via WebSocket
  • Emulação de terminal em tempo real com xterm.js
  • Suporte a janela independente
  • I/O não bloqueante para desempenho ideal

• Sistema de Controle de Módulos

  • Carregamento dinâmico de módulos do banco de dados
  • Estrutura hierárquica (Categorias → Seções → Itens)
  • Mecanismo de template com substituição de variáveis
  • Integração com terminal interativo
  • Histórico de execução de comandos

⚙️ Pilha Tecnológica

Camada	Tecnologia	Propósito
Frontend	React 19, Redux Toolkit, React Router, TailwindCSS, xterm.js	Interface do usuário
Backend	FastAPI, Uvicorn	Servidor API
Database	SQLite (com consultas otimizadas e índices)	Persistência de dados
Authentication	JWT, python-jose	Autenticação baseada em token
Remote Execution	pywinrm, paramiko, evil-winrm	Integração WinRM e SSH
Terminal	xterm.js, WebSocket	Terminal interativo
External APIs	requests, cloudflare	Integração de serviços
Process Management	subprocess, asyncio, threading	Tarefas em segundo plano

📦 Pré-requisitos

Requisitos de Sistema

• SO: Linux (Ubuntu 20.04+, Debian 11+, ou qualquer distribuição Linux moderna)
• Python: 3.8 ou superior
• Node.js: 20.19.0+ ou 22.12.0+ (veja .nvmrc no diretório frontend)
• npm: Vem com Node.js
• Conta Cloudflare: Com token de API e ID da conta
• Ruby (opcional): Para suporte a evil-winrm (gem install evil-winrm)

Software Necessário```bash

Ubuntu/Debian

sudo apt update sudo apt install -y python3 python3-pip python3-venv git curl

Install Node.js 20+ (using nvm recommended)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash source ~/.bashrc nvm install 20.19.0 nvm use 20.19.0

Optional: Install Ruby for evil-winrm

sudo snap install ruby --classic gem install evil-winrm

Verify versions

python3 --version # Should be 3.8+ node --version # Should be 20.19.0+ or 22.12.0+ npm --version

## 🚀 Instalação

<div align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/7371/63f8299d6bb31aaa64c5e271f4e78bcb3ea94ef8ae7a2f1e2e3b6205552fb8b2.png" alt="Configuração da Instalação" />
  <p><em>Processo de Instalação - Configurando o ZeroPulse em um novo sistema</em></p>
</div>

### 1. Clone o Repositório```bash
git clone https://github.com/yourusername/zeropulse.git
cd zeropulse

2. Configuração do Backend```bash

Create virtual environment

python3 -m venv venv

Activate virtual environment

source venv/bin/activate

Upgrade pip

pip install --upgrade pip

Install dependencies

pip install -r requirements.txt

### 3. Configuração do Frontend```bash
cd frontend

# Check Node.js version (should be 20.19.0+ or 22.12.0+)
node --version

# If using nvm, switch to required version
nvm use  # Automatically uses version from .nvmrc

# Install dependencies
npm install

# Build frontend
npm run build

cd ..

4. Configurar Variáveis de Ambiente

Crie um arquivo .env na raiz do projeto:```bash cat > .env << EOF

Authentication Settings

ADMIN_USERNAME=admin ADMIN_PASSWORD=your-secure-password-here JWT_SECRET_KEY=$(python3 -c "import secrets; print(secrets.token_urlsafe(32))") JWT_ALGORITHM=HS256 JWT_EXPIRATION_HOURS=24

Cloudflare Settings

CLOUDFLARE_API_TOKEN=your-cloudflare-api-token-here CLOUDFLARE_ACCOUNT_ID=your-cloudflare-account-id-here CLOUDFLARE_DOMAIN=your-domain.com

WinRM Settings (optional)

WINRM_USERNAME=WinRMUser WINRM_PASSWORD=your-secure-password-here

SSH Settings (optional)

SSH_KEY_PATH=/path/to/ssh/key SSH_USERNAME=ssh_user