ZeroPulse

---

📋 Indice

• Panoramica
• Caratteristiche
• Architettura
• Prerequisiti
• Installazione
• Configurazione
• Utilizzo
• Documentazione API
• Sicurezza
• Struttura del Progetto
• Sviluppo
• Contributi
• Licenza
• Riconoscimenti
• Supporto

🎯 Panoramica

ZeroPulse è una piattaforma completa di Command & Control (C2) progettata per la gestione e il monitoraggio remoto sicuro. Sfrutta la tecnologia Cloudflare Tunnel per fornire connessioni sicure e crittografate senza esporre la tua infrastruttura a internet pubblico.

⚠️ Stato di sviluppo: Questo progetto è attualmente in sviluppo attivo. Questa versione è una release demo/alpha e alcune funzionalità potrebbero essere:

• Instabili o soggette a modifiche sostanziali
• Incomplete o parzialmente implementate
• In fase di sviluppo attivo con aggiornamenti frequenti

Consigliamo di utilizzare questo software solo per scopi di test e valutazione. Per un uso in produzione, attendere una release stabile o utilizzarlo a proprio rischio.

Punti salienti

• 🔒 Sicuro per impostazione predefinita: Autenticazione integrata, gestione delle sessioni e sistema di token API
• 🌐 Integrazione Cloudflare: Gestione fluida di DNS e tunnel tramite API Cloudflare
• 🖥️ Gestione remota: Supporto WinRM e SSH con integrazione evil-winrm per shell interattive
• 📊 UI moderna: Interfaccia React bella e reattiva con integrazione terminale in tempo reale
• 🚀 Ottimizzato per le prestazioni: I/O non bloccante, query di database ottimizzate e prevenzione delle perdite di memoria
• 🖥️ Accesso alla shell locale: Shell locale interattiva tramite WebSocket con emulazione di terminale in tempo reale

✨ Caratteristiche

Funzionalità principali

• Gestione dei tunnel

  • Creare e gestire i tunnel Cloudflare
  • Configurare le regole di ingresso (HTTP, HTTPS, TCP)
  • Gestione automatica dei record DNS
  • Gestione del proxy di route

• Esecuzione remota di comandi

  • Eseguire comandi su sistemi Windows remoti tramite WinRM
  • Shell interattiva con integrazione evil-winrm (autenticazione tramite password e hash NTLM)
  • Esecuzione di comandi SSH e sessioni interattive
  • Esecuzione di script PowerShell
  • Tracciamento della cronologia dei comandi
  • Streaming dell'output in tempo reale
  • Pannello di controllo dei moduli con esecuzione dinamica dei moduli

• Desktop remoto

  • Rilevamento e gestione dei server VNC
  • Client desktop remoto noVNC basato sul web
  • Supporto per sistemi Windows e Linux
  • Connessioni sicure basate su tunnel

• Sessione e sicurezza

  • Autenticazione basata su JWT
  • Gestione delle sessioni attive
  • Sistema di token API con permessi granulari
  • Blacklist e revoca dei token
  • Controllo degli accessi basato sui ruoli (RBAC)

• Gestione DNS

  • Creazione/aggiornamento automatico dei record DNS
  • Supporto per record CNAME, A, AAAA
  • Configurazione del proxy Cloudflare
  • Risoluzione dei conflitti

• Accesso alla shell locale

  • Shell locale interattiva tramite WebSocket
  • Emulazione di terminale in tempo reale con xterm.js
  • Supporto per finestra autonoma
  • I/O non bloccante per prestazioni ottimali

• Sistema di controllo dei moduli

  • Caricamento dinamico dei moduli dal database
  • Struttura gerarchica (Categorie → Sezioni → Elementi)
  • Motore di template con sostituzione delle variabili
  • Integrazione con terminale interattivo
  • Cronologia dell'esecuzione dei comandi

⚙️ Stack Tecnologico

Livello	Tecnologia	Scopo
Frontend	React 19, Redux Toolkit, React Router, TailwindCSS, xterm.js	Interfaccia utente
Backend	FastAPI, Uvicorn	Server API
Database	SQLite (con query e indici ottimizzati)	Persistenza dei dati
Autenticazione	JWT, python-jose	Autenticazione basata su token
Esecuzione remota	pywinrm, paramiko, evil-winrm	Integrazione WinRM e SSH
Terminale	xterm.js, WebSocket	Terminale interattivo
API esterne	requests, cloudflare	Integrazione dei servizi
Gestione dei processi	subprocess, asyncio, threading	Attività in background

📦 Prerequisiti

Requisiti di sistema

• Sistema operativo: Linux (Ubuntu 20.04+, Debian 11+ o qualsiasi distribuzione Linux moderna)
• Python: 3.8 o superiore
• Node.js: 20.19.0+ o 22.12.0+ (vedi .nvmrc nella directory frontend)
• npm: Incluso con Node.js
• Account Cloudflare: Con token API e ID account
• Ruby (opzionale): Per il supporto evil-winrm (gem install evil-winrm)

Software richiesto```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

## 🚀 Installazione

<div align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/7371/63f8299d6bb31aaa64c5e271f4e78bcb3ea94ef8ae7a2f1e2e3b6205552fb8b2.png" alt="Configurazione dell'installazione" />
  <p><em>Processo di installazione - Configurazione di ZeroPulse su un nuovo sistema</em></p>
</div>

### 1. Clona il repository```bash
git clone https://github.com/yourusername/zeropulse.git
cd zeropulse

2. Configurazione del 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. Configurazione del 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. Configura le variabili d'ambiente

Crea un file .env nella root del progetto:```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