zastogram/ZaStoGram_desktop
Watch
5
9
Fork
You've already forked ZaStoGram_desktop
 0
Code Issues Pull requests Projects Releases 34 Packages Wiki Activity Actions
ZaStoGram Desktop — форк Telegram Desktop для сетей с DPI: FakeTLS, WSS, приватность, сохранение удалённых сообщений и стабильные обновления. https://t.me/zastogram
24,315 commits 2 branches 1,069 tags 310 MiB
  • C++ 95.8%
  • Python 1.9%
  • Objective-C++ 0.7%
  • CMake 0.6%
  • CSS 0.2%
  • Other 0.5%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
loop-uh 9e53824c75 Fix MTProto buffer/protocol bugs found in audit 
- connection_abstract: parseNotSecureResponse returned a span sized in
  bytes but make_span expects an element (mtpPrime) count, causing a 4x
  out-of-bounds read while parsing the fake req_pq reply.
- send: in the container path invokeWithLayer/initConnection was nested
  inside invokeAfterMsg; reorder so the layer wrapper stays outermost
  (matches the single-request path).
- tls_socket_handshake: guard checkHelloDigest against a too-short
  Server Hello to avoid an out-of-bounds subspan (remote crash from a
  malicious proxy).
- rsa_public_key: fix right-alignment offset in decrypt() to mirror
  encrypt() (wrong offset on short RSA results).
2026-07-09 00:54:55 +03:00
.agents [ai] Note non-Q_OBJECT findChildren pitfall for test overlays. 2026-07-02 20:40:19 +04:00
.claude Merge remote-tracking branch 'upstream/dev' into dev 2026-07-05 21:47:12 +03:00
.github fix 2026-07-08 16:36:02 +03:00
cmake@94a4dc3e26 Update submodules. 2026-07-03 07:00:51 +04:00
docs Record MTProxy split plan completion 2026-07-02 19:51:17 +03:00
lib/xdg Add faq and vcs-browser URLs to the AppStream metadata 2026-02-11 09:03:53 +04:00
snap Restore cmake 3.25 as minimum version 2026-07-01 12:34:56 +04:00
Telegram Fix MTProto buffer/protocol bugs found in audit 2026-07-09 00:54:55 +03:00
.cursorignore Add some Cursor rules / ignore paths. 2025-05-01 11:13:22 +04:00
.devcontainer.json Ensure clangd cache is out of build directory 2025-05-13 10:41:42 +04:00
.gitattributes Update lottie icons in voice chats. 2021-04-12 10:48:16 +04:00
.gitignore logs 2026-07-04 23:27:12 +03:00
.gitmodules Replace dispatch with TooManyCooks 2026-06-10 18:30:07 +04:00
AGENTS.md Clarify Debug vs Release build guidance 2026-06-28 15:39:09 +03:00
changelog.txt Beta version 6.9.4. 2026-07-03 09:56:17 +04:00
CMakeLists.txt Merge remote-tracking branch 'upstream/dev' into dev 2026-07-05 21:47:12 +03:00
LEGAL Update copyright year to 2026. (#30159) 2026-01-05 12:21:48 +04:00
LICENSE Add single LEGAL file with license and copyright. 2018-01-03 13:04:34 +03:00
README.md Refactor proxy connection and endpoint health management 2026-07-04 18:48:54 +03:00
REVIEW.md [ai] Another shot at trailing return types rules. 2026-06-09 14:27:37 +04:00

README.md

ZaStoGram Desktop

image

ZaStoGram — форк Telegram Desktop, заточенный под работу в сетях с DPI‑цензурой и под приватность. Цель проекта: чтобы клиент уверенно подключался там, где обычный Telegram режут, маскировал трафик под обычный браузерный HTTPS и не терял переписку (удалённые сообщения, истории, правки).

Это неофициальная сборка. Она основана на исходниках официального клиента и сохраняет весь его функционал, добавляя сверху сетевой стелс, WSS‑транспорт и набор приватных функций.

⚠️ Используйте на свой риск. Проект не связан с Telegram FZ‑LLC. Базовый код — под GPLv3 с OpenSSL‑исключением (см. раздел «Лицензия»).

Чем отличается от обычного Telegram Desktop

Область Что добавлено
Обход DPI FakeTLS‑стелс: профили ClientHello, правдоподобные повторные TLS‑подключения через поддельные билеты возобновления, маскировка старта, фрагментация ClientHello, варьирование размера TLS‑записей, пейсинг трафика, разнос попыток подключения
Надёжность Классифицированный loop‑backoff переподключения (cap 8 c), деприоритизация «залипших» endpoint'ов (cooldown)
Транспорт Встроенный WSS (MTProto поверх WebSocket к web‑релею Telegram)
Прокси Обязательный прокси (force‑proxy) + дефолтный локальный SOCKS5 127.0.0.1:1353
Приватность Сохранение удалённых сообщений и историй (stories), скачивание любых (даже защищённых) историй, история правок сообщений
Производительность Ограничение числа потоков софт‑декодера видео, троттлинг под нагрузкой
UX Список прокси больше не устраивает «шквал» проверок при открытии
Бренд Имя и иконка ZaStoGram

🛡️ Обход DPI — стелс MTProxy

Когда задан MTProxy (FakeTLS), клиент маскирует подключение под настоящий браузерный TLS‑хэндшейк. Всё настраивается тумблерами в окне прокси (Настройки → Продвинутые → Тип соединения → список прокси).

  • Профиль ClientHello — ClientHello воспроизводит форму реального браузера/приложения: Auto (Chrome), Auto‑rotate, Chrome Modern, Android Chrome, Firefox, Firefox Android, Yandex, Android OkHttp.
  • Маскировка старта (startup‑cover) — первые записи разбиваются и подаются так, чтобы начало сессии не выделялось характерным паттерном.
  • Фрагментация ClientHello — ClientHello дробится при отправке, чтобы DPI было сложнее собрать и распознать его целиком.
  • Варьирование размера TLS‑записей — размеры записей не фиксированы, что ломает сигнатуры по длине.
  • Пейсинг трафика — межзаписевые задержки на старте сглаживают «взрывной» профиль (без удушения уже установленного потока).
  • Разнос попыток подключения — попытки к нескольким endpoint'ам и одиночный FakeTLS ClientHello стартуют со сдвигом, а не пачкой.
  • Правдоподобные повторные TLS‑подключения — первый ClientHello к узлу и имени назначения идёт без PSK, как обычный «холодный» заход браузера. После успешного fakeTLS‑хэндшейка клиент держит небольшой локальный пул поддельных билетов возобновления с ограниченным временем жизни и при повторных подключениях отправляет один из них с нормальным возрастом. Это убирает подозрительный паттерн «каждый параллельный сокет приносит новый случайный PSK» и делает повторные подключения похожими на обычный браузерный HTTPS. Эти билеты нужны только для маскировки, не используются для шифрования MTProto и не сохраняются на диск.

Надёжность подключения

  • Loop‑backoff — классифицированные таймауты переповтора, привязанные к прокси, с верхней границей, чтобы не зацикливаться на мёртвом узле и не спамить коннектами.
  • Endpoint cooldown — endpoint, который только что отвалился, временно понижается в приоритете (а не выбрасывается), чтобы клиент пробовал живые маршруты, не теряя резервные.

🌐 WSS‑транспорт

Встроенный MTProto‑over‑WebSocket (чистая реализация на QSslSocket + RFC 6455): настоящий TLS → HTTP‑upgrade (GET /apiws) → бинарные WS‑фреймы, внутри которых идёт обфусцированный MTProto‑поток. Подключается к официальным web‑релеям Telegram (kws2/kws4.web.telegram.org) для DC2/DC4.

Включается тумблером «Route via WSS (web, DC2/DC4 only)». Полезен там, где прямой TCP к DC блокируется, но веб‑Telegram работает. Может ходить как напрямую, так и через заданный SOCKS‑прокси.

Альтернатива встроенному WSS — внешний локальный прокси (telegram_proxy из zapret‑набора) на 127.0.0.1:1353, к которому клиент подключается по SOCKS5 (см. ниже).

🔌 Прокси: обязательный + дефолтный

  • Force‑proxy — без выбранного прокси клиент не выходит в сеть; «щит» соединения виден всегда. Исключение — включённый режим WSS (он сам является методом обхода). Это страховка от случайного прямого подключения в опасной сети.
  • Дефолтный SOCKS5 127.0.0.1:1353 — добавляется в список один раз (если такого ещё нет; существующие прокси не перетираются). Это endpoint внешнего сервиса telegram_proxy: схема tdesktop → SOCKS5 1353 → telegram_proxy → WSS/FakeTLS → Telegram.

🔒 Приватность

Клиент‑сайд функции, которые сохраняют данные локально (по умолчанию включены):

  • Сохранение удалённых сообщений — когда сервер присылает «удалить», сообщение не уничтожается локально, а остаётся (помечается как удалённое отправителем). Переписка не пропадает.
  • Сохранение историй (stories) — локальный снэпшот историй с восстановлением при старте; истории не исчезают по истечении срока.
  • Скачивание любых историй — медиа истории сохраняется на диск даже для защищённых от пересылки (noforwards) и чужих историй, без Premium (снят клиентский гейт canDownload).
  • История правок — при редактировании сообщения предыдущие версии (текст + время) сохраняются, чтобы видеть, что было изменено.

Это локальные функции: они не влияют на сервер и не нарушают шифрование. Хранение части данных может быть только в памяти до перезапуска (персистентность отдельных частей — в развитии).

⚡ Производительность

  • Decoder policy — централизованное ограничение числа потоков софтверного видео‑декодера и троттлинг запуска декодеров под нагрузкой, чтобы тяжёлые медиа не «съедали» CPU и не плодили лишние декодеры.

🧰 Спокойная архитектура прокси

  • Список прокси не запускает проверку всех строк при открытии окна — это убирает «шквал» одновременных тестовых коннектов. Строки по умолчанию в состоянии Unknown; проверка запускается вручную по пункту Check Status.

🗺️ Roadmap (запланировано, ещё не реализовано)

  • Глобальный лимитер MTProxy‑handshakes — в текущем Desktop каждый аккаунт держит свой MTP::Instance со своей DC‑сессией (разные auth keys, msg_id/seqno, salt), поэтому «один общий поток» для всех аккаунтов сделать нельзя без серверной поддержки. Вместо этого планируется безопасный лимитер: общий cap на число одновременных MTProxy‑handshakes между аккаунтами + jitter/backoff + очередь; снижение числа активных проверок ротации (10 → 1–2); кэширование статусов прокси; единый gate для всех StartProxyCheck и рабочих handshakes. Это сгладит всплеск подключений, не душа уже установленный трафик.
  • UI приватности — видимая метка «удалено» на сохранённых сообщениях и просмотрщик истории правок (контекст‑меню).

🏗️ Сборка и CI

  • Сборка идёт через GitHub Actions (.github/workflows/win.yml): только Windows, конфигурации x64 и x64_x86 (Qt5). После каждого пуша автоматически публикуется пре‑релиз dev-N с готовыми .exe.
  • Зависимости (Qt, Libraries, ThirdParty) кэшируются между запусками.
  • Инструкции по ручной сборке официального клиента (применимы и здесь) — в docs/.

Базовый клиент собирается стандартным тулчейном Telegram Desktop. Артефакты пре‑релиза переименовываются в ZaStoGram-<arch>.exe.

📥 Установка

Скачайте ZaStoGram-x64.exe (или x64_x86 для 32‑бит) из раздела Releases (пре‑релиз dev-N). Это сборка из исходников этого репозитория. Для работы дефолтного прокси 127.0.0.1:1353 нужен запущенный внешний сервис telegram_proxy, либо включите встроенный WSS‑транспорт.

📄 Лицензия

Проект основан на Telegram Desktop и распространяется под GPLv3 с OpenSSL‑исключением — тот же текст лицензии, что и у апстрима, см. LICENSE и LEGAL.

ZaStoGram — независимый форк; товарные знаки Telegram принадлежат их владельцам.