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
This commit is contained in:
143
Markdown/QUICK_START_GUI.md
Normal file
143
Markdown/QUICK_START_GUI.md
Normal file
@@ -0,0 +1,143 @@
|
||||
# Быстрый старт - 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. **Не забывайте отключаться** после использования
|
||||
|
||||
---
|
||||
|
||||
**Приятного использования! 🚀**
|
||||
Reference in New Issue
Block a user