TGProxy Panel
English · Русский · Website
TGProxy Panel lets you run your own Telegram proxies and manage them from a browser. You install
the panel on one server, and it sets up the proxies on the others: it gives people ready-made
links and QR codes, hides every proxy behind an ordinary-looking website and keeps an eye on all
of it.
The panel is free and open source. It installs with one command, and the interface is in English
and Russian.
What it does
- Gives access with one link. Every user has a subscription link: the person opens it, picks
their device and connects the proxy step by step. The proxy links themselves come in two
kinds. Fake-TLS works in every Telegram app. The WEB proxy runs over plain HTTPS and is harder
to block, but for now only Telegram Desktop and recent Android versions understand it. Each
link has a QR code. Subscription pages can open on a domain of their own, even from a separate
server, so people never see the panel's domain.
- Disguises the proxy as a website. The domain of every proxy server opens an ordinary site, such
as a coffee shop or a blog. Fifteen ready-made sites are included, and each server gets its own
slightly rearranged copy, so servers can't be matched by identical pages.
- Limits access. Every user can have an expiry date, and on telemt servers also a traffic quota,
a speed limit and a cap on unique IP addresses. Access can be turned off for a while, and an
expired date can be extended, with the link staying the same.
- Keeps people connected. New users and access changes are applied without restarting the proxy,
so connected people don't notice.
- Watches the servers. The overview tells you straight away what is broken and where. The panel
checks DNS, ports and certificates, sends alerts to Telegram and exports metrics for Prometheus
and Grafana.
- Upgrades with one command. If a new proxy version fails to start, the server goes back to the
previous one on its own.
- Protects access. Two-factor sign-in, an activity log of every admin action and scheduled daily
database backups.
What you need
- Two VPS with Ubuntu 22.04+ or Debian 12+: one for the panel and one for the proxy. The panel
is fine with 1 CPU and 1 GB of RAM. The proxy server needs ports 80 and 443, so it can't share
a VPS with the panel. You can add as many proxy servers later as you like.
- A domain such as
example.com, with DNS records that point at your servers.
- SSH access to the servers as root.
If some of these words are new to you, start with the From scratch guide. It
walks through everything step by step: which server to rent, how to buy a domain, how to connect
to a server and how to send a friend your first link.
Quick install
-
On the panel server, run:
curl -fsSL https://raw.githubusercontent.com/greenpandorik/tgproxy-panel/main/install.sh | sudo bash
The script asks for the panel's domain, an e-mail for the certificate and the admin
credentials. At the end it prints the panel address, and the password if you didn't set one.
-
In the panel, open Servers → Add server and enter the proxy server's domain. The panel gives
you a command: run it on the proxy server. A couple of minutes later the server shows up in the
list.
-
Open Users → New user, pick the servers and send the person the subscription link or its QR
code.
To upgrade the panel: sudo /opt/tgproxy-panel/install.sh --update. To upgrade a proxy server:
tgwp-agent upgrade on that server.
Documentation
| Document | Who it is for |
|---|
| From scratch | Renting a server for the first time: every step, plus a glossary |
| Installation | Comfortable with Linux: installing the panel and servers in detail, every option |
| Reference | How it all works: engines, panel screens, environment variables |
| Runbook | Upgrades, backups and what to do when something breaks |
| Monitoring | Prometheus metrics and the Grafana dashboard |
| Contributing | Building the project, running the tests and sending changes |
| Security | How to report a vulnerability |
Questions and ideas go to Discussions.
Credits
telemt is the proxy that runs on the servers. One telemt
process serves the WEB proxy, Fake-TLS, the cover site and the control API. The panel installs a
specific vetted release and checks its checksum. telemt is distributed under its own TELEMT PL 3
licence, whose text ships with the program.
MTPROTO_FIX_By_MEKO is the fix for the
SYN-flood connection problems Telegram proxies started hitting in June 2026. telemt carries it as
synlimit, and the panel turns it on for every server. The network settings the installer writes
to /etc/sysctl.d/90-tgwp.conf come from the same place.
tproxy-server and the official MTProxy run on
servers with the older tproxy engine.
Remnawave is the panel whose look this interface borrows:
the floating sectioned menu, the metric cards and the dark palette with a cyan accent. The
interface code is our own.
Give it a star
If the panel is useful to you, give it a star:
that is how other people setting up Telegram proxies find the project.
Licence
AGPL-3.0.
