🚀 Telegram WSProxy WelX

🌐 Форк tg-ws-proxy, предоставляющий локальный WebSocket-транспорт для Telegram Desktop.

Telegram WSProxy WelX — локальный MTProto-прокси для Telegram Desktop, основанный на проекте tg-ws-proxy. Приложение использует WebSocket в качестве транспортного канала, работает полностью на компьютере пользователя и не требует настройки удалённых серверов.

Проект развивает идеи telegram-ws-proxy, сохраняя совместимость с Telegram Desktop и предлагая удобную локальную конфигурацию с минимальными действиями со стороны пользователя.

Tip

⚡ Ожидаемый эффект

Использование Telegram WSProxy WelX может улучшить отзывчивость Telegram Desktop за счёт оптимизации маршрута передачи MTProto-трафика. В зависимости от особенностей сети это способно сократить задержки при синхронизации диалогов, а также ускорить загрузку сообщений, мультимедиа и вложений.

---

✨ Возможности

• 🚀 Быстрый запуск без сложной настройки
• 🌐 Передача MTProto-трафика через WebSocket
• 🔒 Полностью локальная обработка соединений
• 🔄 Автоматическое восстановление подключения
• 🖥️ Работа в системном трее
• 📄 Подробные журналы работы
• ⚙️ Гибкая настройка параметров
• 💻 Поддержка Windows, Linux, macOS и Docker
• 🪶 Небольшое потребление системных ресурсов

---

🖼️ Интерфейс

---

📦 Поддерживаемые платформы

Платформа	Статус
🪟 Windows	✅
🍎 macOS	✅
🐧 Linux	✅
🐳 Docker	✅

---

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

Начать работу можно всего за несколько шагов:

1. 📥 Загрузите сборку для своей операционной системы.
2. ▶️ Запустите приложение.
3. ⏳ Дождитесь запуска локального сервиса.
4. 💬 Откройте Telegram Desktop.
5. 🔗 Выполните автоматическое или ручное подключение.

После запуска приложение продолжает работать в фоновом режиме.

---

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

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

Если операционная система поддерживает обработку ссылок Telegram, приложение может автоматически передать параметры подключения.

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

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

Все значения отображаются непосредственно в интерфейсе программы.

---

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

Telegram Desktop
        │
        ▼
Telegram WSProxy WelX
        │
        ▼
 WebSocket Tunnel
        │
        ▼
 Telegram Network

Во время работы приложение:

• 📥 принимает локальные подключения Telegram Desktop;
• 🌍 определяет маршрут передачи данных;
• 🔐 устанавливает защищённый WebSocket-канал;
• 🔄 автоматически восстанавливает соединение при разрывах;
• ⚡ продолжает работу без участия пользователя.

---

🖥️ Работа в фоне

После запуска приложение может быть свёрнуто в системный трей.

Через контекстное меню доступны:

• ▶️ запуск подключения;
• 🔄 перезапуск службы;
• ⚙️ изменение параметров;
• 📊 просмотр текущего состояния;
• 📄 открытие журнала;
• ❌ завершение работы.

---

⚙️ Настройки

В окне параметров можно изменить:

• 🌐 параметры подключения;
• 🚀 автоматический запуск;
• 🔄 параметры переподключения;
• 📜 уровень журналирования;
• 🔔 проверку новых версий;
• 🛠️ дополнительные настройки приложения.

Большинство изменений применяется сразу.

---

🛡️ Возможные предупреждения антивирусов

Некоторые антивирусные программы могут ошибочно реагировать на приложение из-за особенностей упаковки исполняемого файла.

Если это произошло:

• временно отключите проверку во время скачивания;
• добавьте приложение в список исключений;
• после установки снова включите защиту.

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

---

❓ Часто задаваемые вопросы

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

Убедитесь, что Telegram Desktop использует параметры подключения, предоставленные приложением.

---

Соединение нестабильно

Попробуйте перезапустить приложение или повторно создать подключение.

---

Медиа загружаются медленно

Очистите существующие параметры прокси в Telegram Desktop и выполните настройку повторно.

---

Где находятся журналы?

Журнал работы можно открыть через меню приложения.

---

🛠️ Сборка проекта

Для самостоятельной сборки потребуется:

• Python;
• зависимости проекта;
• инструмент упаковки приложения.

После подготовки окружения выполните сборку согласно инструкции репозитория.

---

🤝 Основа проекта

Telegram WSProxy WelX основан на проекте tg-ws-proxy и продолжает развивать его идеи, сохраняя совместимость с Telegram Desktop и WebSocket-транспортом.

Если вы хотите предложить улучшения или нашли ошибку, создайте Issue или Pull Request.

---

📄 Лицензия

Проект распространяется по лицензии MIT.

При распространении производных версий соблюдайте условия лицензии и сохраняйте необходимые уведомления об авторских правах.