ZeroPulse

---

📋 Оглавление

• Обзор
• Возможности
• Архитектура
• Предварительные требования
• Установка
• Конфигурация
• Использование
• Документация API
• Безопасность
• Структура проекта
• Разработка
• Вклад в проект
• Лицензия
• Благодарности
• Поддержка

🎯 Обзор

ZeroPulse — это комплексная платформа Command & Control (C2), предназначенная для безопасного удалённого управления и мониторинга. Она использует технологию Cloudflare Tunnel для обеспечения безопасных зашифрованных соединений, не открывая вашу инфраструктуру публичному интернету.

⚠️ Статус разработки: Проект находится в стадии активной разработки. Эта версия является демо/альфа-релизом, и некоторые функции могут быть:

• Нестабильными или подвержены кардинальным изменениям
• Неполными или частично реализованными
• В процессе активной разработки с частыми обновлениями

Мы рекомендуем использовать это программное обеспечение только для тестирования и оценки. Для производственного использования дождитесь стабильного релиза или используйте на свой страх и риск.

Ключевые особенности

• 🔒 Безопасно по умолчанию: Встроенная аутентификация, управление сеансами и система API-токенов
• 🌐 Интеграция Cloudflare: Бесшовное управление DNS и туннелями через Cloudflare API
• 🖥️ Удалённое управление: Поддержка WinRM и SSH с интеграцией evil-winrm для интерактивных оболочек
• 📊 Современный интерфейс: Красивый адаптивный интерфейс на React с интеграцией терминала в реальном времени
• 🚀 Оптимизация производительности: Неблокирующий ввод-вывод, оптимизированные запросы к базе данных и предотвращение утечек памяти
• 🖥️ Доступ к локальной оболочке: Интерактивная локальная оболочка через WebSocket с эмуляцией терминала в реальном времени

✨ Возможности

Основные возможности

• Управление туннелями

  • Создание и управление туннелями Cloudflare
  • Настройка правил входящего трафика (HTTP, HTTPS, TCP)
  • Автоматическое управление DNS-записями
  • Управление прокси-маршрутами

• Удалённое выполнение команд

  • Выполнение команд на удалённых системах Windows через WinRM
  • Интерактивная оболочка с интеграцией evil-winrm (аутентификация по паролю и NTLM-хешу)
  • Выполнение команд через SSH и интерактивные сеансы
  • Выполнение PowerShell-скриптов
  • Отслеживание истории команд
  • Потоковый вывод в реальном времени
  • Панель управления модулями с динамическим выполнением модулей

• Удалённый рабочий стол

  • Обнаружение и управление VNC-серверами
  • Браузерный клиент удалённого рабочего стола noVNC
  • Поддержка систем Windows и Linux
  • Безопасные соединения на основе туннелей

• Сеансы и безопасность

  • Аутентификация на основе JWT
  • Управление активными сеансами
  • Система API-токенов с детальными правами доступа
  • Чёрный список и отзыв токенов
  • Управление доступом на основе ролей (RBAC)

• Управление DNS

  • Автоматическое создание и обновление DNS-записей
  • Поддержка записей CNAME, A, AAAA
  • Настройка прокси Cloudflare
  • Разрешение конфликтов

• Доступ к локальной оболочке

  • Интерактивная локальная оболочка через WebSocket
  • Эмуляция терминала в реальном времени с помощью xterm.js
  • Поддержка отдельного окна
  • Неблокирующий ввод-вывод для оптимальной производительности

• Система управления модулями

  • Динамическая загрузка модулей из базы данных
  • Иерархическая структура (категории → разделы → элементы)
  • Шаблонизатор с подстановкой переменных
  • Интеграция с интерактивным терминалом
  • История выполнения команд

⚙️ Технологический стек

Слой	Технология	Назначение
Фронтенд	React 19, Redux Toolkit, React Router, TailwindCSS, xterm.js	Пользовательский интерфейс
Бэкенд	FastAPI, Uvicorn	API-сервер
База данных	SQLite (с оптимизированными запросами и индексами)	Хранение данных
Аутентификация	JWT, python-jose	Аутентификация на основе токенов
Удалённое выполнение	pywinrm, paramiko, evil-winrm	Интеграция WinRM и SSH
Терминал	xterm.js, WebSocket	Интерактивный терминал
Внешние API	requests, cloudflare	Интеграция сервисов
Управление процессами	subprocess, asyncio, threading	Фоновые задачи

📦 Предварительные требования

Системные требования

• ОС: Linux (Ubuntu 20.04+, Debian 11+ или любой современный дистрибутив Linux)
• Python: 3.8 или выше
• Node.js: 20.19.0+ или 22.12.0+ (см. .nvmrc в каталоге фронтенда)
• npm: поставляется с Node.js
• Учётная запись Cloudflare: с API-токеном и идентификатором аккаунта
• Ruby (необязательно): для поддержки evil-winrm (gem install evil-winrm)

Необходимое программное обеспечение```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

## 🚀 Установка

<div align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/7371/63f8299d6bb31aaa64c5e271f4e78bcb3ea94ef8ae7a2f1e2e3b6205552fb8b2.png" alt="Установка и настройка" />
  <p><em>Процесс установки — настройка ZeroPulse на новой системе</em></p>
</div>

### 1. Клонирование репозитория```bash
git clone https://github.com/yourusername/zeropulse.git
cd zeropulse

2. Настройка бэкенда```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. Настройка фронтенда```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. Настройка переменных окружения

Создайте файл .env в корне проекта:```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