# Быстрый старт - GUI версия

## 🚀 Установка за 3 шага

### Windows

```bash
# 1. Инициализация
init_gui.bat

# 2. Сборка
build_gui.bat

# 3. Запуск
vpn-client-gui.exe
```

### Linux/macOS

```bash
# 1. Инициализация
chmod +x init_gui.sh build_gui.sh
./init_gui.sh

# 2. Сборка
./build_gui.sh

# 3. Запуск
./vpn-client-gui
```

## 📱 Первое использование

### Вариант 1: Быстрое подключение (есть VLESS URL)

1. Запустите приложение
2. Перейдите на вкладку **VLESS**
3. Нажмите **Добавить**
4. Введите имя и вставьте VLESS URL
5. Нажмите **Подключиться**
6. Готово! Прокси: `127.0.0.1:10808`

### Вариант 2: Использование подписки

1. Запустите приложение
2. Перейдите на вкладку **Подписки**
3. Нажмите **Добавить**
4. Введите имя и URL подписки
5. Нажмите **Обновить конфиги**
6. Нажмите **Тест серверов** (опционально)
7. Перейдите на вкладку **VLESS**
8. Выберите сервер с префиксом `[Имя подписки]`
9. Нажмите **Подключиться**
10. Готово!

### Вариант 3: WireGuard

1. Запустите приложение
2. Перейдите на вкладку **WireGuard**
3. Нажмите **Из файла** или **Добавить вручную**
4. Добавьте конфигурацию
5. Нажмите **Подключиться**
6. Готово!

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

### Firefox (быстро)

1. `about:preferences#general` → Параметры сети → Настроить
2. SOCKS Host: `127.0.0.1`, Port: `10808`, SOCKS v5
3. ✓ Использовать прокси DNS

### Chrome + Proxy SwitchyOmega

1. Установите расширение Proxy SwitchyOmega
2. Создайте профиль: SOCKS5, `127.0.0.1:10808`
3. Активируйте профиль

## 🎯 Основные функции

| Функция | Описание |
|---------|----------|
| 🟢 Индикатор статуса | Серый = отключено, Зеленый = подключено |
| ⏱️ Таймер | Время текущего подключения |
| 📊 Статистика | Трафик для WireGuard |
| 🧪 Тест серверов | Проверка пинга перед подключением |
| 🔄 Автообновление | Статус обновляется каждые 2 секунды |
| 📋 Подписки | Автоматическая загрузка серверов |

## 🔧 CLI режим

Для использования без GUI:

```bash
vpn-client-gui --cli
```

## 📝 Логи

Все логи в папке `logs/`:
- `vless.log` - основной лог
- `vless_access.log` - IP адреса
- `vless_error.log` - ошибки
- `vless_traffic_*.log` - трафик
- `wireguard.log` - WireGuard
- `subscription.log` - подписки

## ❓ Проблемы?

**Не запускается:**
```bash
go mod tidy
# Пересоберите приложение
```

**VLESS не подключается:**
- Проверьте URL
- Используйте "Тест (Ping)"
- Проверьте логи

**WireGuard не работает:**
- Windows: Установите WireGuard с официального сайта
- Linux: `sudo apt install wireguard`
- macOS: `brew install wireguard-tools`

## 📚 Дополнительно

- Полное руководство: `GUI_GUIDE.md`
- История изменений: `CHANGELOG_GUI.md`
- Примеры: `EXAMPLES.md`
- README: `README.md`

## 💡 Советы

1. **Тестируйте серверы** перед подключением
2. **Обновляйте подписки** регулярно
3. **Проверяйте логи** при проблемах
4. **Используйте серверы с пингом < 100ms**
5. **Не забывайте отключаться** после использования

---

**Приятного использования! 🚀**