Initial commit

2026-01-14 20:23:10 +06:00
commit 954dd473d1
57 changed files with 8854 additions and 0 deletions
--- a/DEBUG_GUIDE.md
+++ b/DEBUG_GUIDE.md
@@ -0,0 +1,155 @@
+# Руководство по отладке проблем
+
+## Проблема: После запуска сервера пропадают файлы/настройки/статистика
+
+### Причина
+Процесс сервера блокирует выполнение или завершается с ошибкой.
+
+### Диагностика
+
+1. **Проверьте логи бэкенда** (терминал где запущен `python main.py`):
+   ```
+   Сервер test_server запущен с PID 12345
+   Начало чтения вывода для сервера test_server
+   ```
+
+2. **Проверьте консоль браузера** (F12):
+   ```javascript
+   // Должны быть логи:
+   Сервер запущен: {message: "Сервер запущен", pid: 12345}
+   ```
+
+3. **Проверьте, запустился ли Java процесс**:
+   ```bash
+   # Windows
+   tasklist | findstr java
+   
+   # Должен показать процесс java.exe
+   ```
+
+4. **Проверьте наличие server.jar**:
+   - Откройте папку `backend/servers/ИМЯ_СЕРВЕРА/`
+   - Убедитесь, что там есть файл `server.jar` или другой .jar файл
+   - Проверьте команду запуска в настройках сервера
+
+### Решение
+
+#### Если server.jar отсутствует:
+
+1. Скачайте server.jar для Minecraft
+2. Загрузите через менеджер файлов в панели
+3. Убедитесь, что команда запуска правильная
+
+#### Если Java не установлена:
+
+1. Установите Java 17 или новее
+2. Проверьте установку:
+   ```bash
+   java -version
+   ```
+
+#### Если процесс запускается но сразу завершается:
+
+1. Проверьте логи в консоли панели
+2. Возможно нужно принять EULA:
+   - Откройте файл `eula.txt` через редактор в панели
+   - Измените `eula=false` на `eula=true`
+   - Сохраните и перезапустите сервер
+
+#### Если команда запуска неправильная:
+
+1. Перейдите в Настройки сервера
+2. Измените команду запуска, например:
+   ```
+   java -Xmx2G -Xms1G -jar server.jar nogui
+   ```
+3. Сохраните настройки
+4. Запустите сервер
+
+## Проблема: Сервер не останавливается
+
+### Причина
+Процесс не отвечает на команду stop.
+
+### Решение
+
+1. **Через панель**: Подождите 30 секунд, процесс будет принудительно завершен
+
+2. **Вручную через Task Manager**:
+   - Откройте Диспетчер задач (Ctrl+Shift+Esc)
+   - Найдите процесс `java.exe`
+   - Завершите процесс
+   - Обновите страницу панели
+
+## Проблема: Консоль не показывает логи
+
+### Причина
+WebSocket не подключается или процесс не выводит логи.
+
+### Диагностика
+
+1. **Проверьте консоль браузера**:
+   ```
+   WebSocket подключен
+   ```
+
+2. **Проверьте логи бэкенда**:
+   ```
+   WebSocket подключен для сервера: test_server
+   Отправка X существующих логов
+   ```
+
+### Решение
+
+1. Перезапустите сервер
+2. Обновите страницу панели (F5)
+3. Проверьте, что сервер действительно запущен
+
+## Проблема: Статистика показывает неправильный статус
+
+### Причина
+Процесс завершился, но панель не обновилась.
+
+### Решение
+
+1. Обновите страницу (F5)
+2. Статус обновляется автоматически каждые 5 секунд
+3. Проверьте логи бэкенда на наличие ошибок
+
+## Полезные команды для отладки
+
+### Проверка портов
+```bash
+# Windows
+netstat -ano | findstr :8000
+netstat -ano | findstr :3000
+```
+
+### Проверка процессов Java
+```bash
+# Windows
+tasklist | findstr java
+
+# Убить все процессы Java (ОСТОРОЖНО!)
+taskkill /F /IM java.exe
+```
+
+### Очистка и перезапуск
+
+1. Остановите все серверы в панели
+2. Закройте бэкенд (Ctrl+C)
+3. Закройте фронтенд (Ctrl+C)
+4. Убейте все процессы Java если нужно
+5. Запустите бэкенд заново
+6. Запустите фронтенд заново
+7. Обновите страницу в браузере
+
+## Логи для отправки при обращении за помощью
+
+Если проблема не решается, соберите следующую информацию:
+
+1. **Логи бэкенда** (последние 50 строк из терминала)
+2. **Консоль браузера** (F12 → Console, скриншот или текст)
+3. **Network вкладка** (F12 → Network, покажите неудачные запросы)
+4. **Содержимое папки сервера** (список файлов)
+5. **Команда запуска** из настроек сервера