Вопросы и ответы

FAQ tg-ws-proxy

Быстрые ответы на частые вопросы из GitHub Issues и Discussions репозитория Flowseal/tg-ws-proxy.

1. Прокси работает только через DC2/DC4. Медиа из других DC не ускоряется.
2. Пинг 300 мс - визуально, на скорость загрузки не влияет.
3. Пинг 20 000 мс - проблема с CF Proxy. Попробуйте отключить CF или заведите свой домен.
4. Windows Defender ругается - ложное срабатывание на PyInstaller. Добавьте в исключения.
5. Голосовые звонки и войс-чаты не работают - архитектурное ограничение MTProto-proxy.
6. Обновляйтесь до последней версии перед тем, как писать о баге.

Windows

Скачать с релизов:

• TgWsProxy_windows.exe - Windows 10/11
• TgWsProxy_windows_7_64bit.exe - Windows 7 x64
• TgWsProxy_windows_7_32bit.exe - Windows 7 x32

Важно: если основной exe не запускается - используйте win7-сборку. Она не использует хранилище сертификатов Windows и обходит ряд проблем (#757, #473).

Linux

git clone https://github.com/Flowseal/tg-ws-proxy.git
cd tg-ws-proxy
python3 -m venv venv
source venv/bin/activate
pip install -e .

Готовые пакеты:

• .deb - sudo apt install ./TgWsProxy_linux_amd64.deb
• .rpm - sudo rpm -i ./TgWsProxy_linux_amd64.rpm
• AUR - yay -S tg-ws-proxy-bin (или -git, -cli)

macOS

• Готовая сборка: TgWsProxy_macos_universal.dmg
• Из исходников: pip install -e . && tg-ws-proxy-tray-macos

Docker

docker build -t tg-ws-proxy .
docker run -d -e TG_WS_PROXY_SECRET=your_secret -p 1443:1443 tg-ws-proxy

Автоматически: ПКМ по иконке трея -> "Открыть в Telegram"

Вручную:

1. Настройки -> Продвинутые -> Тип подключения -> Прокси
2. Добавить:
   • Тип: MTProto
   • Сервер: 127.0.0.1
   • Порт: 1443 (или тот, что в конфиге)
   • Логин/пароль: пустые

Для сети (другой ПК/телефон):

• Сервер: IP компьютера с прокси
• Прокси должен быть запущен с --host 0.0.0.0

tg:// ссылка не открывается - установите Telegram Desktop и назначьте его приложением для протокола tg:// (#541).

FakeTLS

• В GUI-версии FakeTLS нет и не планируется в ближайшее время.
• Через CLI можно настроить FakeTLS в связке с nginx (см. гайд в репозитории) (#721, #659).

Secret: dd, ee, SNI

• Прокси использует dd-secret (random padding) по умолчанию.
• ee-secret и SNI не поддерживаются (#644).

Прокси совсем не работает / "Соединение..."

Проверьте по порядку:

1. Telegram использует MTProto, а не SOCKS5.
2. Выключите сторонний VPN/прокси.
3. Убедитесь, что IPv6 отключён в Telegram (Настройки -> Продвинутые -> IPv6).
4. Проверьте, не занят ли порт другой программой.
5. Перезапустите прокси.
6. Обновитесь до последней версии.

WinError 10013 - порт занят (#455)

[winerror 10013] сделана попытка доступа к сокету методом, запрещенным правами доступа

Решение: net stop hns && net start hns в cmd от администратора, или перезагрузка.

INVALID_CERTIFICATE / ssl.SSLError на Windows 11 (#757) Используйте TgWsProxy_windows_7_64bit.exe вместо основной сборки.

"Приложение уже запущено" - старая версия висит в процессах. Откройте Диспетчер задач, завершите все TgWsProxy, затем запустите заново (#820, #630).

Failed to load Python DLL / не найден указанный модуль

• Остатки от старой версии мешают новой. Удалите старый exe, перезагрузитесь и запустите новую версию заново (#675, #645).

Прокси глючит после долгой работы / медиа перестало грузить

• Крайняя мера: удалите папку с конфигом и перезапустите прокси. Она будет создана заново с дефолтными настройками.
  • Windows: %APPDATA%\Roaming\TgWsProxy\
  • Linux: ~/.config/TgWsProxy/
  • macOS: ~/Library/Application Support/TgWsProxy/
• Иногда это решает проблему с "застывшим" кэшем DC (#458).

На Windows 11 программа не открывается / ничего не происходит

• Попробуйте запустить через cmd: .\TgWsProxy_windows.exe
• Если через cmd работает, а двойным кликом нет - проверьте исключения антивируса и Защитника Windows.
• Попробуйте win7-сборку (#473).

Медиа не загружается (фото, видео, файлы)

Это самый частый вопрос.

Ответ от Flowseal:

"Для некоторых чатов/каналов трафик идёт не через DC2/DC4 (а только они могут проксироваться). Для них прокси не поможет."

Как проверить:

• Загрузите файл в Избранные сообщения - если скорость не нулевая, прокси работает.

Что влияет на выбор DC:

• Country code телефона вашего аккаунта
• Country code телефона собеседника / канала

Если медиа не грузит:

1. Обновитесь до последней версии.
2. Добавьте DC203: --dc-ip 2:149.154.167.220 --dc-ip 4:149.154.167.220 --dc-ip 203:149.154.167.220
3. Включите CF Proxy в настройках.
4. Если CF Proxy включён и не помогает - дефолтные домены могут быть перегружены. Заведите свой домен через Cloudflare Worker (#846, #855, #735, #548, #497).
5. Выключите сторонний VPN - он мешает загрузке медиа (#579).

⚠️ Не добавляйте IP в маппинг, если не знаете что он делает: https://github.com/Flowseal/tg-ws-proxy/discussions/453#discussioncomment-16353314

⚠️ Если ничего не помогает - решения может не быть. Остаётся только терпеть.

Не отправляются сообщения

Симптом: каналы грузятся, медиа работает, но сообщения висят и не отправляются.

Причина: Telegram пытается отправить через DC, который не проксируется, или CF Proxy блокирует исходящий трафик.

Решение:

1. Обновитесь до последней версии.
2. Попробуйте отключить CF Proxy или сменить его приоритет.
3. Убедитесь, что DC2 и DC4 прописаны в конфиге.
4. Выключите сторонний VPN (#853).

Пинг / Скорость

Загрузка быстрая, отправка медленно - аплоад идёт на один DC, подтверждение - через другой. Это ограничение архитектуры Telegram.

Пинг в Discord/играх вырос - прокси не трогает их трафик. Совпадение или остатки от другого ПО (#794).

Голосовые звонки / Войс-чаты

MTProto-proxy архитектурно не поддерживает голосовые звонки и войс-чаты.

• Голосовые сообщения работают (через медиа-DC).
• Звонки работают только через VPN.
• Переключателя на SOCKS5 в приложении нет (#836, #833, #800, #470).

Реакции / Смайлы / Стикеры не грузятся

Реакции и стикеры грузятся через отдельные CDN, которые прокси не ускоряет. Частично помогает CF Proxy, но гарантии нет (#841, #589, #580).

Cloudflare Proxy (CF)

"Ни один сервер не отвечает" / CF Proxy failed / HTTP 429

• Дефолтные CF-домены могут быть перегружены.
• Решение 1 (быстрое): включите CF Proxy в настройках прокси и попробуйте разные приоритеты (Auto / CF first / Telegram first).
• Решение 2 (надёжное): заведите собственный Cloudflare Worker - это бесплатно и не требует покупки домена. Подробный гайд: docs/CfWorker.md.
• Решение 3 (свой домен): если уже есть домен, настройте его через Cloudflare по гайду docs/CfProxy.md.
• Укажите свой Worker/домен в настройках прокси в поле Cloudflare Worker Domain (или --cfproxy-worker-domain) (#846, #855, #735).

CF Proxy включён, но медиа не грузит

• Попробуйте сменить приоритет CF (CF first / Telegram first / Auto).
• Проверьте, что VPN выключен - он конфликтует с CF (#579).

Windows

Windows Defender удаляет / блокирует файл

• Ложное срабатывание на PyInstaller. Сигнатура: Program:Win32/Contebrew.A!ml или Trojan:Win32/Wacatac.
• Решение: добавьте в исключения Защитника Windows или используйте win7-сборку.
• Проверьте хеш на VirusTotal - должно быть не более 2-3 детектов (#782, #699, #685, #673, #667, #596, #603).

Не запускается на Windows 7

• Используйте именно TgWsProxy_windows_7_64bit.exe или TgWsProxy_windows_7_32bit.exe. Основной exe НЕ работает на Win7 (#756).

Окно настроек не открывается / ошибка

• Обновитесь до последней версии.
• Если пишет "customtkinter не установлен" - запускайте из исходников в виртуальном окружении (#599, #792).

Окно позиционируется между двумя мониторами

• Перетащите окно на нужный монитор и перезапустите (#758).

Linux

GLIBC_2.38 not found

• Готовые бинарники собраны на свежих дистрибутивах. На CentOS 7, Ред ОС 7.3 и др. запускайте из исходников через Python (#812).

Иконка не отображается / скролл не работает (KDE/Wayland)

• Известные проблемы CustomTkinter/PyInstaller на Linux. Используйте Python-версию напрямую или установите python-pillow-tk из репозитория (#857, #728).

AUR пакет устарел / не запускается

• Обновите до свежей версии. Старые версии (1.5.1) плохо грузят медиа (#723, #709).

Автозапуск

• Tray: галочка в настройках создаёт .desktop файл в ~/.config/autostart/
• CLI: systemd unit (см. раздел VPS)

macOS

Не работает / пустые логи

• Проверьте, что прокси запущен и Telegram настроен на 127.0.0.1:1443.
• Убедитесь, что нет другого процесса на том же порту (#714).

Android / iOS

Есть ли мобильная версия?

• Android: tg-ws-proxy-android от amurcanov
• Termux: curl -fsSL https://gist.githubusercontent.com/mtkpapa/3ad8841d7f93b5f33ae26ef4111e6c62/raw/tg-ws-proxy-install.sh | bash -
• iOS: нативного приложения нет. Подключайтесь к прокси на ПК/роутере по локальной сети (#528, #706).

Можно ли запустить на TV-приставке (Amlogic S912, Armbian)?

• Да. Если на приставке стоит Armbian или другой Linux на ARM - собирайте из исходников через Python. Готовые бинарники x86 не подойдут (#521).

Подключён к WiFi, но прокси отваливается

• Проверьте, что IP ПК не изменился.
• Попробуйте статический IP для ПК с прокси (#477).

Роутер / OpenWRT

sh <(wget -O - https://raw.githubusercontent.com/StressOzz/tg-ws-proxy-Manager/main/tg-ws-proxy-Manager.sh)

• Требуется ~50 MB свободного места.
• ARM, MIPS архитектуры поддерживаются.

OpenWRT: не грузится медиа

• Удаление DC IP через init-скрипт может не сработать. Проверьте формат конфига (#733).

VPS / Сервер

timeout during handshake

• Проверьте firewall (ufw/iptables/cloud firewall) - порт должен быть открыт.
• Убедитесь, что Secret в Telegram совпадает с Secret на сервере.
• Локально работает, а на VPS нет - проблема в сети/блокировках хостинга (#752).

Автозапуск через systemd:

[Unit]
Description=tg-ws-proxy
After=network.target

[Service]
User=root
WorkingDirectory=/opt/tg-ws-proxy
ExecStart=/opt/tg-ws-proxy/venv/bin/python proxy/tg_ws_proxy.py --host 0.0.0.0
Restart=always
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

Too many open files

ulimit -n 65535

Или в /etc/security/limits.conf:

* soft nofile 65535
* hard nofile 65535

Мультиаккаунт / Несколько аккаунтов

Прокси работает на одном аккаунте, но не на другом

• Трафик каждого аккаунта идёт на "свой" DC в зависимости от номера телефона.
• Для +7 обычно DC2/DC4 - всё работает.
• Для других стран DC может отличаться - прокси их не ускоряет (#482, #536, #547, #582, #560).

Медиа грузится только на аккаунте с Premium

• Это связано с DC, а не с Premium. Аккаунты с разными номерами попадают на разные DC (#547).

Сторонние клиенты (AyuGram, Unigram и др.)

• AyuGram - работает, но иногда нестабильно. Прокси разработан для официального клиента (#463, #550).
• Unigram - не работает. Используйте официальный Telegram Desktop (#725).
• Если при запуске пытается открыть официальный Telegram - добавьте прокси вручную в настройках клиента (#496).

Мобильные операторы

Работает через WiFi, но не через мобильный интернет

• МТС, Мегафон, Билайн и др. часто блокируют MTProto жёстче, чем домашние провайдеры.
• Решения может не быть. Пробуйте через роутер/VPS (#845, #466).

Zapret / VPN конфликты

• Zapret обычно не мешает, но если используете CF Proxy - убедитесь, что ваш CF-домен/диапазоны не режутся в zapret.
• VPN может перехватывать трафик и ломать загрузку медиа. Выключите VPN для проверки (#579, #846).
• WireGuard не мешает работе прокси, но одновременно с VPN медиа может не грузить.

Обновление

Скачал новую версию, а внутри написана старая

• Перекачайте файл. Была ошибка в релизе (#722, #720).

Не приходит уведомление об обновлении

• Проверьте связь с GitHub в настройках. Иногда API недоступен - перезапустите прокси.
• Можно проверить вручную через "Проверить обновления" в трее (#707).

Как обновить на Ubuntu (из исходников)

cd tg-ws-proxy
git pull
source venv/bin/activate
pip install -e .

(#608)

Вредоносные форки

• Скачивайте только из официального репозитория: https://github.com/Flowseal/tg-ws-proxy
• В сети появляются фейки (например, Flowsonl/tg-proxy-ws). Проверяйте автора.
• Готовые сборки из сторонних каналов могут содержать вирусы (#577, #788).

Антивирус ругается

• Ложное срабатывание на PyInstaller. Проверьте файл на VirusTotal.
• Если 20+ антивирусов детектит - файл подозрительный. Если 1-3 - ложное срабатывание.
• Не отключайте антивирус полностью. Добавьте конкретный файл в исключения (#694, #596, #603).

Где находятся файлы

Как отключить логи

Полностью отключить нельзя, но можно ограничить размер в настройках: Log max MB (по умолчанию 5).

Паттерны в логах

Secret

• Узнать Secret можно в логе при запуске: Secret: abc123...
• Или скопировать из ссылки tg://proxy?server=...&secret=dd**abc123...** - убрав dd в начале.
• Сгенерировать: openssl rand -hex 16 (#551, #558).

1. Только DC2 и DC4 - остальные DC проксируются через TCP (медленно) или не проксируются вовсе.
2. IPv6 - не поддерживается.
3. Голосовые звонки / Войс-чаты - не работают через MTProto-proxy.
4. Мобильные сети - операторы блокируют жёстче, может не работать.
5. CF Proxy (дефолтные домены) - могут быть перегружены (HTTP 429). Решение: свой CF Worker.
6. Реакции / стикеры - грузятся через CDN, прокси их не ускоряет.

v.1.7.2

English Translation

FAQ tg-ws-proxy

Quick answers to frequent questions from the Issues and Discussions of the Flowseal/tg-ws-proxy repository.

1. The proxy works only through DC2/DC4. Media from other DCs is not accelerated.
2. A 300 ms ping is visual only and does not affect download speed.
3. A 20,000 ms ping means a CF Proxy problem. Try disabling CF or use your own domain.
4. Windows Defender warnings are false positives caused by PyInstaller. Add the file to exclusions.
5. Voice calls and voice chats do not work because of an MTProto-proxy architecture limitation.
6. Update to the latest version before reporting a bug.

Windows

Download from releases:

• TgWsProxy_windows.exe - Windows 10/11
• TgWsProxy_windows_7_64bit.exe - Windows 7 x64
• TgWsProxy_windows_7_32bit.exe - Windows 7 x32

Important: if the main exe does not start, use the Win7 build. It does not use the Windows certificate store and bypasses several issues (#757, #473).

Linux

git clone https://github.com/Flowseal/tg-ws-proxy.git
cd tg-ws-proxy
python3 -m venv venv
source venv/bin/activate
pip install -e .

Ready-made packages:

• .deb - sudo apt install ./TgWsProxy_linux_amd64.deb
• .rpm - sudo rpm -i ./TgWsProxy_linux_amd64.rpm
• AUR - yay -S tg-ws-proxy-bin (or -git, -cli)

macOS

• Ready-made build: TgWsProxy_macos_universal.dmg
• From source: pip install -e . && tg-ws-proxy-tray-macos

Docker

docker build -t tg-ws-proxy .
docker run -d -e TG_WS_PROXY_SECRET=your_secret -p 1443:1443 tg-ws-proxy

Automatically: right-click the tray icon -> "Open in Telegram"

Manually:

1. Settings -> Advanced -> Connection type -> Proxy
2. Add:
   • Type: MTProto
   • Server: 127.0.0.1
   • Port: 1443 (or the one in your config)
   • Login/password: empty

For a network setup (another PC/phone):

• Server: IP address of the computer running the proxy
• The proxy must be started with --host 0.0.0.0

The tg:// link does not open - install Telegram Desktop and assign it as the app for the tg:// protocol (#541).

FakeTLS

• FakeTLS is not available in the GUI version and is not planned for the near future.
• In the CLI version, FakeTLS can be configured together with nginx (see the guide in the repository) (#721, #659).

Secret: dd, ee, SNI

• The proxy uses a dd secret (random padding) by default.
• ee secret and SNI are not supported (#644).

The proxy does not work at all / "Connecting..."

Check in order:

1. Telegram uses MTProto, not SOCKS5.
2. Disable third-party VPNs/proxies.
3. Make sure IPv6 is disabled in Telegram (Settings -> Advanced -> IPv6).
4. Check that the port is not occupied by another program.
5. Restart the proxy.
6. Update to the latest version.

WinError 10013 - port is occupied (#455)

[winerror 10013] an attempt was made to access a socket in a way forbidden by its access permissions

Solution: run net stop hns && net start hns i