Skip to content

momentics/GhostWire

Repository files navigation

GhostWire Desktop

Release Platforms License

GhostWire Logo GhostWire Desktop помогает Telegram Desktop работать через локальный защищённый прокси. Приложение запускает SOCKS5 на вашем компьютере, подключает к нему Telegram и передаёт трафик через HTTPS Tunelling с защитой от DPI на уровне L4-L7. Системный VPN, внешние прокси-сервисы и сторонние аккаунты не нужны.

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

  1. Запустите GhostWire Desktop.
  2. Нажмите Старт в меню приложения.
  3. Откройте Telegram Desktop.
  4. Нажмите Подключить Telegram.
  5. Подтвердите настройку SOCKS5 в Telegram.

Если автоматическая настройка не открылась, укажите параметры вручную:

  1. Telegram Desktop -> Настройки -> Продвинутые -> Тип соединения -> SOCKS5
  2. Сервер: 127.0.0.1
  3. Порт: 1080
  4. Сохранить

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

GhostWire работает как небольшой локальный шлюз только для тех приложений, которые подключены к нему явно.

  1. На вашем компьютере запускается локальный SOCKS5-прокси 127.0.0.1:1080.
  2. Telegram Desktop отправляет соединения в этот локальный прокси.
  3. GhostWire определяет нужный Telegram DC и выбирает подходящий маршрут.
  4. Дальше трафик уходит через HTTPS на 443 порту, то есть выглядит как обычное защищённое Web соединение.
  5. Если маршрут недоступен, библиотека может переключиться на другой endpoint для того же направления.

Почему это удобно

  • Без системного VPN - GhostWire не меняет маршруты всей операционной системы.
  • Только для Telegram Desktop - остальной трафик компьютера не начинает ходить через GhostWire сам по себе.
  • Локальная точка подключения - Telegram подключается к 127.0.0.1:1080, то есть к приложению на вашем компьютере.
  • HTTPS Tunelling - исходящие соединения используют порт 443, привычный для HTTPS-трафика.
  • Ротация endpoint-ов - при проблемах с одним маршрутом GhostWire может использовать другой доступный endpoint.
  • Отдельные media-маршруты - конфигурация учитывает media/file-трафик Telegram.
  • Одна кнопка остановки - Стоп останавливает локальный прокси и очищает текущую статистику.

Какие защиты используются

GhostWire не обещает «магического» обхода любых блокировок. Его задача - сделать трафик Telegram менее удобным для DPI-фильтрации и устойчивее к точечным проблемам маршрута.

В текущей конфигурации используются:

  • DNS Bypass
  • L4-L7 DPI protection
  • HTTPS Tunelling
  • SNI для Telegram Servers
  • Mimicry for Web traffic
  • DC-aware routing - GhostWire сопоставляет Telegram IP-диапазоны с нужными datacenter-ами
  • Endpoint rotation - для datacenter-ов указано несколько primary/fallback endpoint-ов
  • Media routing - для части направлений есть отдельные media endpoints и media hostnames
  • User Mode - приложение работает без драйверов ядра и без перехвата всего системного трафика

Что важно знать

  • GhostWire Desktop не является VPN для всей системы.
  • Он помогает Telegram Desktop только после подключения Telegram к локальному SOCKS5-прокси.
  • Для кнопки Подключить Telegram Telegram Desktop должен быть установлен и запущен.
  • Проверка обновлений, но обновления не устанавливаются автоматически.

Как это выглядит

При запуске в трее появляется иконка GhostWire. Левый или правый клик открывает компактное меню со статусом, графиком трафика и кнопками управления.


Скриншоты

Иконка в трее

TaskBar icon

Контекстное меню

Windows

Context menu

Linux

Context menu

macOS

Context menu

Подключение Telegram

Telegram Proxy Setup


Что означают кнопки

Кнопка Что происходит
Старт Запускает локальный SOCKS5-прокси 127.0.0.1:1080
Стоп Останавливает прокси и очищает текущую статистику
Подключить Telegram Открывает в Telegram готовую настройку SOCKS5
Проверить обновления Проверяет новую версию на GitHub
Выход Завершает приложение

Что показывает меню

Поле Значение
Работает Время работы прокси после последнего запуска
Соединений Активные внешние соединения и пиковое значение в скобках
Ротаций Успешные переключения endpoint-ов и общее число попыток в скобках
Пик Максимальная скорость приёма и передачи за текущий запуск
Всего Общий объём принятого и отправленного трафика

Иконка в трее также показывает состояние:

  • IDLE TaskBar icon - прокси остановлен.
  • DEGRADED TaskBar icon - прокси запущен.
  • ACTIVE TaskBar icon - есть активные соединения.
  • DEGRADED TaskBar icon - прокси работает, но один из маршрутов или ресурсов недоступен.

Поведение при запуске

  • Первый запуск - GhostWire находится в состоянии Стоп.
  • Последующие запуски - приложение восстанавливает предыдущее состояние. Если при завершении работы прокси был запущен, он автоматически запустится снова. Если был остановлен, то останется остановленным.

Проверка обновлений

GhostWire Desktop проверяет, вышла ли новая версия, при запуске и затем периодически во время работы. Если обновление найдено, приложение сообщает об этом и предлагает открыть страницу релиза на GitHub.

Обновление не устанавливается автоматически: пользователь сам скачивает и устанавливает подходящий пакет для своей системы. Проверку можно запустить вручную через пункт Проверить обновления в меню приложения.


Поддержать автора

"Голодающим поволжья" 🙏 OZON Bank: 2204 2402 8673 4225