tproxy-web/README.md

tproxy-web

Развёртывание WEB Proxy для Telegram Desktop на собственном сервере (telegramdesktop/tproxy-server) + заметки по установке и проблемам.

Схема:

Telegram Desktop → HTTPS 443 → Caddy → tproxy-server (127.0.0.1:8080) → MTProxy (0.0.0.0:2398) → Telegram
                                        └ admin 127.0.0.1:8081 (/readyz, /healthz)

Состав

• INSTALL_NOTES.md — полный опыт установки на Debian 13 (VPS03, Hostkey): шаги, проблемы и решения (права MTProxy, флейк go test, сетевая проверка).
• deploy/mask-site/index.html — сайт-маскировка (нейтральная личная страница, отдаётся по HTTPS вместо прокси-ответов на обычные запросы).
• deploy/install-command.sh — команда установки (install.sh от upstream).

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

# 1. Клонировать upstream и этот репозиторий
git clone https://github.com/telegramdesktop/tproxy-server.git /tmp/tproxy-server
# 2. Подготовить secret и сайт-маскировку
openssl rand -hex 16 > /tmp/tproxy-secret.txt   # 32 hex
cp -r deploy/mask-site /tmp/tproxy-site
# 3. Загрузить на сервер и запустить установку
cd /tmp/tproxy-server
./deploy/install.sh --hostname YOUR.HOSTNAME --email you@example.com \
  --site-dir /tmp/tproxy-site --secret "$(cat /tmp/tproxy-secret.txt)"
# 4. ПОСЛЕ установки — починить права MTProxy (см. INSTALL_NOTES.md, п.1):
chmod 755 /opt/MTProxy /opt/MTProxy/objs /opt/MTProxy/objs/bin
chown root:mtproxy /opt/MTProxy/objs/bin/mtproto-proxy
chmod 750 /opt/MTProxy/objs/bin/mtproto-proxy
systemctl restart mtproxy
# 5. Проверить
curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:8081/readyz   # 200

Клиент (Telegram Desktop)

Settings → Advanced → Connection Type → Use custom proxy → NEW PROXY → WEB Proxy:

• hostname: ваш домен
• secret: (из /tmp/tproxy-secret.txt)

Ссылки

• Upstream: https://github.com/telegramdesktop/tproxy-server
• Статья в блоге: https://dedinit.ru/ (2026-08-31, установка tproxy-server)