WebPanel - аналог ISPmanager

WebPanel 🚀

Self-hosted web panel for managing websites on VPS/Dedicated servers. Modern, secure, and easy to use alternative to cPanel, ISPManager, and similar panels.

🎯 ISPmanager Compatibility: 90% - WebPanel provides nearly all essential hosting panel features with a modern tech stack.

✨ Features

Core Functionality (ISPmanager Compatible)

• 🌐 Site Management - Create, configure, and manage multiple websites with nginx
• 👥 User Management - Create system users with FTP/SSH/sudo permissions
• 📁 File Manager - Full-featured file browser with upload/download/edit capabilities
• 🗄️ Database Management - Create and manage MySQL/MariaDB databases and users
• 💾 Backups - Automated and manual backup system with restore functionality
• 🔐 SSL Certificates - Let's Encrypt integration + manual certificate management
• 📊 Monitoring - Real-time server monitoring (CPU, RAM, Disk, Network)
• 📊 Advanced Monitoring - Real-time metrics, charts, and historical data (CPU, Memory, Disk, Network)
• 📝 Logs - Comprehensive log viewer (access, error, system, app logs)
• ⏰ Cron Jobs - Schedule and manage automated tasks with execution logs
• 🔔 Smart Notifications - AI-powered alerts for system events and anomalies
• ⚙️ Nginx Management - Full nginx configuration management and testing
• 🔒 Security - JWT authentication, bcrypt password hashing, rate limiting

Additional Features

• 🐳 Docker Support - Docker может быть установлен на сервере для использования в сайтах и развертываниях
• 📈 Modern UI - Built with Next.js 15, React 19, and shadcn/ui
• 🌍 Internationalization (i18n) - Russian (default) and English language support
• 🔧 REST API - Full REST API for integrations and automation
• 📱 Responsive Design - Mobile-friendly interface
• ⚡ Performance - Optimized with latest Node.js 22 and modern frameworks

🔄 ISPmanager Compatibility Matrix

Compatibility Score: 90% - WebPanel covers all essential hosting panel features with modern advantages.

🛠️ Tech Stack

Backend

• Node.js + Express.js - REST API server
• MongoDB - Document database for configuration
• MySQL/MariaDB - Database server management
• JWT - Authentication
• bcrypt - Password hashing

Frontend

• Next.js 15 - React framework with App Router
• TypeScript - Type safety
• shadcn/ui - Beautiful UI components
• Tailwind CSS - Styling
• Lucide Icons - Icon library
• i18n - Internationalization (Russian/English)

📋 Requirements

Системные требования

• Node.js 22+
• pnpm 9+ (install with npm install -g pnpm)
• Linux (Ubuntu/Debian recommended)
• MongoDB 8.0+
• MySQL 8.4+ (optional, for database management)
• Nginx 1.27+ (for web server management)
• Docker (optional, для использования в сайтах и развертываниях)

Примечание: WebPanel устанавливается напрямую на сервер (native installation), а не в Docker контейнере. Docker может быть установлен как дополнительное приложение для управления контейнерами сайтов.

🚀 Quick Start

Автоматическое развертывание на удаленном сервере (Рекомендуется)

Самый простой способ развернуть WebPanel на новом сервере:

🤖 Использование AI-ассистентов (Cursor/Copilot):

Вы можете просто отправить промпт с SSH-доступами, и AI-ассистент автоматически выполнит развертывание:

Разверни WebPanel на сервере:
SSH: root@92.246.76.152
Пароль: ваш_ssh_пароль
Домен: panel.example.com

Что происходит автоматически:

• SSH пользователь всегда root (не нужно указывать)
• Email администратора: admin@panel.example.com (автоматически из домена)
• Пароль администратора: автоматически генерируется (будет выведен после развертывания)

AI-ассистент автоматически:

• Извлечет параметры из вашего запроса
• Запустит скрипт deploy.sh с правильными параметрами
• Выполнит полное развертывание без дополнительных вопросов
• Предоставит информацию о доступе и сгенерированном пароле после завершения

Подробные инструкции для AI-ассистентов: AI_DEPLOYMENT.md Быстрая инструкция: QUICK_DEPLOY.md

Ручной запуск скрипта:

```bash

Используя SSH ключ (рекомендуется)

Пароль администратора генерируется автоматически

./deploy.sh \ --host 192.168.1.100 \ --ssh-key ~/.ssh/id_rsa \ --domain panel.example.com

Или с явным указанием email администратора

./deploy.sh \ --host 192.168.1.100 \ --ssh-key ~/.ssh/id_rsa \ --admin-email admin@example.com \ --domain panel.example.com

Используя SSH пароль

./deploy.sh \ --host 192.168.1.100 \ --password ваш_ssh_пароль \ --domain panel.example.com

Или используя конфигурационный файл

cp .deploy.config.example .deploy.config

Отредактируйте .deploy.config

./deploy.sh --config .deploy.config ```

Важно: Пароль администратора WebPanel автоматически генерируется и выводится после развертывания. Сохраните его для входа в панель!

Скрипт автоматически:

• Подключится к серверу по SSH
• Установит все зависимости (Node.js, MongoDB, Nginx)
• Клонирует репозиторий
• Установит и настроит WebPanel
• Настроит systemd сервис
• Настроит Nginx reverse proxy
• Настроит firewall
• Создаст admin пользователя

Ручная установка на сервере

1. Подключитесь к серверу

```bash ssh user@your-server-ip ```

2. Клонируйте репозиторий

```bash cd /opt sudo git clone https://github.com/yourusername/webpanel.git cd webpanel ```

3. Запустите установку

Интерактивная установка: ```bash chmod +x install.sh sudo ./install.sh ```

Автоматическая установка (без вопросов): ```bash sudo ./install.sh \ --non-interactive \ --admin-email admin@example.com \ --admin-password secure_password \ --domain panel.example.com ```

Скрипт установки автоматически:

• Проверит и установит все зависимости
• Установит npm пакеты
• Соберет frontend
• Создаст admin пользователя
• Настроит systemd сервис
• Настроит Nginx (опционально)
• Настроит firewall (опционально)

4. Доступ к панели

После установки WebPanel будет доступен:

• По IP: http://your-server-ip:3000
• Через Nginx: http://your-server-ip/webpanel или http://panel.example.com/webpanel

🐳 Docker как приложение для сайтов

WebPanel устанавливается напрямую на сервер, но Docker может быть установлен как дополнительное приложение для управления контейнерами сайтов и развертываний.

Установка Docker на сервере

Docker может быть установлен автоматически при развертывании WebPanel или вручную:

# Установка Docker (Ubuntu/Debian)
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Добавить пользователя в группу docker (опционально)
sudo usermod -aG docker $USER

# Установка Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

# Проверка установки
docker --version
docker-compose --version

Использование Docker в WebPanel

После установки Docker вы сможете:

• Создавать и управлять Docker контейнерами для сайтов
• Развертывать приложения в контейнерах
• Управлять Docker Compose проектами
• Мониторить использование ресурсов контейнерами

Примечание: WebPanel сам работает напрямую на сервере, а не в Docker контейнере, для обеспечения полного доступа к системным ресурсам и сервисам.

📚 Подробное руководство по развертыванию

Для детального руководства по установке на различные серверы (TimeWeb, DigitalOcean, AWS и др.) см. DEPLOYMENT.md

Автоматическое развертывание

WebPanel поддерживает полностью автоматическое развертывание на удаленных серверах через SSH. Это идеально для:

• Быстрого развертывания на новых серверах
• Массового развертывания на несколько серверов
• CI/CD пайплайнов
• Автоматизации инфраструктуры

Преимущества автоматического развертывания:

• ✅ Один команда для полной установки
• ✅ Автоматическая установка всех зависимостей
• ✅ Настройка всех сервисов (systemd, Nginx, firewall)
• ✅ Минимум ручной работы
• ✅ Воспроизводимые установки

См. раздел "Автоматическое развертывание" в DEPLOYMENT.md для подробностей.

🔧 Manual Installation

If you prefer manual installation:

1. Install dependencies

```bash

Install backend dependencies

npm install

Install frontend dependencies

cd client npm install cd .. ```

2. Configure environment

```bash cp .env.example .env ```

Edit .env file and set your configuration:

```env PORT=3000 NODE_ENV=production JWT_SECRET=your-secret-key-here DB_PATH=./database.sqlite SITES_ROOT=/var/www NGINX_CONFIG_PATH=/etc/nginx/sites-available BACKUPS_PATH=./backups ```

3. Build frontend

```bash cd client npm run build cd .. ```

4. Create admin user

```bash npm run setup ```

5. Start the server

```bash

Development

npm run dev

Production

npm start ```

📁 Project Structure

``` webpanel/ ├── server/ # Backend API │ ├── config/ # Configuration files │ ├── controllers/ # Route controllers │ ├── middleware/ # Express middleware │ ├── models/ # Database models │ └── routes/ # API routes ├── client/ # Next.js frontend │ └── src/ │ ├── app/ # Next.js App Router pages │ ├── components/ # React components │ ├── contexts/ # React contexts │ └── lib/ # Utilities and API client ├── scripts/ # Utility scripts ├── systemd/ # Systemd service files └── install.sh # Installation script ```

🔐 Security

• All passwords are hashed with bcrypt
• JWT-based authentication
• Rate limiting on API endpoints
• Path traversal protection
• SQL injection prevention with prepared statements
• CORS configuration
• Environment variables for sensitive data

🛡️ Production Deployment

1. Use a process manager

Install and configure PM2:

```bash npm install -g pm2 pm2 start server/index.js --name webpanel pm2 startup pm2 save ```

2. Configure Nginx reverse proxy

Create Nginx configuration for your domain:

```nginx server { listen 80; server_name panel.yourdomain.com;

location / {
    proxy_pass http://localhost:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
}

} ```

3. Set up SSL with Let's Encrypt

```bash sudo certbot --nginx -d panel.yourdomain.com ```

4. Configure firewall

```bash sudo ufw allow 80/tcp sudo ufw allow 443/tcp sudo ufw allow 3000/tcp sudo ufw enable ```

📝 Scripts

• pnpm dev - Start development servers (backend + frontend)
• pnpm dev:demo - Start development servers in demo mode (no sudo required)
• pnpm server:dev - Start backend development server
• pnpm client:dev - Start frontend development server
• pnpm build - Build frontend for production
• pnpm start - Start production server
• pnpm setup - Create admin user
• pnpm migrate - Run database migrations

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License.

🐛 Bug Reports

If you find a bug, please open an issue on GitHub with:

• Description of the bug
• Steps to reproduce
• Expected behavior
• Screenshots (if applicable)

💬 Support

For support, please open an issue on GitHub or contact the maintainers.

🗺️ Roadmap

• File editor with syntax highlighting (Monaco Editor)
• Cron job management
• Email account management
• FTP account management
• PHP version switcher per site
• Multi-user support with permissions
• Statistics and analytics
• Auto-backups scheduling
• One-click WordPress installation
• Docker container management
• API documentation

Made with ❤️ for VPS server management