Files
Go-VPN-Client/Markdown/QUICK_START_GUI.md
arkonsadter e0a5f0f746 feat(gui): add GUI (Test) implementation with documentation and admin support
- Add GUI (Test) module with Fyne-based interface (internal/gui/gui.go, internal/gui/server.go)
- Add CLI monitoring capability (internal/cli/monitor.go)
- Add main_cli.go entry point for CLI-only builds
- Add comprehensive documentation suite covering setup, build, quick start, and changelog
- Add admin manifest (admin.manifest) for Windows UAC elevation support
- Add rsrc.syso.json configuration for resource embedding
- Update .gitignore to exclude build scripts (*.bat, *.sh)
- Update main.go and cli.go to support dual GUI (Test)/CLI modes
- Update README.md with new project information
- Enables users to build and run both GUI (Test)and CLI versions with proper admin privileges on Windows
2026-04-06 18:57:58 +06:00

4.3 KiB
Raw Blame History

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

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

Windows

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

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

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

Linux/macOS

# 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:

vpn-client-gui --cli

📝 Логи

Все логи в папке logs/:

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

Проблемы?

Не запускается:

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. Не забывайте отключаться после использования

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