Telemt Panel

Web-панель управления для Telemt MTProxy. Позволяет мониторить состояние сервера, управлять пользователями, отслеживать безопасность и обновлять бинарник — всё через браузер.

Содержание

• Скриншоты
• Возможности
• Требования
• Быстрый старт
• Сборка
• Конфигурация
• Systemd
• CLI
• Стек
• Лицензия

Скриншоты

Dashboard	Users	Runtime

Возможности

• Dashboard — здоровье сервера, uptime, соединения, общий трафик, статус DC
• Пользователи — CRUD через API Telemt, сортировка по колонкам, подсветка активных соединений
• Runtime — соединения, ME pool state, ME quality, upstream quality, NAT/STUN, self-test, события
• Безопасность — posture (read-only, whitelist, auth header), лимиты, whitelist
• Upstreams — статус upstream-серверов и пулов
• Обновления — проверка новой версии на GitHub, обновление бинарника в один клик с откатом при ошибке (Telemt и панель)
• TLS — поддержка custom-сертификатов и автоматического Let's Encrypt (ACME)
• GeoIP — определение геолокации по IP через MaxMind GeoLite2
• WebSocket — реалтайм обновление данных без перезагрузки страницы
• Base Path — поддержка запуска за reverse proxy на подпути

Требования

• Linux (x86_64 или aarch64), любой дистрибутив (Debian, Ubuntu, Alpine, CentOS и т.д.)
• Работающий Telemt-сервер с доступным API

Для сборки из исходников: - Go 1.24+ - Node.js 20+ - Docker (опционально, для кросс-компиляции)

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

Установка скриптом

curl -fsSL https://raw.githubusercontent.com/amirotin/telemt_panel/main/install.sh | bash

Скрипт скачает бинарник, создаст конфиг, настроит systemd-сервис и запустит панель.

Ручная установка

1. Скачайте бинарник из Releases (или соберите сами — см. ниже).

2. Создайте конфиг:

sudo mkdir -p /etc/telemt-panel
sudo cp config.example.toml /etc/telemt-panel/config.toml
sudo chmod 600 /etc/telemt-panel/config.toml

1. Сгенерируйте хеш пароля и JWT-секрет:

# Хеш пароля
./telemt-panel hash-password

# JWT-секрет
openssl rand -hex 32

1. Отредактируйте конфиг /etc/telemt-panel/config.toml:

listen = "0.0.0.0:8080"

[telemt]
url = "http://127.0.0.1:2398"
auth_header = ""

[auth]
username = "admin"
password_hash = "$2a$10$..."   # вывод hash-password
jwt_secret = "ваш_секрет"     # вывод openssl rand
session_ttl = "24h"

1. Запустите:

./telemt-panel --config /etc/telemt-panel/config.toml

Панель будет доступна на http://ваш_сервер:8080.

Docker

cp config.example.toml config.toml
# отредактируйте config.toml

docker compose up -d

Сборка

Простая (локальная)

make            # собрать frontend + backend
make release    # собрать бинарники для x86_64 и aarch64

Через Docker (кросс-компиляция)

# Linux/macOS
./build.sh

# Windows
build.bat

Бинарники появятся в ./release/: - telemt-panel-x86_64-linux - telemt-panel-aarch64-linux - SHA256SUMS

Бинарники статические (CGO_ENABLED=0) — работают на любом Linux без зависимостей.

Переопределение версии

make backend VERSION=1.2.3
# или
go build -ldflags="-s -w -X main.version=1.2.3" -o telemt-panel .

Конфигурация

Полный пример конфигурации — config.example.toml.

Systemd

Установка скриптом (рекомендуется)

Скрипт автоматически создаёт системного пользователя telemt-panel, устанавливает бинарник панели в /usr/local/bin, конфиг в /etc/telemt-panel, данные в /var/lib/telemt-panel, настраивает узкий sudoers-drop-in для обновлений и генерирует hardened systemd-юнит:

curl -fsSL https://raw.githubusercontent.com/amirotin/telemt_panel/main/install.sh | bash

Сгенерированный юнит включает:

[Service]
User=telemt-panel
ProtectHome=true
PrivateTmp=true
ReadWritePaths=/etc/telemt-panel /var/lib/telemt-panel

NoNewPrivileges не включается, потому что сервис использует sudo для строго ограниченных операций обновления.

sudoers-drop-in позволяет пользователю telemt-panel выполнять только нужные обновлению команды: замену бинарника, очистку staging-файлов и перезапуск telemt.service и telemt-panel.service.

Ручная установка

sudo useradd --system --shell /usr/sbin/nologin --home /nonexistent telemt-panel
sudo cp telemt-panel.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now telemt-panel

Важно: этот unit-файл запускает панель от пользователя telemt-panel. Если вы устанавливаете вручную, создайте пользователя и настройте права, эквивалентные installer-managed sudoers-drop-in, или отредактируйте unit под свою модель запуска.

Удаление

# Только сервис и бинарник (конфиг и данные сохраняются)
./install.sh uninstall

# Полное удаление (включая пользователя telemt-panel)
./install.sh purge

Логи:

sudo journalctl -u telemt-panel -f

CLI

telemt-panel --config config.toml    # запуск сервера
telemt-panel hash-password           # сгенерировать bcrypt-хеш
telemt-panel version                 # показать версию

Стек

• Backend: Go 1.24, стандартная библиотека + gorilla/websocket, golang-jwt, BurntSushi/toml
• Frontend: React 18, TypeScript, Tailwind CSS, Vite
• Сборка: Multi-stage Docker, статическая линковка

Лицензия

MIT