SuperVPN/Docs/DETAILED_LOGGING_GUIDE.md

VIDEOREADER GLOBAL EDITION - ДЕТАЛЬНОЕ ЛОГГИРОВАНИЕ

🔍 ОБЗОР СИСТЕМЫ ЛОГГИРОВАНИЯ

VideoReader Global Edition теперь включает продвинутую систему детального логгирования, которая записывает каждый шаг подключения к серверу, все входящие и исходящие пакеты, а также специальные события подключения телефонов.

📊 ВОЗМОЖНОСТИ ЛОГГИРОВАНИЯ

✅ Что логгируется:

• DNS запросы и разрешения - Все IP адреса сервера
• TCP подключения - Время установки соединения, таймауты
• Шифрование/дешифрование - Ключи AES, статус операций
• Пакеты данных - HEX дамп, ASCII представление, размер
• Подключения телефонов - Специальные события устройств
• Ошибки и исключения - Полная трассировка стека
• Статистика сессии - Объем переданных данных, время работы

📁 Форматы логгирования:

1. Пакеты данных (с HEX дампом):

[PACKET] Direction: INCOMING
Size: 64 bytes  
HEX: 4A B2 C3 D4...
ASCII: J...
Binary dump:
00000000: 4A B2 C3 D4 E5 F6 07 18 29 3A 4B 5C 6D 7E 8F 90 | J.......:K\m~..

2. Подключения:

[CONNECTION] Starting connection to vidser.top:3033...
[CONNECTION] DNS resolved to 4 addresses: 104.21.41.7, 172.67.141.34...
[CONNECTION] TCP connection established in 127ms

3. Подключения телефонов:

[PHONE] Action: Phone connection detected | Phone: Device-ID-12345

🚀 ИСПОЛЬЗОВАНИЕ

Запуск с логгированием:

./VideoReader-Global

Интерактивные команды:

• s - Показать статистику трафика
• d - Отправить тестовые данные
• q - Выход из программы

Файл лога:

• Имя: videoreader_detailed_YYYY-MM-DD_HH-mm-ss.log
• Расположение: В папке с исполняемым файлом
• Формат: Текстовый файл с временными метками

📋 ПРИМЕР РАБОТЫ

Консольный вывод:

VideoReader Global Edition v1.0
===================================

Detailed logging initialized: videoreader_detailed_2025-10-09_10-33-45.log
Loaded server configuration: vidser.top:3033
Channel: 0
Server Type: standard

[CONNECTION] InOutSocket initialized with server: vidser.top:3033
[CONNECTION] Starting connection to vidser.top:3033...
[CONNECTION] Attempting TCP connection to vidser.top:3033...

Application running in console mode.
Commands:
  's' - Show statistics  
  'q' - Quit
  'd' - Send test data

Содержимое лог файла:

=== VideoReader Global Edition Detailed Log ===
Session started: 2025-10-09 10:33:45.736
Process ID: 213168
Machine: trevor-pc
User: trevor
==============================================

[2025-10-09 10:33:45.740] [INFO] [Thread-1] Application started
[2025-10-09 10:33:45.769] [INFO] [Thread-1] Loaded server configuration: vidser.top:3033
[2025-10-09 10:33:45.770] [CONNECTION] [Thread-1] InOutSocket initialized with server: vidser.top:3033
[2025-10-09 10:33:45.773] [DEBUG] [Thread-1] Encryption keys initialized - Key: 64-41-E1-74...
[2025-10-09 10:33:45.775] [CONNECTION] [Thread-1] Starting connection to vidser.top:3033...
[2025-10-09 10:33:45.775] [DEBUG] [Thread-1] Resolving DNS for vidser.top...
[2025-10-09 10:33:45.892] [DEBUG] [Thread-1] DNS resolved to 4 addresses: 104.21.41.7, 172.67.141.34...
[2025-10-09 10:33:45.903] [CONNECTION] [Thread-1] Attempting TCP connection to vidser.top:3033...

🔧 ТЕХНИЧЕСКИЕ ДЕТАЛИ

Уровни логгирования:

• INFO - Общая информация о работе приложения
• CONNECTION - События подключения к серверу
• PACKET - Детали пакетов данных с HEX дампом
• PHONE - События подключения устройств
• DEBUG - Отладочная информация
• ERROR - Ошибки с полной трассировкой

Многопоточность:

• Безопасность для многопоточного доступа (thread-safe)
• Отдельные потоки для отправки и получения данных
• Синхронизация записи в лог файл

Производительность:

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

📝 КОНФИГУРАЦИЯ

Логгирование автоматически инициализируется при запуске приложения. Никаких дополнительных настроек не требуется.

Для изменения сервера отредактируйте server-config.json:

{
  "ServerType": "samsung",
  "ServerAddress": "s1.cc-vst.online",
  "Port": 3234,
  "Channel": 44,
  "Description": "Samsung VideoReader server"
}

🎯 ПРЕИМУЩЕСТВА

1. Полная прозрачность - Видите каждый байт передаваемых данных
2. Отладка подключений - Детальная информация о проблемах сети
3. Мониторинг телефонов - Специальное отслеживание устройств
4. Анализ протокола - HEX дампы для изучения протокола
5. Архивирование сессий - Каждая сессия сохраняется в отдельный файл

🔍 АНАЛИЗ ЛОГОВ

Файлы логов можно анализировать с помощью:

• grep для поиска определенных событий
• tail -f для мониторинга в реальном времени
• hexdump для анализа двоичных данных
• Любые текстовые редакторы и IDE

Примеры команд:

# Отслеживание подключений
grep "CONNECTION" videoreader_detailed_*.log

# Поиск пакетов от телефонов
grep "PHONE" videoreader_detailed_*.log

# Мониторинг ошибок
grep "ERROR" videoreader_detailed_*.log

# Мониторинг в реальном времени
tail -f videoreader_detailed_*.log

---

VideoReader Global Edition v1.0 с детальным логгированием готов к использованию!