⚡ Tg-wsproxy-flux

🌐 Форк tg-ws-proxy с упором на стабильность, простую настройку и локальную работу через WebSocket.

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

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

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

В зависимости от маршрутизации сети использование Tg-wsproxy-flux может повысить отзывчивость Telegram Desktop, сократить задержки при синхронизации диалогов, а также ускорить загрузку медиафайлов и передачу вложений.

---

✨ Основные возможности

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

---

🖼️ Интерфейс

---

🚀 Начало работы

Использование приложения занимает всего несколько шагов:

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

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

---

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

Платформа	Поддержка
🪟 Windows	✅
🍎 macOS	✅
🐧 Linux	✅
🐳 Docker	✅

---

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

⚡ Автоматическое подключение

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

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

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

Все необходимые данные доступны непосредственно в интерфейсе программы.

---

🌐 Принцип работы

Telegram Desktop
        │
        ▼
 Tg-wsproxy-flux
        │
        ▼
 WebSocket Tunnel
        │
        ▼
 Telegram Network

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

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

---

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

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

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

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

---

⚙️ Настройки

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

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

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

---

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

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

Если возникла подобная ситуация:

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

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

---

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

Не удаётся установить соединение

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

---

Соединение периодически разрывается

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

---

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

Очистите сохранённые параметры подключения Telegram Desktop и настройте соединение повторно.

---

Где посмотреть журнал работы?

Журнал доступен через меню приложения.

---

🛠️ Сборка

Проект можно собрать самостоятельно.

Для этого потребуется:

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

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

---

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

Tg-wsproxy-flux основан на проекте tg-ws-proxy и развивает его идеи, сохраняя совместимость с Telegram Desktop и WebSocket-транспортом.

Если вы нашли ошибку или хотите предложить улучшение — Issues и Pull Request приветствуются.

---

📄 Лицензия

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

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