tg-ws-proxy README

The project's README from github.com/Flowseal/tg-ws-proxy. As one markdown file: README.md.

🇷🇺 Русский • 🇬🇧 English


tgwsproxy

[!TIP]

🎉 Поддержать меня

USDT (TRC20): TXPnKs2Ww1RD8JN6nChFUVmi5r2hqrWjuu
BTC: bc1qr8vd6jelkyyry3m4mq6z5txdx4pl856fu6ss0w
ETH: 0x1417878fdc5047E670a77748B34819b9A49C72F1

[!CAUTION]

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

Антивирусы часто ошибочно помечают приложение как вирус из-за упаковщика.
Если вы не можете скачать из-за блокировки антивирусом, то:

  1. Попробуйте скачать версию для Windows 7 (по функциональности она не отличается)
  2. Отключите антивирус на время скачивания, добавьте файл в исключения и включите обратно

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

TG WS Proxy

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

Навигация

Windows: быстрый вход

Перейдите на страницу релизов и скачайте:

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

Меню трея

Настройка Telegram Desktop

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

Щелкните правой кнопкой мыши по значку в трее и выберите «Открыть в Telegram».

Если не сработало (Telegram не открылся с подключением), выполните шаги ниже:

  1. Щелкните правой кнопкой мыши по значку в трее и выберите «Скопировать ссылку»
  2. Отправьте ссылку в «Избранное» в Telegram и нажмите по ней левой кнопкой мыши
  3. Подключитесь

Ручная настройка

  1. Telegram → Настройки → Продвинутые настройки → Тип подключения → Прокси
  2. Добавьте прокси:
    • Тип: MTProto
    • Сервер: 127.0.0.1 (или переопределенный вами)
    • Порт: 1443 (или переопределенный вами)
    • Secret: из настроек или логов

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

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

[!IMPORTANT]

Не грузит фото/видео?

Удалите в настройках прокси в DC → IP всё, кроме 4:149.154.167.220
Если это не помогло, полностью очистите это поле
Подобная проблема встречается на аккаунтах без Premium
Если это не помогло, настройте собственный домен по инструкции: CfProxy.md

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

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

Минимально поддерживаемые версии ОС для текущих бинарных сборок:

Контрибьюторы

Спасибо всем, кто помогает развивать проект ❤️

Лицензия

MIT License

tg-ws-proxy (Flowseal/tg-ws-proxy)

Searching Database…

这是什么?TG WS Proxy 是一个面向 Telegram 桌面版的本地 MTProto 代理,它通过 WebSocket(TLS)连接转发流量,从而提升 Telegram 的速度,或部分绕过 Telegram 的封锁,且不依赖任何第三方服务器。
这是命令行工具,还是带图形界面的桌面应用?这是一个桌面应用,以托盘程序的形式运行,并附带图形化设置编辑器。启动后它会最小化到系统托盘,你可以直接通过托盘菜单打开 Telegram 或进行配置。
我该怎么让它运行起来?从 Releases 页面下载适用于你操作系统的预编译程序(提供 Windows 10+ x64/ARM64、Windows 7 x64/x32、Intel 版 macOS、Apple 芯片版 macOS 和 Linux x86_64 的独立构建),或者通过 Docker 运行。然后右键点击托盘图标,选择 'Open in Telegram',即可自动为 Telegram 桌面版完成配置。
我需要任何账号、API 密钥或外部服务器吗?不需要。代理无需任何第三方服务器即可工作,你只需要安装 Telegram 桌面版。在 Linux 上,系统托盘图标需要 AppIndicator 支持。
通过代理加载图片和视频总是能成功吗?不一定。如果媒体文件加载失败,请在代理设置中删除所有 DC→IP 条目(只保留 '4:149.154.167.220'),或者把该字段完全清空。这个问题在没有 Telegram Premium 的账号上更常见。
支持哪些 Windows 和 macOS 版本?提供 Windows 10+ x64/ARM64 和 Windows 7 x64/x32 构建,以及 Intel 版 macOS 10.15+、Apple 芯片版 macOS 11.0+,还有 Linux x86_64(托盘图标需要 AppIndicator)。
我的 Telegram 流量究竟去了哪里?流量的加密方式与普通 MTProto 流量相同,且不使用任何第三方服务器。连接通过 WebSocket/TLS 直接发送到 Telegram 自有的数据中心域名,并可选配基于 Cloudflare 的备用通道。
这个代理在技术上是如何绕过 Telegram 封锁的?它从 MTProto 混淆初始化包中提取 DC ID,然后与该数据中心对应的 Telegram 自有域名建立 WebSocket(TLS)连接。如果 WebSocket 连接被拦截(返回 302 重定向),它会自动切换到 CfProxy 或直接 TCP 连接。
什么是 CfProxy?CfProxy 是一个可选的基于 Cloudflare 的备用通道(附有免费 Cloudflare Worker 替代方案或使用你自己的 Cloudflare 域名的说明),在直接的 WebSocket 连接被 Telegram 封锁时使用。
为什么杀毒软件会把下载的文件标记为病毒?许多杀毒引擎会误报这种加壳的可执行文件。README 建议改用 Windows 7 版本,或暂时关闭杀毒软件并将该文件加入白名单,同时可在 VirusTotal 上进行验证。
我可以用 Telegram 的测试数据中心来测试代理吗?可以。README 中包含一份专门的指南,介绍如何使用测试 DC 配置 Telegram 测试环境,适用于开发和排查问题。
Creator
Flowseal
Size
2.4 MB
Stars
10.6K
Age
7mo
Commits · 90 Days