PCAtelegram_web/README.md

PCAtelegram_web

Отдельный проект PCAtelegram_web: MTProxy на базе telemt, Telegram-бот, локальная web-admin панель, статистика, backup/restore, шаблоны сайта.

Поддержать проект: Boosty · Ozon Bank · Telegram · GitHub

Что умеет

• Web-admin для управления MTProxy без ручного редактирования TOML.
• Создание, отключение, удаление ключей и лимит IP на пользователя.
• Выбор публичного порта и сайта маскировки FakeTLS.
• Автоустановка telemt, если прокси-ядро отсутствует при сохранении маршрута.
• WARP / WARP+ настройки, backup/restore, статистика трафика.
• Session cookie переживает restart web-admin; auto-refresh не сбрасывает поля во время ввода.

Установка

На сервере под root:

curl -fsSL https://raw.githubusercontent.com/andrey271192/PCAtelegram_web/main/bootstrap.sh | bash

Если репозиторий private, первый curl тоже должен получить GitHub token:

curl -fsSL -H "Authorization: Bearer $GITHUB_TOKEN" \
  https://raw.githubusercontent.com/andrey271192/PCAtelegram_web/main/bootstrap.sh | \
  GITHUB_TOKEN="$GITHUB_TOKEN" bash

После установки команда доступна как:

pcatelegram_web

Локальная проверка без GitHub

rsync -a ./ root@SERVER:/opt/pcatelegram_web/
ssh root@SERVER 'chmod +x /opt/pcatelegram_web/install.sh /opt/pcatelegram_web/install_pcatelegram_web_bot.sh /opt/pcatelegram_web/lib/*.sh && ln -sf /opt/pcatelegram_web/install.sh /usr/local/bin/pcatelegram_web && pcatelegram_web'

Состав

Путь	Назначение
bootstrap.sh	загружает файлы проекта в /opt/pcatelegram_web и запускает меню
install.sh	основное CLI-меню PCAtelegram_web
install_pcatelegram_web_bot.sh	отдельная установка Telegram-бота
lib/	общие функции, telemt, nginx/site, stats, backup, i18n
pcatelegram_web-bot/	Python Telegram bot
admin-web/	локальная web-admin панель
templates_catalog.json	каталог HTML-шаблонов

Переменные

Переменная	По умолчанию	Описание
PCATELEGRAM_WEB_BASE	https://raw.githubusercontent.com/andrey271192/PCAtelegram_web/main	база загрузки файлов
PCATELEGRAM_WEB_INSTALL_DIR	/opt/pcatelegram_web	путь установки
GITHUB_TOKEN / GH_TOKEN	пусто	token для private GitHub raw downloads
PCATELEGRAM_WEB_ADMIN_HOST	0.0.0.0	bind web-admin
PCATELEGRAM_WEB_ADMIN_PORT	1984	port web-admin
PCATELEGRAM_WEB_ADMIN_USER	admin	Basic Auth login
PCATELEGRAM_WEB_ADMIN_PASSWORD	admin	web-admin password
PCATELEGRAM_WEB_WARP_CONFIG	/opt/pcatelegram_web/warp.json	WARP / WARP+ settings
PCATELEGRAM_WEB_SITE_ROOT	/var/www/pcatelegram_web-site	root публичного HTML-сайта на 80
PCATELEGRAM_WEB_NGINX_MASK_CONF	/etc/nginx/sites-available/pcatelegram_web-mask	nginx config сайта на 80

Поддержать проект

Если проект оказался полезным — буду рад поддержке. Это помогает развивать и поддерживать его дальше.

• Boosty
• Ozon СБП
• Telegram: @PCAdministration — вопросы, идеи, обратная связь

Web-admin

После первого запуска pcatelegram_web web-admin панель ставится как pcatelegram_web-admin.service и слушает публично:

http://SERVER:1984/

Логин и пароль по умолчанию: admin / admin. Данные можно сменить в web-admin Settings. Текущие данные хранятся на сервере:

sudo cat /root/pcatelegram_web-admin.password

Для своего пароля передайте env до установки:

PCATELEGRAM_WEB_ADMIN_PASSWORD='strong-password' bash bootstrap.sh

Без HTTPS Basic Auth гонит пароль открытым текстом. Для постоянного доступа лучше reverse proxy с TLS, но порт 1984 открыт по умолчанию по запросу проекта.

WARP / WARP+

В web-admin Settings есть блок WARP / WARP+:

• Off — WARP выключен.
• WARP — обычный Cloudflare WARP.
• WARP+ — WARP+ с license key.
• All clients — если warp-cli не установлен, web-admin ставит cloudflare-warp, затем применяет WARP на весь proxy-трафик через warp-cli.
• One client — если warp-cli не установлен, web-admin ставит cloudflare-warp, затем сохраняет WARP/WARP+ профиль и key для выбранного клиента в /opt/pcatelegram_web/warp.json.

WARP+ key не отдается в API целиком: web показывает только маску. Файл warp.json хранится с правами 0600 и входит в backup.

Для real global WARP web-admin использует официальный Cloudflare Linux repo: добавляет GPG key, repo pkg.cloudflareclient.com, ставит пакет cloudflare-warp, затем выполняет регистрацию warp-cli registration new, WARP+ key warp-cli registration license <KEY>, подключение warp-cli connect.

Per-client runtime routing в текущем telemt не включается автоматически: публичные параметры telemt дают users/limits/quotas/ad tags, но не документируют привязку upstream к конкретному user. Для настоящего WARP только одному клиенту нужен отдельный telemt route/service или upstream-схема.

Порт и маскировка

В web-admin Settings есть блок Port and mask site:

• Public port — реальный порт telemt ([server] port) и порт в tg-ссылках ([general.links] public_port).
• Mask site — сайт маскировки FakeTLS ([censorship] tls_domain), который вшивается в ee secret.
• Перед сохранением web-admin проверяет порт через ss. Если порт занят не telemt (например, Xray / 3x-ui на 443), сохранение блокируется.
• После сохранения обновляются /etc/telemt/config.toml, /opt/pcatelegram_web/config.json, ссылки клиентов и перезапускается telemt.

Один telemt-инстанс имеет один публичный порт и один сайт маскировки для всех клиентов. Разные порты или разные сайты маскировки на разных клиентов требуют отдельные telemt services/configs.

Свой домен и сайт на 80

Чтобы домен открывал обычный публичный сайт:

1. В панели регистратора домена создай DNS A запись: @ → IP сервера.
2. Если нужен www, создай A запись www → IP сервера.
3. Дождись DNS. Обычно от нескольких минут до нескольких часов.
4. В web-admin открой Settings → Domain and mask site.
5. Введи домен без http://, например example.ru.
6. Нажми Install site on 80.

Если порт 80 свободен, web-admin поставит/настроит nginx и отдаст нейтральный одностраничный HTML-сайт без упоминаний proxy, VPN, MTProxy или PCAtelegram_web. Если порт занят чужим процессом, сохранение будет заблокировано.

Чтобы поставить свой HTML-сайт:

1. В том же блоке выбери .html / .htm файл.
2. Нажми Add HTML site.
3. Проверь http://DOMAIN/.

Лимит файла: 1 MB. Не клади в HTML секреты, токены, ключи и внутренние ссылки. Кнопка Remove site удаляет nginx config сайта с порта 80, но не трогает telemt и ключи клиентов.

Ошибки и решения

Telegram пишет соединение и proxy не подключается

Причины:

• telemt не запущен.
• Порт закрыт firewall/VPS provider.
• В Telegram осталась старая ссылка со старым secret.

Проверка:

systemctl is-active telemt
ss -tulpn | grep -E ':(443|5443)\b'
journalctl -u telemt --since "10 min ago" -n 80 --no-pager

Решение:

• В web-admin открой Keys, скопируй свежую ссылку нужного пользователя и заново добавь proxy в Telegram.
• Если telemt отсутствует, в web-admin сохрани Port and mask site: панель поставит telemt, создаст main, запустит сервис.
• Если порт не слушает, перезапусти:

systemctl restart telemt
systemctl status telemt --no-pager -l

unauthorized при создании ключа

Обычно это старая вкладка после restart web-admin.

Решение:

• Обнови страницу и войди снова.
• Начиная с cache admin26 session cookie переживает restart, а при настоящем 401 UI отправляет на login.

Проверка:

systemctl is-active pcatelegram_web-admin.service
journalctl -u pcatelegram_web-admin --since "10 min ago" -n 80 --no-pager

Не меняется Лимит IP, поле скачет или откатывается

Причина: auto-refresh перерисовал карточку пользователя во время ввода.

Решение:

• Начиная с cache admin28 background refresh не трогает страницу, пока курсор находится в input, select или textarea.
• Сделай hard refresh браузера после обновления панели: Ctrl+Shift+R / Cmd+Shift+R.

Проверка через API:

curl -b cookies.txt -H 'Content-Type: application/json' \
  -H 'X-PCAtelegram-Web-Admin: 1' \
  -d '{"max_unique_ips":2}' \
  http://SERVER:1984/api/users/main/max-ips

Порт 443 занят

Проверка:

ss -tulpn | grep ':443'

Если там xray, 3x-ui, nginx или другой процесс, web-admin покажет конфликт и не даст сохранить telemt на этот порт. Выбери свободный порт, например 5443, либо освободи 443 вручную.

GitHub пишет Repository not found

Возможные причины:

• private repo удалён;
• GitHub token больше не имеет доступа;
• GITHUB_TOKEN не передан при установке private repo.

Проверка:

git ls-remote origin HEAD

Для private install:

curl -fsSL -H "Authorization: Bearer $GITHUB_TOKEN" \
  https://raw.githubusercontent.com/andrey271192/PCAtelegram_web/main/bootstrap.sh | \
  GITHUB_TOKEN="$GITHUB_TOKEN" bash

Web-admin не открывается на :1984

Проверка:

systemctl is-active pcatelegram_web-admin.service
ss -tulpn | grep ':1984'
journalctl -u pcatelegram_web-admin --since "10 min ago" -n 80 --no-pager

Если сервис работает, но порт не открывается снаружи, проверь firewall/VPS security group.

Проверки

bash -n bootstrap.sh install.sh install_pcatelegram_web_bot.sh lib/*.sh lib/lang/*.sh
rg -i "old-brand-name" .