# 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).

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

```bash
# 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)