Initial release

2026-05-25 08:51:43 +03:00 · 2026-03-04 17:20:07 +03:00
parent 9aff5ec398
commit 10266ae822
8 changed files with 1714 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,115 @@
+# TG WS Proxy
+
+Локальный SOCKS5-прокси для Telegram Desktop, который перенаправляет трафик через WebSocket-соединения к указанным серверам, помогая частично ускорить работу Telegram.
+
+## Как это работает
+
+```
+Telegram Desktop → SOCKS5 (127.0.0.1:1080) → TG WS Proxy → WSS (kws*.web.telegram.org) → Telegram DC
+```
+
+1. Приложение поднимает локальный SOCKS5-прокси на `127.0.0.1:1080`
+2. Перехватывает подключения к IP-адресам Telegram
+3. Извлекает DC ID из MTProto obfuscation init-пакета
+4. Устанавливает WebSocket (TLS) соединение к соответствующему DC через домены `kws{N}.web.telegram.org`
+5. Если WS недоступен (302 redirect) — автоматически переключается на прямое TCP-соединение
+
+## Установка
+
+### Из исходников
+
+```bash
+pip install -r requirements.txt
+```
+
+## Использование
+
+### Tray-приложение (рекомендуется для Windows)
+
+```bash
+python tg_ws_tray.py
+```
+
+При первом запуске откроется окно с инструкцией по подключению Telegram Desktop. Приложение сворачивается в системный трей.
+
+**Меню трея:**
+- **Открыть в Telegram** — автоматически настроить прокси через `tg://socks` ссылку
+- **Перезапустить прокси** — перезапуск без выхода из приложения
+- **Настройки...** — GUI-редактор конфигурации
+- **Открыть логи** — открыть файл логов
+- **Выход** — остановить прокси и закрыть приложение
+
+### Консольный режим
+
+```bash
+python tg_ws_proxy.py [--port PORT] [--dc-ip DC:IP ...] [-v]
+```
+
+**Аргументы:**
+
+| Аргумент | По умолчанию | Описание |
+|---|---|---|
+| `--port` | `1080` | Порт SOCKS5-прокси |
+| `--dc-ip` | `2:149.154.167.220`, `4:149.154.167.220` | Целевой IP для DC (можно указать несколько раз) |
+| `-v`, `--verbose` | выкл. | Подробное логирование (DEBUG) |
+
+**Примеры:**
+
+```bash
+# Стандартный запуск
+python tg_ws_proxy.py
+
+# Другой порт и дополнительные DC
+python tg_ws_proxy.py --port 9050 --dc-ip 1:149.154.175.205 --dc-ip 2:149.154.167.220
+
+# С подробным логированием
+python tg_ws_proxy.py -v
+```
+
+## Настройка Telegram Desktop
+
+### Автоматически
+
+ПКМ по иконке в трее → **«Открыть в Telegram»**
+
+### Вручную
+
+1. Telegram → **Настройки** → **Продвинутые настройки** → **Тип подключения** → **Прокси**
+2. Добавить прокси:
+   - **Тип:** SOCKS5
+   - **Сервер:** `127.0.0.1`
+   - **Порт:** `1080`
+   - **Логин/Пароль:** оставить пустыми
+
+## Конфигурация
+
+Tray-приложение хранит конфигурацию в `%APPDATA%/TgWsProxy/config.json`:
+
+```json
+{
+  "port": 1080,
+  "dc_ip": [
+    "2:149.154.167.220",
+    "4:149.154.167.220"
+  ],
+  "verbose": false
+}
+```
+
+Логи записываются в `%APPDATA%/TgWsProxy/proxy.log`.
+
+## Сборка exe
+
+Проект содержит спецификацию PyInstaller ([`tg_ws_proxy.spec`](tg_ws_proxy.spec)) и GitHub Actions workflow ([`.github/workflows/build.yml`](.github/workflows/build.yml)) для автоматической сборки.
+
+```bash
+pip install pyinstaller
+pyinstaller tg_ws_proxy.spec
+```
+
+## Дисклеймер
+Проект частично vibecoded by Opus 4.6. Если вы найдете баг, то создайте Issue с его описанем.
+
+## Лицензия
+
+[MIT License](LICENSE)