cschantz a246b514bc Add comprehensive automatic diagnostics for 500 errors
Added 10+ new automated checks that run when no PHP error is found in error_log:

New checks added:
1. .htaccess issues:
   - Invalid PHP directives (php_value/php_flag with FPM)
   - Malformed RewriteRule syntax
   - Missing RewriteBase with relative paths

2. File validation:
   - File exists check (FILE_NOT_FOUND)
   - File readable check (PERMISSION_ERROR)
   - PHP syntax validation using php -l (PHP_SYNTAX_ERROR)

3. Directory permissions:
   - Document root exists (DOCROOT_MISSING)
   - Document root permissions (755/750/711)

4. PHP handler issues:
   - PHP handler configured for domain
   - .htaccess AddHandler/SetHandler misconfig (PHP_HANDLER_ERROR)

5. WordPress-specific:
   - wp-config.php readable
   - WP_DEBUG_DISPLAY causing 500s (WP_DEBUG_ERROR)

Flow: When error_log has no matching errors, script now runs ALL checks
sequentially until it finds an issue, providing specific diagnosis instead
of generic "NO_PHP_ERROR_LOGGED".

This should catch most common 500 error causes automatically.
2025-11-03 21:36:28 -05:00
2025-11-03 18:41:30 -05:00
2025-11-03 18:14:51 -05:00

Linux Server Management Toolkit

Comprehensive cPanel/Linux server management suite 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
│   │   └── tail-*.sh                   # Various log monitoring scripts
│   │
│   ├── 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
│
├── 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

# Download and run in one command
curl -sL https://git.mull.lol/cschantz/Linux-Server-Management-Toolkit/archive/main.tar.gz | tar xz && cd linux-server-management-toolkit && bash launcher.sh

Or if already downloaded:

bash /root/server-toolkit/launcher.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
  • Multi-Source Monitoring: SSH, Web, Firewall, cPHulk integration

🔍 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 launcher.sh
# Select: Security & Threat Analysis
# Select: Live Monitoring & Alerts
# Select: Live Network Security Monitor

Enable cPHulk with CSF Whitelist

bash launcher.sh
# Select: Security & Threat Analysis
# Select: Security Actions & Fixes
# Select: Authentication Security
# Select: Enable cPHulk Protection

System Health Check

bash launcher.sh
# Select: System Diagnostics
# Select: System Health Check

🔧 Configuration

Edit the configuration file:

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.0)

  • Complete security menu restructure (3-mode hierarchy)
  • Live network security monitoring dashboard
  • Intelligent cPHulk enablement with multi-source CSF whitelist discovery
  • Real-time threat detection and classification
  • Reference database for cross-module intelligence
  • Git repository integration

🙏 Credits

Built for comprehensive cPanel/Linux server management with a focus on security and intelligent automation.


Version: 2.0.0 Repository: https://git.mull.lol/cschantz/Linux-Server-Management-Toolkit

S
Description
No description provided
Readme MIT 18 MiB
Languages
Shell 100%