cschantz
4566b0e5da
MAJOR UPDATE: v2.1 → v2.2 Added new section highlighting multi-panel architecture completion: - Full cPanel, InterWorx, and Plesk support (all production ready) - 38/38 modules refactored (100% complete) - Automated validation scripts (13 tests InterWorx, 15 tests Plesk) - All critical paths verified on production systems New section on System Detection & Abstraction: - Automatic control panel detection - Multi-panel user/domain management abstraction - Dynamic log discovery for all panel types - Zero hardcoded paths - all detection-based Updated existing sections to reflect multi-panel capabilities: - Website Diagnostics now explicitly multi-panel - Security tools updated with multi-panel support - Core Infrastructure highlights production validation Changed tagline to reflect multi-panel support capabilities. This represents the completion of the largest refactoring effort to date, bringing full multi-panel support to the entire toolkit.
237 lines
9.9 KiB
Markdown
237 lines
9.9 KiB
Markdown
# ⚡ Linux Server Management Toolkit
|
|
|
|
Comprehensive multi-panel server management suite supporting cPanel, InterWorx, Plesk, and standalone Apache with modular architecture and intelligent security features.
|
|
|
|
## 📦 Directory Structure
|
|
|
|
```
|
|
server-toolkit/
|
|
├── launcher.sh # Main menu system
|
|
├── README.md # This file
|
|
│
|
|
├── modules/ # Modular scripts organized by category
|
|
│ │
|
|
│ ├── security/ # 🛡️ Security & Threat Analysis
|
|
│ │ ├── bot-analyzer.sh # Full bot/threat analysis
|
|
│ │ ├── live-attack-monitor.sh # Real-time attack monitoring dashboard
|
|
│ │ ├── ssh-attack-monitor.sh # SSH brute force detection
|
|
│ │ ├── web-traffic-monitor.sh # Web traffic monitoring
|
|
│ │ ├── firewall-activity-monitor.sh # CSF/iptables monitoring
|
|
│ │ ├── enable-cphulk.sh # cPHulk enablement with CSF whitelist import
|
|
│ │ ├── ip-reputation-manager.sh # Centralized IP reputation tracking
|
|
│ │ └── tail-*.sh # Various log monitoring scripts
|
|
│ │
|
|
│ ├── backup/ # 💾 Backup & Recovery (Acronis Cyber Protect)
|
|
│ │ ├── acronis-backup-manager.sh # Main backup management menu
|
|
│ │ ├── acronis-install.sh # Install Acronis agent
|
|
│ │ ├── acronis-update.sh # Update Acronis agent
|
|
│ │ ├── acronis-uninstall.sh # Uninstall Acronis agent
|
|
│ │ ├── acronis-register.sh # Register agent with cloud
|
|
│ │ ├── acronis-configure.sh # Configure agent settings
|
|
│ │ ├── acronis-agent-status.sh # Comprehensive agent status check
|
|
│ │ ├── acronis-trigger-backup.sh # Trigger manual backups with optimizations
|
|
│ │ ├── acronis-backup-status.sh # Check backup job status
|
|
│ │ ├── acronis-list-backups.sh # List all backups
|
|
│ │ ├── acronis-plan-manager.sh # Manage protection plans
|
|
│ │ ├── acronis-schedule-viewer.sh # View backup schedules
|
|
│ │ ├── acronis-restore.sh # Restore from backup
|
|
│ │ ├── acronis-logs.sh # View Acronis logs
|
|
│ │ └── acronis-troubleshoot.sh # Troubleshoot common issues
|
|
│ │
|
|
│ ├── website/ # 🌐 Website Diagnostics & Troubleshooting
|
|
│ │ ├── website-error-analyzer.sh # Comprehensive website error analysis
|
|
│ │ └── 500-error-tracker.sh # Track and analyze 500 errors
|
|
│ │
|
|
│ ├── diagnostics/ # 🔍 System Diagnostics
|
|
│ │ └── system-health-check.sh # Comprehensive health analysis
|
|
│ │
|
|
│ ├── performance/ # 📊 Performance Analysis
|
|
│ │ ├── hardware-health-check.sh # Hardware diagnostics
|
|
│ │ ├── mysql-query-analyzer.sh # MySQL performance analysis
|
|
│ │ └── network-bandwidth-analyzer.sh # Network analysis
|
|
│ │
|
|
│ └── maintenance/ # 🧹 System Maintenance
|
|
│ └── cleanup-toolkit-data.sh # Clean temporary toolkit data
|
|
│
|
|
├── lib/ # Shared libraries
|
|
│ ├── common-functions.sh # Reusable functions
|
|
│ ├── system-detect.sh # System type detection
|
|
│ ├── user-manager.sh # User account management
|
|
│ ├── mysql-analyzer.sh # MySQL utilities
|
|
│ └── reference-db.sh # Cross-module intelligence sharing
|
|
│
|
|
├── config/ # Configuration files
|
|
│ ├── settings.conf # Main configuration
|
|
│ ├── whitelist-ips.txt # IP whitelist
|
|
│ └── whitelist-user-agents.txt # User-Agent whitelist
|
|
│
|
|
└── tools/ # Utility scripts
|
|
├── diagnostic-report.sh # Generate system reports
|
|
└── test-*.sh # Testing utilities
|
|
```
|
|
|
|
## 🚀 Quick Start
|
|
|
|
### Installation & Running
|
|
|
|
**One command - automatic cleanup:**
|
|
```bash
|
|
curl -sL https://git.mull.lol/cschantz/Linux-Server-Management-Toolkit/archive/main.tar.gz | tar xz && source linux-server-management-toolkit/run.sh
|
|
```
|
|
|
|
When exiting (option 0), answer "yes" and cleanup happens automatically - no extra steps.
|
|
|
|
Or if already downloaded:
|
|
```bash
|
|
source /root/server-toolkit/run.sh
|
|
```
|
|
|
|
## ✨ Key Features
|
|
|
|
### 🛡️ Security & Threat Analysis
|
|
- **3-Mode Security Menu**: Analysis / Actions / Live Monitoring
|
|
- **Live Attack Monitor**: Real-time SOC dashboard with threat classification
|
|
- **Intelligent cPHulk Setup**: Auto-imports CSF whitelists from all sources
|
|
- **IP Reputation Tracking**: Centralized cross-module IP intelligence
|
|
- **Multi-Source Monitoring**: SSH, Web, Firewall, cPHulk integration
|
|
|
|
### 💾 Backup & Recovery (Acronis Cyber Protect)
|
|
- **Complete Agent Management**: Install, update, uninstall, register
|
|
- **Comprehensive Status Monitoring**: Agent health, registration, cloud connectivity
|
|
- **Manual Backup Triggering**: CLI-managed plans with performance optimizations
|
|
- **Backup Type Selection**: Full, Incremental, Differential backups
|
|
- **Plan Management**: View, enable/disable, delete protection plans
|
|
- **Restore Operations**: Full restore capabilities from backups
|
|
- **Troubleshooting Tools**: Log viewing and automated diagnostics
|
|
|
|
### 🌐 Website Diagnostics
|
|
- **Error Analysis**: Comprehensive website error detection and troubleshooting
|
|
- **500 Error Tracking**: Detailed analysis of application errors
|
|
- **Log Integration**: Apache, PHP-FPM, cPanel error log analysis
|
|
- **Smart Recommendations**: Context-aware suggestions for fixing issues
|
|
|
|
### 🔍 System Diagnostics
|
|
- **Comprehensive Health Checks**: Hardware, services, security posture
|
|
- **Smart Recommendations**: Context-aware suggestions based on findings
|
|
- **cPanel/WHM Integration**: Native support for cPanel environments
|
|
|
|
### 📊 Session Intelligence
|
|
- **Reference Database**: Cross-module data sharing (.sysref)
|
|
- **No Historical Tracking**: Session-based intelligence only
|
|
- **"Download, Run, Fix, Delete"**: Designed for one-time troubleshooting
|
|
|
|
## 🎯 Usage Examples
|
|
|
|
### Security Analysis with Live Monitoring
|
|
|
|
```bash
|
|
bash launcher.sh
|
|
# Select: Security & Threat Analysis
|
|
# Select: Live Monitoring & Alerts
|
|
# Select: Live Network Security Monitor
|
|
```
|
|
|
|
### Enable cPHulk with CSF Whitelist
|
|
|
|
```bash
|
|
bash launcher.sh
|
|
# Select: Security & Threat Analysis
|
|
# Select: Security Actions & Fixes
|
|
# Select: Authentication Security
|
|
# Select: Enable cPHulk Protection
|
|
```
|
|
|
|
### Acronis Backup Management
|
|
|
|
```bash
|
|
bash launcher.sh
|
|
# Select: Backup & Recovery
|
|
# Select: Check Agent Status (view health, registration, connectivity)
|
|
# Select: Trigger Manual Backup (with type selection and optimizations)
|
|
# Select: Manage Protection Plans
|
|
```
|
|
|
|
### Website Error Analysis
|
|
|
|
```bash
|
|
bash launcher.sh
|
|
# Select: Website Diagnostics & Troubleshooting
|
|
# Select: Website Error Analyzer
|
|
# Choose a cPanel user account to analyze
|
|
```
|
|
|
|
### System Health Check
|
|
|
|
```bash
|
|
bash launcher.sh
|
|
# Select: System Diagnostics
|
|
# Select: System Health Check
|
|
```
|
|
|
|
## 🔧 Configuration
|
|
|
|
Edit the configuration file:
|
|
```bash
|
|
nano /root/server-toolkit/config/settings.conf
|
|
```
|
|
|
|
## 🔒 Security Considerations
|
|
|
|
- **Run as root**: Most modules require root access
|
|
- **Credentials stored safely**: Git credentials in ~/.git-credentials (outside project)
|
|
- **No sensitive data in repo**: .gitignore excludes keys, tokens, credentials
|
|
- **Test first**: Try on non-production environments first
|
|
|
|
## 📊 Recent Updates (v2.2)
|
|
|
|
### Multi-Control Panel Support (NEW!)
|
|
- ✅ Full cPanel support (primary platform - production ready)
|
|
- ✅ InterWorx support (validated on real servers - production ready)
|
|
- ✅ Plesk support (validated on real servers - production ready)
|
|
- ✅ Standalone Apache support (basic functionality)
|
|
- ✅ 38/38 modules refactored for multi-panel architecture (100% complete)
|
|
- ✅ Automated validation scripts for InterWorx and Plesk (13 and 15 tests)
|
|
- ✅ All critical paths verified on production systems
|
|
|
|
### System Detection & Abstraction
|
|
- ✅ Automatic control panel detection (system-detect.sh)
|
|
- ✅ Multi-panel user/domain management abstraction (user-manager.sh)
|
|
- ✅ Dynamic log discovery for all panel types
|
|
- ✅ Panel-specific path handling (docroots, logs, configs)
|
|
- ✅ Zero hardcoded paths - all detection-based
|
|
|
|
### Backup & Recovery
|
|
- ✅ Complete Acronis Cyber Protect integration (16 management scripts)
|
|
- ✅ Agent installation, registration, and update automation
|
|
- ✅ Comprehensive status monitoring (health, registration, connectivity)
|
|
- ✅ Manual backup triggering with performance optimizations
|
|
- ✅ Protection plan management and scheduling
|
|
|
|
### Website Diagnostics
|
|
- ✅ Comprehensive website error analyzer (multi-panel)
|
|
- ✅ 500 error tracking and troubleshooting (multi-panel)
|
|
- ✅ Multi-log integration (Apache, PHP-FPM, all panels)
|
|
- ✅ Smart error detection and recommendations
|
|
|
|
### Security Enhancements
|
|
- ✅ Bot analyzer with multi-panel log discovery
|
|
- ✅ Live attack monitor supporting all control panels
|
|
- ✅ Malware scanner with panel-aware docroot detection
|
|
- ✅ Centralized IP reputation tracking
|
|
- ✅ Real-time threat detection and classification
|
|
|
|
### Core Infrastructure
|
|
- ✅ Modular architecture with organized category structure
|
|
- ✅ Reference database for cross-module intelligence
|
|
- ✅ Comprehensive developer documentation (REFDB_FORMAT.txt)
|
|
- ✅ Production validation complete for all major panels
|
|
|
|
## 🙏 Credits
|
|
|
|
Built for comprehensive cPanel/Linux server management with a focus on security and intelligent automation.
|
|
|
|
---
|
|
|
|
**Version**: 2.1.0
|
|
**Repository**: https://git.mull.lol/cschantz/Linux-Server-Management-Toolkit
|