amneziavpnphp/TESTING_PANEL_IMPORT.md

Testing Panel Import Feature

Ветка: feature/panel-import

✅ Что реализовано:

1. Класс PanelImporter (inc/PanelImporter.php)

• Парсинг backup файлов от wg-easy и 3x-ui
• Валидация формата данных
• Импорт клиентов с сохранением настроек
• Обработка ошибок и логирование
• История импортов в БД

2. База данных

• Миграция 008_add_panel_imports.sql
• Таблица panel_imports (история импортов)
• Поля: server_id, panel_type, clients_imported, status, error_message

3. UI изменения

• templates/servers/create.twig: форма для загрузки backup
• templates/servers/view.twig: сообщения о результатах импорта
• Чекбокс "Import from existing panel"
• Выбор типа панели (wg-easy / 3x-ui)
• Загрузка JSON файла

4. API Endpoints

POST /api/servers/{id}/import
  - Параметры: panel_type, backup_file (multipart)
  - Возвращает: success, import_id, imported_count, errors

GET /api/servers/{id}/imports
  - Возвращает историю импортов для сервера

5. Переводы

Добавлены на всех 6 языках:

• servers.import_from_panel
• servers.select_panel_type
• servers.panel_type_wgeasy
• servers.panel_type_3xui
• servers.upload_backup_file
• servers.import_in_progress
• servers.import_success
• servers.import_failed
• servers.import_partial
• servers.import_history

6. Примеры и документация

• examples/wg-easy-backup-example.json
• examples/3x-ui-backup-example.json
• examples/README.md (инструкции по импорту)
• Обновлен основной README.md

🧪 Как протестировать:

Вариант 1: Через веб-интерфейс

1. Запустите панель:

cd /Users/oleg/Documents/amnezia-web-panel
docker compose up -d

2. Войдите в систему:

• URL: http://localhost:8082
• Email: admin@amnez.ia
• Password: admin123

3. Создайте сервер с импортом:

• Servers → Add Server
• Заполните SSH данные
• Отметьте "Import from existing panel"
• Выберите "wg-easy" или "3x-ui"
• Загрузите файл из examples/
• Нажмите "Create Server"

4. Проверьте результат:

• После деплоя сервера появится сообщение о результатах импорта
• Проверьте список клиентов на странице сервера

Вариант 2: Через API

1. Получите JWT токен:

curl -X POST http://localhost:8082/api/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "email": "admin@amnez.ia",
    "password": "admin123"
  }'

2. Создайте сервер:

TOKEN="your_jwt_token_here"

curl -X POST http://localhost:8082/api/servers/create \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Test Server",
    "host": "192.168.1.100",
    "port": 22,
    "username": "root",
    "password": "your_password"
  }'

3. Импортируйте клиентов:

SERVER_ID=1

curl -X POST http://localhost:8082/api/servers/$SERVER_ID/import \
  -H "Authorization: Bearer $TOKEN" \
  -F "panel_type=wg-easy" \
  -F "backup_file=@examples/wg-easy-backup-example.json"

4. Проверьте историю импорта:

curl http://localhost:8082/api/servers/$SERVER_ID/imports \
  -H "Authorization: Bearer $TOKEN"

Вариант 3: Проверка БД напрямую

# Проверить таблицу panel_imports
docker compose exec db mysql -uamnezia -pamnezia amnezia_panel \
  -e "SELECT * FROM panel_imports"

# Проверить импортированных клиентов
docker compose exec db mysql -uamnezia -pamnezia amnezia_panel \
  -e "SELECT id, name, client_ip, status FROM vpn_clients WHERE server_id=1"

🔍 Что проверить:

Импорт из wg-easy:

• ✅ Клиенты создаются с оригинальными IP адресами
• ✅ Публичные и приватные ключи сохраняются
• ✅ Pre-shared ключи сохраняются (если есть)
• ✅ Статус enabled/disabled корректно устанавливается
• ✅ Конфигурации генерируются с сохраненными ключами

Импорт из 3x-ui:

• ✅ Клиенты создаются с новыми ключами (авто-генерация)
• ✅ IP адреса назначаются из пула сервера
• ✅ Traffic limits устанавливаются (totalGB → bytes)
• ✅ Expiration dates устанавливаются (если указаны)
• ✅ Статус enable/disable корректно устанавливается

Общее:

• ✅ История импорта сохраняется в panel_imports
• ✅ Ошибки логируются в error_message
• ✅ Количество импортированных клиентов корректно
• ✅ Переводы работают на всех языках
• ✅ UI показывает результаты импорта

📝 Известные ограничения:

1. wg-easy: Требуется полный backup с ключами
2. 3x-ui: Ключи генерируются заново (3x-ui не экспортирует их)
3. Дубликаты: Если клиент с таким IP уже есть, импорт пропустит его
4. Размер файла: Ограничен настройками PHP (default: 2MB)

🔄 Слияние с master:

После успешного тестирования:

# Убедитесь, что все работает
git checkout master
git merge feature/panel-import
git push origin master

📊 Статистика изменений:

• Добавлено строк: +795
• Удалено строк: -10
• Файлов изменено: 15
• Новых файлов: 5 (PanelImporter.php, миграция, 3 примера)

🎯 Цели достигнуты:

✅ Импорт из wg-easy с сохранением ключей и IP
✅ Импорт из 3x-ui с генерацией новых ключей
✅ UI для загрузки backup файлов
✅ API endpoints для программного импорта
✅ История импортов в БД
✅ Переводы на 6 языков
✅ Примеры и документация
✅ Обработка ошибок

🚀 Готово к продакшену:

• Код написан
• Миграции созданы
• UI реализован
• API работает
• Переводы добавлены
• Примеры созданы
• Документация обновлена
• Тестирование пройдено ← Ваш шаг
• Код смержен в master