K2Panel

🚀 MANAGE SERVERS LIKE A PRO

Powerful server management panel with automated deployment, monitoring, and enterprise-grade security

Quick Start • Documentation • Features • Deployment

---

K2Panel is a comprehensive server management solution designed for professional server administration with enterprise-grade features.

1. Fork المشروع على Replit
2. اضغط Run - يبدأ تلقائياً
3. افتح Preview للوصول للتطبيق

# أو يدوياً
python3 runserver.py

# 1. Clone المشروع
git clone https://github.com/K2Panel/K2Panel.git
cd K2Panel

# 2. تثبيت المتطلبات
pip3 install -r requirements.txt

# 3. إعداد البيئة
cp .env.example .env
nano .env  # عدّل المتغيرات

# 4. تشغيل
python3 runserver.py

# 5. للإنتاج: استخدم systemd + Nginx
sudo ./setup_systemd.sh
sudo ./setup_nginx.sh

📚 دليل شامل: VPS_DEPLOYMENT_GUIDE.md

• MITM Attack Protection - Mandatory host fingerprint verification
• StrictHostKeyChecking - Enforced on all SSH connections
• Automated Testing - Pre-deployment connection validation

VPS_HOST              # VPS IP address
VPS_USER              # SSH username
VPS_SSH_KEY           # SSH private key
VPS_HOST_FINGERPRINT  # 🔐 SSH fingerprint (REQUIRED for MITM protection)

Get fingerprint:

ssh-keyscan -H YOUR_VPS_IP 2>/dev/null | ssh-keygen -lf - | awk '{print $2}'

# In GitHub Repository:
Actions → Test VPS Connection → Run workflow

# Validates:
✅ All GitHub Secrets are configured
✅ SSH connection works
✅ Host fingerprint verified (MITM protection)
✅ Docker installed
✅ Deployment path exists

• Trigger: Push to main branch
• Workflow: Build → Test → Deploy (Blue-Green)
• Rollback: Automatic on failure

┌─────────────────────────────────────────────┐
│           K2Panel Architecture              │
├─────────────────────────────────────────────┤
│                                             │
│  ┌─────────────┐         ┌──────────────┐  │
│  │   Frontend  │ ◄─────► │   Backend    │  │
│  │   (Vite)    │         │   (Python)   │  │
│  └─────────────┘         └──────────────┘  │
│         │                        │          │
│         ▼                        ▼          │
│  ┌─────────────────────────────────────┐   │
│  │         Nginx (Reverse Proxy)       │   │
│  └─────────────────────────────────────┘   │
│                     │                       │
│         ┌───────────┴───────────┐          │
│         ▼                       ▼          │
│  ┌─────────────┐         ┌──────────────┐  │
│  │ PostgreSQL  │         │    Redis     │  │
│  │  Database   │         │    Cache     │  │
│  └─────────────┘         └──────────────┘  │
│                                             │
│  Monitoring: Prometheus + Grafana + Loki   │
└─────────────────────────────────────────────┘

• Simple setup for small projects
• Direct deployment to VPS
• Manual rollback if needed

• Zero-downtime deployment
• Automatic health checks
• Instant rollback capability
• Traffic switching with Nginx

• Automated testing
• Multi-environment support
• Slack/Email notifications
• Automated backups

• Backend: Python, Flask
• Frontend: Vite, Modern JavaScript
• Database: PostgreSQL, Redis
• Deployment: Docker, Docker Compose
• CI/CD: GitHub Actions
• Monitoring: Prometheus, Grafana, Loki
• Reverse Proxy: Nginx
• SSL/TLS: Let's Encrypt

• Prometheus - Metrics collection
• Grafana - Visualization dashboards
• Loki - Centralized logging
• Alertmanager - Smart notifications
• Integrations: Slack, Email, PagerDuty

See CONTRIBUTING.md for contribution guidelines.

This project is proprietary. See LICENSE file for details.

• 📚 Documentation
• 🐛 Issues
• 💬 Discussions