ZeroPulse

---

📋 جدول المحتويات

• نظرة عامة
• المميزات
• البنية المعمارية
• المتطلبات الأساسية
• التثبيت
• الإعداد
• الاستخدام
• توثيق API
• الأمان
• هيكل المشروع
• التطوير
• المساهمة
• الترخيص
• شكر وتقدير
• الدعم

🎯 نظرة عامة

ZeroPulse هي منصة قيادة وتحكم (C2) شاملة مصممة للإدارة والمراقبة عن بُعد بشكل آمن. تستفيد من تقنية Cloudflare Tunnel لتوفير اتصالات آمنة ومشفرة دون كشف البنية التحتية الخاصة بك للإنترنت العام.

⚠️ حالة التطوير: هذا المشروع قيد التطوير النشط حاليًا. هذا الإصدار هو إصدار تجريبي/ألفا وقد تكون بعض الميزات:

• غير مستقرة أو عرضة لتغييرات جذرية
• غير مكتملة أو منفذة جزئيًا
• قيد التطوير النشط مع تحديثات متكررة

نوصي باستخدام هذا البرنامج لأغراض الاختبار والتقييم فقط. للاستخدام في الإنتاج، يرجى انتظار إصدار مستقر أو استخدامه على مسؤوليتك الخاصة.

أبرز المزايا

• 🔒 آمن افتراضيًا: مصادقة مدمجة، وإدارة جلسات، ونظام رموز API
• 🌐 تكامل Cloudflare: إدارة سلسة لـ DNS والأنفاق عبر Cloudflare API
• 🖥️ إدارة عن بُعد: دعم WinRM وSSH مع تكامل evil-winrm للصدفة التفاعلية
• 📊 واجهة مستخدم عصرية: واجهة React جميلة ومتجاوبة مع تكامل طرفية في الوقت الفعلي
• 🚀 أداء محسّن: إدخال/إخراج غير محظور، واستعلامات قاعدة بيانات محسّنة، ومنع تسرب الذاكرة
• 🖥️ وصول الصدفة المحلية: صدفة محلية تفاعلية عبر WebSocket مع محاكاة طرفية في الوقت الفعلي

✨ المميزات

القدرات الأساسية

• إدارة الأنفاق

  • إنشاء وإدارة أنفاق Cloudflare
  • تكوين قواعد الدخول (HTTP, HTTPS, TCP)
  • إدارة سجلات DNS تلقائيًا
  • إدارة توجيه البروكسي

• تنفيذ الأوامر عن بُعد

  • تنفيذ الأوامر على أنظمة Windows البعيدة عبر WinRM
  • صدفة تفاعلية مع تكامل evil-winrm (مصادقة بكلمة المرور وNTLM Hash)
  • تنفيذ أوامر 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	طرفية تفاعلية
الواجهات البرمجية الخارجية	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

SSH Settings (optional)

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

C2 Server Settings

C2_SERVER_HOST=0.0.0.0 C2_SERVER_PORT=8000 ENVIRONMENT=production

Database Settings

DATABASE_PATH=data/database.db EOF

Set permissions

chmod 600 .env

### 5. ابدأ الخادم```bash
# Ensure virtual environment is active
source venv/bin/activate

# Start the server
python3 run_server.py

الخادم سيكون متاحًا على http://localhost:8000

⚙️ الإعدادات

متغيرات البيئة