TGProxy Panel помогает управлять собственными Telegram-прокси: создавать пользователей, выдавать ссылки подписки, применять лимиты и проверять состояние серверов. Панель работает на одном VPS, а telemt — на отдельном прокси-сервере. Клиентский трафик проходит через telemt, а не через панель.
Что подготовить
Этот порядок рассчитан на установку с доменами и HTTPS. Если вы впервые арендуете VPS, начните с инструкции «С нуля».
| Параметр | Сервер панели | Прокси-сервер |
|---|---|---|
| Система | Ubuntu 22.04+ или Debian 12+ | Ubuntu 22.04+ или Debian 12+, x86_64 |
| Ресурсы | От 1 CPU и 1 ГБ RAM | От 1 CPU и 1 ГБ RAM; размер зависит от нагрузки |
| Адрес | Домен с A-записью на VPS | Публичный IPv4 и отдельный домен с A-записью |
| Входящие TCP-порты | 22, 80, 443 | 22, 80, 443 и порт Fake-TLS — по умолчанию 8443 |
Порты 80 и 443 должны быть свободны до установки. Разрешите их в файрволе VPS и сетевом фильтре хостинга: установщик сам порты не открывает. Прокси-серверу нужен исходящий доступ к панели, GitHub и датацентрам Telegram. Проверьте, что DNS уже указывает на нужные серверы.
1. Установите панель
Подключитесь по SSH к серверу панели и выполните команду с правами root. Она загружает установщик из официального репозитория; перед запуском можно прочитать его код.
curl -fsSL https://raw.githubusercontent.com/greenpandorik/tgproxy-panel/main/install.sh | sudo bashУкажите домен панели, e-mail для сертификата и данные администратора. Скрипт установит Docker при необходимости, запустит панель, PostgreSQL и Caddy. После завершения откройте выданный HTTPS-адрес и войдите в панель.
2. Подключите сервер с telemt
Откройте «Серверы → Добавить сервер». Укажите имя, домен прокси и e-mail. Для новой установки выберите telemt: он обслуживает Fake-TLS, WEB-прокси и сайт-прикрытие.
Панель выдаст команду с одноразовым токеном, действительным 24 часа. Выполните именно эту команду на прокси-сервере. Токен регистрации не публикуйте и не отправляйте посторонним. Установщик проверит DNS и порты, установит движок и агента, получит сертификат и зарегистрирует сервер после проверки готовности.
Дождитесь статуса «На связи». Если регистрация не завершилась, сохраните текст ошибки и откройте руководство по устранению неполадок.
3. Создайте пользователя и проверьте подключение
В разделе «Пользователи» создайте пользователя, назначьте срок доступа и прокси-сервер. Скопируйте ссылку подписки: она открывает страницу с инструкциями для устройства, Fake-TLS и WEB-ссылками.
Доступ начинает работать после применения настроек на сервере, обычно в течение минуты. Для первого теста откройте Fake-TLS-ссылку в Telegram и подтвердите подключение. Затем проверьте WEB, если ваш клиент поддерживает его. У каждого пользователя собственный секрет: для отзыва доступа используйте управление пользователем в панели.
4. Проверьте сервер и сохраните доступ к панели
На странице сервера запустите «Проверку с панели» и «Полную проверку сервера». Посмотрите DNS, сертификат, порты, состояние telemt и соединения с Telegram. Работоспособность из сети панели не гарантирует доступность у каждого провайдера — проверьте подключение с устройства пользователя.
Включите двухфакторный вход, настройте резервные копии и Telegram-уведомления. Для обновления панели используйте sudo /opt/tgproxy-panel/install.sh --update, для обновления агента и telemt — tgwp-agent upgrade. Команда использует версии, закреплённые панелью. Если нужно обновить только агент, используйте tgwp-agent upgrade --agent. Перед обновлением просмотрите план командой tgwp-agent upgrade --check.
Если Telegram не подключается
- Проверьте, что сервер на связи и изменения пользователя уже применены.
- Сверьте адрес и порт из ссылки; отдельно проверьте порт Fake-TLS в файрволе.
- Проверьте срок доступа и лимит трафика пользователя.
- Сравните подключение через мобильную сеть и Wi-Fi, затем Fake-TLS и WEB.
- Проверьте маршрут прокси-сервера к Telegram. Запасной домен может помочь при блокировке основного имени, но не исправит остановленный движок или недоступный датацентр.
Детальные команды и проверяемые пути доступны в полной инструкции по установке. Для выбора транспорта прочитайте сравнение MTProxy, Fake-TLS и WEB.
Для автоматизации пользователей и серверов используйте API управления: персональные токены, права доступа и готовые примеры.