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

144 lines
4.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Быстрый старт - 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. **Не забывайте отключаться** после использования
---
**Приятного использования! 🚀**