tg-ws-proxy-go/FAQ.md

# ❓ Частые вопросы (FAQ)

## 📌 Для новичков

### Что такое TG WS Proxy?

**TG WS Proxy** — это программа, которая ускоряет работу Telegram в регионах, где он заблокирован или работает медленно. Она создаёт локальный прокси-сервер на вашем компьютере и перенаправляет трафик Telegram через WebSocket-соединения.

### Зачем мне это нужно?

- 🚀 **Ускорение Telegram** — если Telegram работает медленно
- 🔓 **Обход блокировок** — если Telegram заблокирован провайдером
- 🔒 **Безопасность** — весь трафик остаётся зашифрованным
- 💻 **Локально** — не нужны сторонние сервера, всё работает на вашем ПК

### Это безопасно?

**Да!** Программа:
- ✅ Не хранит ваши данные
- ✅ Не передаёт информацию третьим лицам
- ✅ Работает локально на вашем компьютере
- ✅ Имеет открытый исходный код (можно проверить)

---

## 🚀 Установка и запуск

### Как установить?

**Windows:**
1. Скачайте `TgWsProxy_windows_amd64.exe` из [Releases](https://github.com/y0sy4/tg-ws-proxy-go/releases)
2. Сохраните в любую папку (например, `C:\Programs\TgWsProxy\`)
3. Запустите файл

**macOS:**
1. Скачайте `TgWsProxy_darwin_amd64` (Intel) или `TgWsProxy_darwin_arm64` (Apple Silicon)
2. Откройте Терминал и выполните:
   ```bash
   chmod +x ~/Downloads/TgWsProxy_darwin_amd64
   ~/Downloads/TgWsProxy_darwin_amd64
   ```

**Linux:**
1. Скачайте `TgWsProxy_linux_amd64`
2. Откройте терминал и выполните:
   ```bash
   chmod +x ~/Downloads/TgWsProxy_linux_amd64
   ~/Downloads/TgWsProxy_linux_amd64
   ```

### Я запустил, но ничего не происходит!

Это нормально! Программа работает в фоновом режиме. Проверьте:

**Windows:**
- Откройте Диспетчер задач → Процессы
- Найдите `TgWsProxy.exe`

**macOS/Linux:**
- Откройте Терминал
- Выполните `ps aux | grep TgWsProxy`

### Как проверить что работает?

1. Откройте браузер
2. Перейдите на `http://127.0.0.1:1080`
3. Если видите ошибку — **это хорошо!** Значит прокси работает (это не веб-сервер)

Или посмотрите логи:
- **Windows:** `%APPDATA%\TgWsProxy\proxy.log`
- **Linux/macOS:** `~/.TgWsProxy/proxy.log`

---

## 🔧 Настройка Telegram

### Как настроить прокси в Telegram?

**Автоматически:**
При запуске программа сама откроет Telegram с настройками прокси. Просто подтвердите!

**Вручную:**

**Telegram Desktop:**
1. Откройте **Настройки** → **Продвинутые** → **Тип подключения** → **Прокси**
2. Нажмите **Добавить прокси**
3. Выберите **SOCKS5**
4. Введите:
   - **Сервер:** `127.0.0.1`
   - **Порт:** `1080`
   - **Логин:** (оставьте пустым)
   - **Пароль:** (оставьте пустым)
5. Нажмите **Сохранить**

**Telegram на Android:**
1. Настройки → Данные и память → Прокси-сервер
2. Включить прокси
3. Добавить прокси
4. Тип: **SOCKS5**
5. Хост: `127.0.0.1`
6. Порт: `1080`

**Telegram на iOS:**
1. Настройки → Данные и память → Использовать прокси
2. Включить прокси
3. Добавить прокси
4. Тип: **SOCKS5**
5. Хост: `127.0.0.1`
6. Порт: `1080`

### Telegram не открывается автоматически!

Это нормально. Настройте вручную (см. выше) или:

1. Откройте браузер
2. Перейдите по ссылке: `tg://socks?server=127.0.0.1&port=1080`
3. Telegram должен открыться с настройками прокси

---

## 🔍 Решение проблем

### "Прокси не подключается"

**Проверьте:**
1. Запущена ли программа `TgWsProxy`
2. Не блокирует ли антивирус
3. Правильно ли настроен Telegram (127.0.0.1:1080)

**Попробуйте:**
1. Перезапустите `TgWsProxy`
2. Перезапустите Telegram
3. Проверьте логи программы

### "Слишком много подключений"

Это нормально! Программа создаёт пул соединений для ускорения работы.

### "Не работает IPv6"

Программа поддерживает IPv6 через NAT64. Если у вас только IPv6:
- Попробуйте включить IPv4 на роутере
- Или используйте VPN для доступа к IPv4

### Антивирус блокирует программу!

Это ложное срабатывание. Добавьте программу в исключения:
- Программа имеет открытый исходный код
- Не содержит вредоносного кода
- Работает только с Telegram

### Как обновить программу?

**Автоматически:**
При запуске программа проверит наличие новой версии и скачает её.

**Вручную:**
1. Скачайте новую версию из [Releases](https://github.com/y0sy4/tg-ws-proxy-go/releases)
2. Замените старый файл новым
3. Перезапустите программу

### Как удалить программу?

Просто удалите файл `TgWsProxy.exe` (или аналогичный для вашей ОС) и папку с логами:
- **Windows:** `%APPDATA%\TgWsProxy\`
- **Linux/macOS:** `~/.TgWsProxy/`

---

## ⚙️ Продвинутые настройки

### Как изменить порт?

```bash
TgWsProxy.exe --port 9050
```

### Как использовать аутентификацию?

```bash
TgWsProxy.exe --auth "username:password"
```

В Telegram укажите те же логин и пароль.

### Как выбрать другие DC сервера?

```bash
TgWsProxy.exe --dc-ip "2:149.154.167.220,4:149.154.167.220"
```

### Где логи программы?

- **Windows:** `%APPDATA%\TgWsProxy\proxy.log`
- **Linux:** `~/.TgWsProxy/proxy.log`
- **macOS:** `~/.TgWsProxy/proxy.log`

---

## 📞 Ещё вопросы?

Если вы не нашли ответ на свой вопрос:
- 📖 Прочитайте [документацию](https://github.com/y0sy4/tg-ws-proxy-go#readme)
- 🐛 Создайте [Issue](https://github.com/y0sy4/tg-ws-proxy-go/issues)
- 💬 Спросите в [Discussions](https://github.com/y0sy4/tg-ws-proxy-go/discussions)