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

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

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

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

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

Меню трея:

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

При первом запуске после старта может появиться запрос об открытии страницы релиза, если на GitHub вышла новая версия (отключается в настройках).

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

1. Открыть образ
2. Перенести TG WS Proxy.app в папку Applications
3. При первом запуске 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 это номер порта прокси: sudo systemctl start tg-ws-proxy-cli@8888

Для остальных дистрибутивов можно использовать TgWsProxy_linux_amd64 (бинарный файл для x86_64).

chmod +x TgWsProxy_linux_amd64 ./TgWsProxy_linux_amd64

При первом запуске откроется окно с инструкцией. Приложение работает в системном трее (требуется AppIndicator).

Для запуска только SOCKS5/WebSocket proxy без tray-интерфейса достаточно базовой установки:

pip install -e . tg-ws-proxy

pip install -e . tg-ws-proxy-tray-win

pip install -e . tg-ws-proxy-tray-macos

pip install -e . tg-ws-proxy-tray-linux

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

Аргументы:

Примеры:

# Стандартный запуск 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 в секции [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»

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

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

• Windows: %APPDATA%/TgWsProxy
• macOS: ~/Library/Application Support/TgWsProxy
• Linux: ~/.config/TgWsProxy (или $XDG_CONFIG_HOME/TgWsProxy)

{ "host": "127.0.0.1", "port": 1080, "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 для системного трея)

MIT License