6.0 KiB

Raw Blame History

[!CAUTION]

Реакция антивирусов

Windows Defender часто ошибочно помечает приложение как Wacatac.
Если вы не можете скачать из-за блокировки, то:

Попробуйте скачать версию win7 (она ничем не отличается в плане функционала)

Отключите антивирус на время скачивания, добавьте файл в исключения и включите обратно

Всегда проверяйте, что скачиваете из интернета, тем более из непроверенных источников. Всегда лучше смотреть на детекты широко известных антивирусов на VirusTotal

TG WS Proxy

Локальный SOCKS5-прокси для Telegram Desktop, который перенаправляет трафик через WebSocket-соединения к указанным серверам, помогая частично ускорить работу Telegram.

Ожидаемый результат аналогичен прокидыванию hosts для Web Telegram: ускорение загрузки и скачивания файлов, загрузки сообщений и части медиа.

Как это работает

Telegram Desktop → SOCKS5 (127.0.0.1:1080) → TG WS Proxy → WSS (kws*.web.telegram.org) → Telegram DC

Приложение поднимает локальный SOCKS5-прокси на 127.0.0.1:1080
Перехватывает подключения к IP-адресам Telegram
Извлекает DC ID из MTProto obfuscation init-пакета
Устанавливает WebSocket (TLS) соединение к соответствующему DC через домены kws{N}.web.telegram.org
Если WS недоступен (302 redirect) — автоматически переключается на прямое TCP-соединение

🚀 Быстрый старт

Windows

Перейдите на страницу релизов и скачайте TgWsProxy.exe. Он собирается автоматически через Github Actions из открытого исходного кода.

При первом запуске откроется окно с инструкцией по подключению Telegram Desktop. Приложение сворачивается в системный трей.

Linux (окно приложения):

Окно остаётся открытым, можно свернуть
Кнопки: «Открыть в Telegram», «Настройки», «Открыть логи»
Закрытие окна (×) — полная остановка приложения

Установка из исходников

pip install -r requirements.txt

Linux (Debian, Ubuntu)

Системные зависимости:

sudo apt install python3 python3-venv python3-tk

Вариант 1 — установка как приложение (пункт в меню, окно можно свернуть):

./packaging/install-linux.sh

После установки приложение появится в меню приложений.

Вариант 2 — запуск из исходников:

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python linux.py

Вариант 3 — сборка standalone-бинарника:

./packaging/build-linux.sh
# Результат: dist/tg-ws-proxy

Windows (Tray-приложение)

python windows.py

Консольный режим (все платформы)

python proxy/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)

Примеры:

# Стандартный запуск
python proxy/tg_ws_proxy.py

# Другой порт и дополнительные DC
python proxy/tg_ws_proxy.py --port 9050 --dc-ip 1:149.154.175.205 --dc-ip 2:149.154.167.220

# С подробным логированием
python proxy/tg_ws_proxy.py -v

Настройка Telegram Desktop

Автоматически

ПКМ по иконке в трее → «Открыть в Telegram»

Вручную

Telegram → Настройки → Продвинутые настройки → Тип подключения → Прокси
Добавить прокси:
- Тип: SOCKS5
- Сервер: 127.0.0.1
- Порт: 1080
- Логин/Пароль: оставить пустыми

Конфигурация

Платформа	Путь
Windows	`%APPDATA%/TgWsProxy/config.json`
Linux	`~/.config/TgWsProxy/config.json`

{
  "port": 1080,
  "host": "127.0.0.1",
  "dc_ip": ["2:149.154.167.220", "4:149.154.167.220"],
  "verbose": false
}

Сборка

Платформа	Спека	Команда
Windows	`packaging/windows.spec`	`pyinstaller packaging/windows.spec`
Linux	`packaging/linux.spec`	`./packaging/build-linux.sh`

GitHub Actions: .github/workflows/build.yml

Лицензия

MIT License

6.0 KiB Raw Blame History Unescape Escape

Реакция антивирусов