Перейти к основному содержимому

WEB-прокси Telegram Desktop

WEB-прокси отдаёт MTProto-прокси как обычный HTTPS-сайт на отдельном хосте. Telegram Desktop 7.1.1 и новее открывает этот сайт в скрытом окне и пропускает через него все свои соединения. Клиент не открывает MTProto-соединений, а в сети это выглядит как браузер, который загружает сайт. Секреты прокси и его транспорт действуют как обычно.

Хосту нужен публично доверенный сертификат на порту 443, поэтому WEB-прокси подходит скорее для b4 на VPS, чем для роутера за CGNAT.

Требования​

  • MTProto-прокси включён, его порт свободен, и у него есть хотя бы один секрет.
  • Публичное DNS-имя указывает на хост с b4 и больше ни для чего не используется. b4 отвечает на этом имени по всем путям, поэтому веб-интерфейс по нему недоступен.
  • Для этого имени на порту 443 отдаётся публично доверенный TLS-сертификат: самим b4 или обратным прокси перед ним. Обратный прокси сохраняет заголовок Host или выставляет X-Forwarded-Host и разрешает WebSocket-апгрейд на /api/v1/ws. Самоподписанного сертификата недостаточно.

Настройка​

  1. Откройте Настройки > Telegram. Карточка WEB-прокси Telegram Desktop видна, пока включён MTProto-прокси.
  2. Включите Включить WEB-канал.
  3. Укажите Хост релея: только имя, без схемы, порта и пути. Международное имя вводится в форме punycode (xn--).
  4. Проверьте Порт relay. При включении канала поле заполняется значением 443, на который подключается Telegram. См. Порт relay.
  5. В разделе Сертификат для хоста relay укажите Файл сертификата и Файл закрытого ключа для этого имени. Если поля пусты, используется сертификат веб-сервера.
  6. На роутере включите Доступ из интернета под полем Порт relay. Если порт релея не 443, пробросьте на него порт 443 со стороны WAN.
  7. Нажмите Сохранить.
  8. На карточке Секреты нажмите кнопку «поделиться» у секрета, скопируйте ссылку из строки WEB · Telegram Desktop 7.1.1+ и добавьте её в Telegram Desktop.

Карточка WEB-прокси

Окно «Поделиться ссылкой» с прямой и WEB-ссылкой

Ссылка имеет вид https://t.me/webproxy?server=<хост>&secret=dd<32 hex-символа>. В ней другая форма секрета, чем в списке, поэтому ссылка, собранная вручную, не работает: единственный источник - окно «Поделиться ссылкой». Своей авторизации у релея нет, и прокси может пользоваться любой, у кого есть ссылка.

Смена хоста ломает все ссылки

Ссылка привязана к хосту релея. После смены поля Хост релея все розданные ссылки перестают работать, и каждую придётся выдать заново.

Порт relay​

Telegram всегда открывает https://<хост>/ на порту 443, а порта в ссылке нет. Поэтому публичный порт 443 должен вести к релею: порт релея равен 443, на него ведёт проброс с 443 или перед ним стоит обратный прокси на 443.

Порт relayЧто получается
Указан, обычно 443У релея свой слушатель. Любое другое имя или IP-адрес на этом порту получают страницу-заглушку, и веб-интерфейс через него недоступен.
ПустоРелей работает на порту веб-интерфейса, только по хосту релея. Всё, что доставляет туда публичный порт 443, доставляет и веб-интерфейс, и его страница входа отвечает на публичном IP-адресе.

Обычная схема на роутере - собственный порт релея с включённым переключателем Доступ из интернета и проброс с порта 443 со стороны WAN, если порт релея не 443. Порт веб-интерфейса не открывается и не пробрасывается, и интерфейс остаётся доступен только из локальной сети.

Порт релея использует сертификат веб-сервера, если в разделе Сертификат для хоста relay не задан свой. Публичный сертификат на веб-сервере переводит веб-интерфейс только на HTTPS, и каждый вход по IP-адресу показывает предупреждение браузера. Сертификат из раздела Сертификат для хоста relay используется только на порту релея, а у веб-интерфейса остаётся свой.

Страница-заглушка​

Каждый посетитель, кроме Telegram, видит простую страницу «Service status», одинаковую на всех установках b4. Страница-заглушка на карточке заменяет её одним HTML-файлом размером до 1 МиБ, а Удалить возвращает встроенную. Релей отвечает этим файлом по любому пути, поэтому стили и изображения должны быть внутри него.

Файл хранится как webproxy_page.html рядом с файлом конфигурации. Файл, скопированный туда вручную, отдаётся так же, а удаление файла возвращает встроенную страницу.

Проверка результата​

Хост, открытый в браузере, показывает страницу-заглушку и тогда, когда релей не работает, поэтому ничего не доказывает. Работу релея подтверждает лог:

[tg-bridge] web carrier up from 203.0.113.9 (secret=desktop)
[tg-bridge] web proxy new stream 1 from 203.0.113.9

Такие соединения видны на странице Трафик с меткой MTProto и именем секрета.

Если не работает​

  • Открывается только страница-заглушка, а в логе нет строки web carrier up. См. На хосте WEB-прокси открывается страница-заглушка.
  • На порту 443 никто не отвечает по TLS. Сертификат или ключ не загрузился, и лог сообщает об этом. На порту веб-интерфейса b4 тогда переходит на обычный HTTP, а собственный порт релея не поднимается вовсе.
  • На телефоне нет записи WEB-прокси. Мобильные приложения Telegram её не поддерживают и используют MTProto-ссылку из того же окна.