ZeroPulse

---

📋 Inhaltsverzeichnis

• Übersicht
• Funktionen
• Architektur
• Voraussetzungen
• Installation
• Konfiguration
• Verwendung
• API-Dokumentation
• Sicherheit
• Projektstruktur
• Entwicklung
• Mitwirken
• Lizenz
• Danksagungen
• Support

🎯 Übersicht

ZeroPulse ist eine umfassende Command-&-Control-Plattform (C2), die für sicheres Remote-Management und Monitoring entwickelt wurde. Sie nutzt die Cloudflare-Tunnel-Technologie, um sichere, verschlüsselte Verbindungen bereitzustellen, ohne Ihre Infrastruktur dem öffentlichen Internet auszusetzen.

⚠️ Entwicklungsstatus: Dieses Projekt befindet sich derzeit in aktiver Entwicklung. Diese Version ist eine Demo-/Alpha-Version, und einige Funktionen können:

• Instabil oder anfällig für Breaking Changes sein
• Unvollständig oder nur teilweise implementiert sein
• In aktiver Entwicklung mit häufigen Updates stehen

Wir empfehlen, diese Software nur für Test- und Evaluierungszwecke zu verwenden. Für den Produktionseinsatz warten Sie bitte auf eine stabile Version oder verwenden Sie sie auf eigenes Risiko.

Wichtigste Highlights

• 🔒 Von Haus aus sicher: Integrierte Authentifizierung, Sitzungsverwaltung und API-Token-System
• 🌐 Cloudflare-Integration: Nahtlose DNS- und Tunnelverwaltung über die Cloudflare-API
• 🖥️ Remote-Verwaltung: WinRM- und SSH-Unterstützung mit evil-winrm-Integration für interaktive Shells
• 📊 Moderne Benutzeroberfläche: Schöne, responsive React-Oberfläche mit Echtzeit-Terminal-Integration
• 🚀 Leistungsoptimiert: Nicht blockierende E/A, optimierte Datenbankabfragen und Verhinderung von Speicherlecks
• 🖥️ Lokaler Shell-Zugriff: Interaktive lokale Shell über WebSocket mit Echtzeit-Terminal-Emulation

✨ Funktionen

Kernfunktionen

• Tunnelverwaltung

  • Cloudflare-Tunnel erstellen und verwalten
  • Ingress-Regeln konfigurieren (HTTP, HTTPS, TCP)
  • Automatische DNS-Eintragsverwaltung
  • Verwaltung von Proxy-Routen

• Remote-Befehlsausführung

  • Befehle auf entfernten Windows-Systemen über WinRM ausführen
  • Interaktive Shell mit evil-winrm-Integration (Passwort- & NTLM-Hash-Authentifizierung)
  • SSH-Befehlsausführung und interaktive Sitzungen
  • Ausführung von PowerShell-Skripten
  • Verfolgung des Befehlsverlaufs
  • Echtzeit-Ausgabestreaming
  • Modul-Kontrollzentrum mit dynamischer Modulausführung

• Remotedesktop

  • VNC-Server-Erkennung und -Verwaltung
  • Webbasierter noVNC-Remotedesktop-Client
  • Unterstützung für Windows- und Linux-Systeme
  • Sichere tunnelbasierte Verbindungen

• Sitzung & Sicherheit

  • JWT-basierte Authentifizierung
  • Aktive Sitzungsverwaltung
  • API-Token-System mit granularen Berechtigungen
  • Sperrung und Widerruf von Tokens
  • Rollenbasierte Zugriffskontrolle (RBAC)

• DNS-Verwaltung

  • Automatische Erstellung/Aktualisierung von DNS-Einträgen
  • Unterstützung für CNAME-, A- und AAAA-Einträge
  • Cloudflare-Proxy-Konfiguration
  • Konfliktlösung

• Lokaler Shell-Zugriff

  • Interaktive lokale Shell über WebSocket
  • Echtzeit-Terminal-Emulation mit xterm.js
  • Unterstützung für eigenständige Fenster
  • Nicht blockierende E/A für optimale Leistung

• Modulsteuerungssystem

  • Dynamisches Laden von Modulen aus der Datenbank
  • Hierarchische Struktur (Kategorien → Abschnitte → Elemente)
  • Template-Engine mit Variablenersetzung
  • Integration des interaktiven Terminals
  • Verlauf der Befehlsausführung

⚙️ Technologie-Stack

Schicht	Technologie	Zweck
Frontend	React 19, Redux Toolkit, React Router, TailwindCSS, xterm.js	Benutzeroberfläche
Backend	FastAPI, Uvicorn	API-Server
Datenbank	SQLite (mit optimierten Abfragen und Indizes)	Datenpersistenz
Authentifizierung	JWT, python-jose	Token-basierte Authentifizierung
Remote-Ausführung	pywinrm, paramiko, evil-winrm	WinRM- & SSH-Integration
Terminal	xterm.js, WebSocket	Interaktives Terminal
Externe APIs	requests, cloudflare	Dienstintegration
Prozessverwaltung	subprocess, asyncio, threading	Hintergrundaufgaben

📦 Voraussetzungen

Systemanforderungen

• Betriebssystem: Linux (Ubuntu 20.04+, Debian 11+ oder eine beliebige moderne Linux-Distribution)
• Python: 3.8 oder höher
• Node.js: 20.19.0+ oder 22.12.0+ (siehe .nvmrc im Frontend-Verzeichnis)
• npm: Wird mit Node.js geliefert
• Cloudflare-Konto: Mit API-Token und Konto-ID
• Ruby (optional): Für evil-winrm-Unterstützung (gem install evil-winrm)

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

## 🚀 Installation

<div align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/7371/63f8299d6bb31aaa64c5e271f4e78bcb3ea94ef8ae7a2f1e2e3b6205552fb8b2.png" alt="Installations-Setup" />
  <p><em>Installationsprozess - Einrichten von ZeroPulse auf einem neuen System</em></p>
</div>

### 1. Repository klonen```bash
git clone https://github.com/yourusername/zeropulse.git
cd zeropulse

2. Backend-Setup```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. Frontend-Einrichtung```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. Umgebungsvariablen konfigurieren

Erstellen Sie eine .env-Datei im Projektstammverzeichnis:```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