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.
Giving access: enter a name, pick the servers and get the links with QR codes.
- 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.
- 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.
-
On the panel server, run:
curl -fsSL https://raw.githubusercontent.com/greenpandorik/tgproxy-panel/main/install.sh | sudo bashThe 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.
| 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.
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.
If the panel is useful to you, give it a star: that is how other people setting up Telegram proxies find the project.