feat: add command reference documentation and improve user prompts in scripts

Author: tanhongit

docs/COMMANDS.md

@@ -0,0 +1,129 @@
+# Quick Reference - All Available Commands
+
+## 🚀 Main Setup
+```bash
+bash install.sh setup        # Full server setup
+bash install.sh s            # Short version
+bash install.sh a            # Short version
+```
+
+## 🔐 SSH Configuration
+```bash
+bash install.sh ssh_port     # Change SSH port
+bash install.sh sp           # Short version
+
+bash install.sh ssh_timeout  # Auto logout after 5min idle
+bash install.sh st           # Short version
+```
+
+## 🐘 PHP Installation
+```bash
+bash install.sh php          # Install PHP
+bash install.sh php_extension 8.4  # Install PHP 8.4 extensions
+bash install.sh pe 8.4       # Short version
+```
+
+## 🐳 Docker Tools
+```bash
+bash install.sh lazydocker   # Install lazydocker
+bash install.sh ld           # Short version
+```
+
+## 🌍 Global Development Environment
+```bash
+# Install NVM, NPM, Yarn, ZSH for all users
+bash install.sh global_dev
+bash install.sh gd           # Short version
+
+# Force update for existing users
+bash install.sh global_dev -f
+bash install.sh gd --force
+```
+
+## 📊 Zabbix Monitoring
+
+### Install Zabbix Server
+```bash
+bash install.sh zabbix_server
+bash install.sh zs           # Short version
+```
+Features:
+- Auto-detects Nginx/Apache
+- MySQL/MariaDB database
+- Zabbix 7.0 LTS
+- Secure random passwords
+- Firewall configuration
+
+### Install Zabbix Agent (Client)
+```bash
+# Will prompt for Server IP
+bash install.sh zabbix_client
+bash install.sh zc           # Short version
+
+# Pass Server IP directly
+bash install.sh zabbix_client 192.168.1.100
+bash install.sh zc 192.168.1.100
+```
+
+## 🔧 Troubleshooting
+
+### Fix MySQL FROZEN Issue
+When you see "MySQL has been frozen" error:
+```bash
+bash install.sh fix_mysql
+bash install.sh fix_mysql_frozen
+bash install.sh fmf          # Short version
+```
+
+This fixes the issue when downgrading from MariaDB to MySQL.
+
+## 📋 All Commands Summary
+
+| Command | Short | Description |
+|---------|-------|-------------|
+| `setup` | `s`, `a` | Full server setup |
+| `ssh_port` | `sp` | Change SSH port |
+| `ssh_timeout` | `st` | Configure SSH timeout |
+| `php` | - | Install PHP |
+| `php_extension` | `pe` | Install PHP extensions |
+| `lazydocker` | `ld` | Install lazydocker |
+| `global_dev` | `gd` | Global dev environment |
+| `zabbix_server` | `zs` | Install Zabbix Server |
+| `zabbix_client` | `zc` | Install Zabbix Agent |
+| `fix_mysql` | `fmf` | Fix MySQL FROZEN issue |
+
+## 💡 Examples
+
+```bash
+# Setup new server
+bash install.sh setup
+
+# Change SSH port to 2222
+bash install.sh ssh_port 2222
+
+# Install PHP 8.4 extensions
+bash install.sh php_extension 8.4
+
+# Setup Zabbix monitoring
+bash install.sh zabbix_server
+bash install.sh zabbix_client 192.168.1.100
+
+# Fix MySQL issue
+bash install.sh fix_mysql
+
+# Global dev environment with force update
+sudo bash install.sh global_dev --force
+```
+
+## 🆘 Need Help?
+
+```bash
+bash install.sh
+# Shows usage information
+```
+
+For detailed documentation, see:
+- [README.md](../README.md) - Full documentation
+- [ZABBIX-SETUP.md](setup/system/ZABBIX-SETUP.md) - Zabbix guide
+- [SSH-TIMEOUT-DEBUG.md](setup/system/SSH-TIMEOUT-DEBUG.md) - SSH timeout debug
+

setup/system/fix-mysql-frozen.sh

@@ -28,7 +28,7 @@ echo "Choose an option:"
 echo "  1) Remove MySQL/MariaDB and clean everything (recommended)"
 echo "  2) Just remove FROZEN file (risky, may cause data corruption)"
 echo "  3) Cancel"
-read -p "Enter choice [1-3]: " choice
+read -r -p "Enter choice [1-3]: " choice
 
 case "$choice" in
     1)

setup/system/zabbix.sh

@@ -94,7 +94,7 @@ install_zabbix_server() {
         echo "  1) Use existing ${DB_TYPE} (recommended if working)"
         echo "  2) Remove ${DB_TYPE} and install fresh MySQL 8.0"
         echo "  3) Cancel installation"
-        read -p "Enter choice [1-3]: " db_choice
+        read -r -p "Enter choice [1-3]: " db_choice
 
         case "$db_choice" in
             1)
@@ -320,7 +320,7 @@ install_zabbix_agent() {
     echo ''
 
     # Get Zabbix server address from user
-    read -p "Enter Zabbix Server IP address: " ZABBIX_SERVER_IP
+    read -r -p "Enter Zabbix Server IP address: " ZABBIX_SERVER_IP
 
     if [ -z "$ZABBIX_SERVER_IP" ]; then
         print_error "Zabbix Server IP is required"