6.2 KiB

Raw Blame History

[!CAUTION]

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

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

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

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

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

TG WS Proxy

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

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

Telegram Desktop → SOCKS5 (127.0.0.1:1080) → TG WS Proxy → WSS → Telegram DC

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

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

Windows

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

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

Меню трея:

Открыть в Telegram — автоматически настроить прокси через tg://socks ссылку
Перезапустить прокси — перезапуск без выхода из приложения
Настройки... — GUI-редактор конфигурации
Открыть логи — открыть файл логов
Выход — остановить прокси и закрыть приложение

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

<<<<<<< build/pyproject-migration

pip install -e ".[win10]"

Windows 7

pip install -e ".[win7]"

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

tg-ws-proxy-tray

======= Перейдите на страницу релизов и скачайте TgWsProxy.dmg — универсальная сборка для Apple Silicon и Intel.

Открыть образ
Перенести TG WS Proxy.app в папку Applications
При первом запуске macOS может попросить подтвердить открытие: Системные настройки → Конфиденциальность и безопасность → Всё равно открыть

main

Консольный режим из исходников

tg-ws-proxy [--port PORT] [--host HOST] [--dc-ip DC:IP ...] [-v]

Аргументы:

Аргумент	По умолчанию	Описание
`--port`	`1080`	Порт SOCKS5-прокси
`--host`	`127.0.0.1`	Хост SOCKS5-прокси
`--dc-ip`	`2:149.154.167.220`, `4:149.154.167.220`	Целевой IP для DC (можно указать несколько раз)
`-v`, `--verbose`	выкл.	Подробное логирование (DEBUG)

Примеры:

# Стандартный запуск
tg-ws-proxy

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

# С подробным логированием
tg-ws-proxy -v

CLI-скрипты (pyproject.toml)

CLI команды объявляются в pyproject.toml в секции [project.scripts] и должны указывать на module:function.

Пример:

[project.scripts]
tg-ws-proxy = "proxy.tg_ws_proxy:main"
tg-ws-proxy-tray = "windows:main"

Настройка Telegram Desktop

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

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

Вручную

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

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

Tray-приложение хранит данные в %APPDATA%/TgWsProxy:

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

Автоматическая сборка

Проект содержит спецификации PyInstaller (packaging/windows.spec, packaging/macos.spec) и GitHub Actions workflow (.github/workflows/build.yml) для автоматической сборки.

Лицензия

MIT License

6.2 KiB Raw Blame History Unescape Escape

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