yosya
/
tg-ws-proxy-go
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add FAQ and improve README for beginners

This commit is contained in:
y0sy4 2026-03-22 21:21:16 +03:00
parent 2401773b0a
commit 0b06798a59
2 changed files with 302 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

205
FAQ.md Normal file
View File

@ -0,0 +1,205 @@
# ❓ Частые вопросы (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)

97
README.md
View File

@ -10,6 +10,16 @@
Ускоряет работу Telegram через WebSocket-соединения напрямую к серверам Telegram.
---
## 👶 Вы новичок? Начните здесь!
1. **[📥 Скачать программу](https://github.com/y0sy4/tg-ws-proxy-go/releases)** — выберите свою платформу
2. **[❓ FAQ — Частые вопросы](FAQ.md)** — ответы на все вопросы
3. **[🚀 Быстрый старт](#быстрый-старт)** — инструкция по запуску
---
## Почему Go версия лучше
| Параметр | Python | Go |
@ -42,6 +52,55 @@ start run.bat
./TgWsProxy --port 9050 --dc-ip 2:149.154.167.220
```
---
## 📖 Подробная инструкция для новичков
### Шаг 1: Скачивание
1. Откройте страницу [Releases](https://github.com/y0sy4/tg-ws-proxy-go/releases)
2. Найдите свою платформу в таблице
3. Нажмите на ссылку скачивания (например, `TgWsProxy_windows_amd64.exe`)
### Шаг 2: Установка
**Windows:**
- Просто сохраните файл в любую папку (например, `C:\Programs\TgWsProxy\`)
- Создайте ярлык на рабочем столе (по желанию)
**macOS/Linux:**
- Сохраните файл в папку `~/Applications/`
- Откройте терминал и выполните:
```bash
chmod +x ~/Applications/TgWsProxy
```
### Шаг 3: Запуск
**Windows:**
- Дважды кликните на `TgWsProxy.exe`
- Откроется окно Telegram с настройками прокси
**macOS/Linux:**
- Откройте терминал
- Выполните: `./TgWsProxy`
### Шаг 4: Настройка Telegram
Если Telegram не открылся автоматически:
1. Откройте браузер
2. Перейдите по ссылке: `tg://socks?server=127.0.0.1&port=1080`
3. Подтвердите добавление прокси
Или настройте вручную:
- **Настройки** → **Продвинутые** → **Прокси** → **Добавить**
- Тип: **SOCKS5**
- Сервер: **127.0.0.1**
- Порт: **1080**
---
## Настройка Telegram Desktop
### Автоматическая настройка
@ -188,6 +247,44 @@ make android # Android (.aar библиотека)
| Время запуска | <100 ms |
| Задержка (pool hit) | <1 ms |
## 🔍 Решение проблем
### Прокси не подключается
**Проверьте:**
1. ✅ Запущена ли программа `TgWsProxy`
2. ✅ Правильно ли настроен Telegram (127.0.0.1:1080)
3. ✅ Не блокирует ли антивирус
**Попробуйте:**
1. Перезапустите `TgWsProxy`
2. Перезапустите Telegram
3. Проверьте логи: `%APPDATA%\TgWsProxy\proxy.log`
### Telegram не открывается автоматически
Откройте вручную: `tg://socks?server=127.0.0.1&port=1080`
Или настройте вручную (см. выше).
### Антивирус блокирует программу
Это ложное срабатывание. Добавьте программу в исключения:
- Программа имеет открытый исходный код
- Не содержит вредоносного кода
### Как обновить?
**Автоматически:** При запуске программа проверит и скачает обновление.
**Вручную:** Скачайте новую версию из [Releases](https://github.com/y0sy4/tg-ws-proxy-go/releases) и замените файл.
### Ещё вопросы?
Смотрите **[❓ FAQ](FAQ.md)** — там ответы на все вопросы!
---
## Требования
- **Go 1.21+** для сборки