- 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
144 lines
4.3 KiB
Markdown
144 lines
4.3 KiB
Markdown
# Быстрый старт - 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. **Не забывайте отключаться** после использования
|
||
|
||
---
|
||
|
||
**Приятного использования! 🚀**
|