Caution
Windows Defender часто ошибочно помечает приложение как Wacatac.
Если вы не можете скачать из-за блокировки, то:
- Попробуйте скачать версию win7 (она ничем не отличается в плане функционала)
- Отключите антивирус на время скачивания, добавьте файл в исключения и включите обратно
Всегда проверяйте, что скачиваете из интернета, тем более из непроверенных источников. Всегда лучше смотреть на детекты широко известных антивирусов на VirusTotal
Локальный MTProto-прокси для Telegram Desktop, который ускоряет работу Telegram, перенаправляя трафик через WebSocket-соединения. Данные передаются в том же зашифрованном виде, а для работы не нужны сторонние сервера.
Telegram Desktop → MTProto Proxy (127.0.0.1:1443) → WebSocket → Telegram DC
- Приложение поднимает MTProto прокси на
127.0.0.1:1443 - Перехватывает подключения к IP-адресам Telegram
- Извлекает DC ID из MTProto obfuscation init-пакета
- Устанавливает WebSocket (TLS) соединение к соответствующему DC через домены Telegram
- Если WS недоступен (302 redirect) — автоматически переключается на прямое TCP-соединение
Перейдите на страницу релизов и скачайте TgWsProxy_windows.exe. Он собирается автоматически через Github Actions из открытого исходного кода.
При первом запуске откроется окно с инструкцией по подключению Telegram Desktop. Приложение сворачивается в системный трей.
Меню трея:
- Открыть в Telegram — автоматически настроить прокси через
tg://proxyссылку - Перезапустить прокси — перезапуск без выхода из приложения
- Настройки... — GUI-редактор конфигурации (в т.ч. версия приложения, опциональная проверка обновлений с GitHub)
- Открыть логи — открыть файл логов
- Выход — остановить прокси и закрыть приложение
При первом запуске после старта может появиться запрос об открытии страницы релиза, если на GitHub вышла новая версия (отключается в настройках).
Перейдите на страницу релизов и скачайте TgWsProxy_macos_universal.dmg — универсальная сборка для Apple Silicon и Intel.
- Открыть образ
- Перенести TG WS Proxy.app в папку Applications
- При первом запуске macOS может попросить подтвердить открытие: Системные настройки → Конфиденциальность и безопасность → Всё равно открыть
Для Debian/Ubuntu скачайте со страницы релизов пакет TgWsProxy_linux_amd64.deb.
Для Arch и Arch-Based дистрибутивов подготовлены пакеты в AUR: tg-ws-proxy-bin, tg-ws-proxy-git, tg-ws-proxy-cli
# Установка без AUR-helper
git clone https://aur.archlinux.org/tg-ws-proxy-bin.git
cd tg-ws-proxy-bin
makepkg -si
# При помощи AUR-helper
paru -S tg-ws-proxy-bin
# Если вы установили -cli пакет, то запуск осуществляется через systemctl, где 8888 это номер порта,
# разделитель ":" и secret, который можно сгенерировать командой: openssl rand -hex 16
sudo systemctl start tg-ws-proxy-cli@8888:3075abe65830f0325116bb0416cadf9fДля остальных дистрибутивов можно использовать TgWsProxy_linux_amd64 (бинарный файл для x86_64).
chmod +x TgWsProxy_linux_amd64
./TgWsProxy_linux_amd64При первом запуске откроется окно с инструкцией. Приложение работает в системном трее (требуется AppIndicator).
Для запуска только proxy без tray-интерфейса достаточно базовой установки:
pip install -e .
tg-ws-proxypip install -e .
tg-ws-proxy-tray-winpip install -e .
tg-ws-proxy-tray-macospip install -e .
tg-ws-proxy-tray-linuxtg-ws-proxy [--port PORT] [--host HOST] [--dc-ip DC:IP ...] [-v]Аргументы:
| Аргумент | По умолчанию | Описание |
|---|---|---|
--port |
1443 |
Порт прокси |
--host |
127.0.0.1 |
Хост прокси |
--secret |
random |
32 hex chars secret для авторизации клиентов |
--dc-ip |
2:149.154.167.220, 4:149.154.167.220 |
Целевой IP для DC (можно указать несколько раз) |
--buf-kb |
256 |
Размер буфера в КБ |
--pool-size |
4 |
Количество заготовленных соединений на каждый DC |
--log-file |
выкл. | Путь до файла, в который сохранять логи |
--log-max-mb |
5 |
Максимальный размер файла логов в МБ (после идёт перезапись) |
--log-backups |
0 |
Количество сохранений логов после перезаписи |
-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 -vCLI команды объявляются в pyproject.toml в секции [project.scripts] и должны указывать на module:function.
Пример:
[project.scripts]
tg-ws-proxy = "proxy.tg_ws_proxy:main"
tg-ws-proxy-tray-win = "windows:main"
tg-ws-proxy-tray-macos = "macos:main"
tg-ws-proxy-tray-linux = "linux:main"ПКМ по иконке в трее → «Открыть в Telegram»
- Telegram → Настройки → Продвинутые настройки → Тип подключения → Прокси
- Добавить прокси:
- Тип: MTProto
- Сервер:
127.0.0.1(или переопределенный вами) - Порт:
1443(или переопределенный вами) - Secret: из настроек или логов
Tray-приложение хранит данные в:
- Windows:
%APPDATA%/TgWsProxy - macOS:
~/Library/Application Support/TgWsProxy - Linux:
~/.config/TgWsProxy(или$XDG_CONFIG_HOME/TgWsProxy)
{
"host": "127.0.0.1",
"port": 1443,
"secret": "...",
"dc_ip": [
"2:149.154.167.220",
"4:149.154.167.220"
],
"verbose": false,
"buf_kb": 256,
"pool_size": 4,
"log_max_mb": 5.0,
"check_updates": true
}Ключ check_updates — при true при запросе к GitHub сравнивается версия с последним релизом (только уведомление и ссылка на страницу загрузки). На Windows в конфиге может быть autostart (автозапуск при входе в систему).
Проект содержит спецификации PyInstaller (packaging/windows.spec, packaging/macos.spec, packaging/linux.spec) и GitHub Actions workflow (.github/workflows/build.yml) для автоматической сборки.
Минимально поддерживаемые версии ОС для текущих бинарных сборок:
- Windows 10+ для
TgWsProxy_windows.exe - Windows 7 (x64) для
TgWsProxy_windows_7_64bit.exe - Windows 7 (x32) для
TgWsProxy_windows_7_32bit.exe - Intel macOS 10.15+
- Apple Silicon macOS 11.0+
- Linux x86_64 (требуется AppIndicator для системного трея)