Go-VPN-Client/Markdown/GUI_GUIDE.md

GUI Руководство пользователя

Установка и запуск

Windows

1. Инициализация зависимостей:

init_gui.bat

2. Сборка приложения:

build_gui.bat

3. Запуск:

vpn-client-gui.exe

Linux/macOS

1. Инициализация зависимостей:

chmod +x init_gui.sh
./init_gui.sh

2. Сборка приложения:

chmod +x build_gui.sh
./build_gui.sh

3. Запуск:

./vpn-client-gui

Интерфейс приложения

Главное окно

Приложение имеет современный интерфейс с тремя основными вкладками:

1. WireGuard - управление WireGuard конфигурациями
2. VLESS - управление VLESS конфигурациями
3. Подписки - управление подписками на серверы

Панель статуса

В верхней части окна отображается:

• Индикатор подключения (серый/зеленый кружок)
• Статус: "Не подключено" или "Подключено"
• Информация о подключении:
  • Имя конфигурации
  • Тип протокола
  • Время подключения
  • Прокси адрес (для VLESS)
  • Статистика трафика (для WireGuard)

Работа с WireGuard

Добавление конфигурации

Вручную:

1. Перейдите на вкладку "WireGuard"
2. Нажмите "Добавить вручную"
3. Введите имя конфигурации
4. Вставьте текст конфигурации WireGuard
5. Нажмите "Добавить"

Из файла:

1. Нажмите "Из файла"
2. Выберите файл конфигурации (.conf)
3. Введите имя конфигурации
4. Нажмите "Добавить"

Подключение

1. Выберите конфигурацию из списка
2. Нажмите "Подключиться"
3. Дождитесь подтверждения подключения

Удаление конфигурации

1. Выберите конфигурацию из списка
2. Нажмите "Удалить"
3. Подтвердите удаление

Работа с VLESS

Добавление конфигурации

1. Перейдите на вкладку "VLESS"
2. Нажмите "Добавить"
3. Введите имя конфигурации
4. Вставьте VLESS URL (начинается с vless://)
5. Нажмите "Добавить"

Тестирование сервера

1. Выберите конфигурацию из списка
2. Нажмите "Тест (Ping)"
3. Дождитесь результатов:
   • Пинг в миллисекундах
   • Оценка качества (Отлично/Хорошо/Средне/Плохо)

Подключение

1. Выберите конфигурацию из списка
2. Нажмите "Подключиться"
3. После подключения используйте SOCKS5 прокси: 127.0.0.1:10808

Удаление конфигурации

1. Выберите конфигурацию из списка
2. Нажмите "Удалить"
3. Подтвердите удаление

Работа с подписками

Добавление подписки

1. Перейдите на вкладку "Подписки"
2. Нажмите "Добавить"
3. Введите имя подписки
4. Введите URL подписки
5. Нажмите "Добавить"

Обновление конфигураций

1. Выберите подписку из списка
2. Нажмите "Обновить конфиги"
3. Дождитесь загрузки конфигураций
4. Конфиги появятся на вкладке "VLESS" с префиксом [Имя подписки]

Просмотр конфигураций

1. Выберите подписку из списка
2. Нажмите "Показать конфиги"
3. Откроется окно со списком всех конфигов из подписки

Тестирование серверов

1. Выберите подписку из списка
2. Нажмите "Тест серверов"
3. Дождитесь завершения тестирования всех серверов
4. Откроется окно с результатами:
   • Топ-10 лучших серверов по пингу
   • Количество доступных/недоступных серверов

Удаление подписки

1. Выберите подписку из списка
2. Нажмите "Удалить"
3. Подтвердите удаление

Отключение от VPN

1. Нажмите кнопку "Отключиться" внизу окна
2. Подтвердите отключение
3. Статус изменится на "Не подключено"

Настройка браузера

После подключения к VLESS серверу настройте браузер:

Firefox

1. Откройте: about:preferences#general
2. Прокрутите до "Параметры сети"
3. Нажмите "Настроить..."
4. Выберите "Ручная настройка прокси"
5. SOCKS Host: 127.0.0.1
6. Port: 10808
7. Выберите "SOCKS v5"
8. Отметьте "Использовать прокси DNS при использовании SOCKS v5"
9. Нажмите "OK"

Chrome (с расширением Proxy SwitchyOmega)

1. Установите расширение "Proxy SwitchyOmega"
2. Создайте новый профиль
3. Protocol: SOCKS5
4. Server: 127.0.0.1
5. Port: 10808
6. Сохраните и активируйте профиль

CLI режим

Для использования в консольном режиме (без GUI):

# Windows
vpn-client-gui.exe --cli

# Linux/macOS
./vpn-client-gui --cli

Логи

Все логи сохраняются в папке logs/:

• vless.log - основной лог VLESS
• vless_access.log - лог доступа (IP адреса)
• vless_error.log - лог ошибок
• vless_traffic_*.log - логи трафика для каждого подключения
• wireguard.log - лог WireGuard
• subscription.log - лог подписок

Горячие клавиши

• Ctrl+Q - Выход из приложения
• F5 - Обновить списки

Устранение неполадок

Приложение не запускается

1. Убедитесь, что установлены все зависимости:

   go mod tidy
   

2. Пересоберите приложение:

   # Windows
   build_gui.bat
   
   # Linux/macOS
   ./build_gui.sh
   

Не удается подключиться к VLESS

1. Проверьте правильность VLESS URL
2. Используйте "Тест (Ping)" для проверки доступности сервера
3. Проверьте логи в папке logs/
4. Убедитесь, что Xray находится в папке xray/

Не удается подключиться к WireGuard

Windows:

• Убедитесь, что WireGuard установлен: https://www.wireguard.com/install/
• Запустите приложение от имени администратора

Linux:

sudo apt install wireguard
# или
sudo yum install wireguard-tools

macOS:

brew install wireguard-tools

Прокси не работает

1. Убедитесь, что VPN подключен (зеленый индикатор)
2. Проверьте настройки прокси в браузере: 127.0.0.1:10808
3. Проверьте логи на наличие ошибок

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

• ОС: Windows 10+, Linux (любой дистрибутив), macOS 10.13+
• RAM: 50 MB минимум
• Диск: 100 MB свободного места
• Дополнительно:
  • Xray-core (включен в проект)
  • WireGuard (для использования WireGuard протокола)

Безопасность

• Все конфигурации хранятся локально в папке .vpn_client/
• Пароли и ключи не передаются третьим лицам
• Логи содержат только техническую информацию
• Рекомендуется использовать надежные VPN провайдеры

Поддержка

При возникновении проблем:

1. Проверьте логи в папке logs/
2. Убедитесь, что используете последнюю версию
3. Проверьте конфигурацию сервера
4. Попробуйте другой сервер из подписки