Telemax/docs/llms.txt

# Telemax

> Telemax — бесплатный мост между мессенджерами MAX и Telegram с открытым кодом (лицензия AGPL-3.0). Он входит в личный аккаунт MAX по номеру телефона и приносит все чаты MAX в группу Telegram: каждый чат — отдельная тема. Ответы из Telegram уходят в MAX от имени владельца аккаунта. Мост ставится на свой сервер (VPS на Ubuntu 22.04+ или Debian 12+) одной командой; платить нужно только за сервер.

## Что умеет

- Все чаты MAX — личные диалоги, группы, боты — приходят в Telegram сами, без добавления бота в каждый чат: мост работает от личного аккаунта, а не как бот.
- Сообщения в обе стороны: текст, фото, видео, файлы, голосовые, видеокружки, стикеры (в том числе анимированные), опросы, геолокация, контакты.
- Ответы с цитатой, правки, удаление в обе стороны, реакции.
- Большие файлы: из MAX больше 50 МБ приходят ссылкой «Скачать» с вашего сервера; в MAX можно отправить файл до 4 ГБ через страницу загрузки. Есть свой файлообменник: файл любого размера на сервере и ссылка, которой можно делиться. Командой /file в теме чата файл с сервера отправляется в этот чат MAX без повторной загрузки. Для ссылок нужен белый IP сервера и открытые порты 80 и 443 — установщик проверяет это сам и, если сервер за роутером, предлагает выключить большие файлы.
- Кнопки ботов MAX работают в Telegram: ссылки, копирование кода, нажатия от имени владельца.
- Пульт управления в группе (/panel): поиск человека по номеру телефона или MAX ID, ботов и каналов — по нику; новый чат в одно нажатие; статус сервера; пауза и бан чатов.
- Вход в MAX — в личке бота: номер, код из SMS, пароль. В группу они не попадают.
- Обновления по кнопке в боте; релизы подписаны, неудачное обновление откатывается. Если GitHub недоступен, установка и обновления идут с зеркала проекта.
- Подключение своего прокси SOCKS5/HTTP для Telegram; несколько аккаунтов MAX на одном сервере (по мосту на аккаунт).

## Установка

Нужны сервер на Ubuntu 22.04+ или Debian 12+ (хватит меньше 1 ГБ памяти и 3 ГБ диска), бот из @BotFather и группа Telegram с включёнными темами, где бот — администратор с правом «Управление темами». Команда от root:

    curl -fsSL https://raw.githubusercontent.com/Trollobot/Telemax/main/install.sh | bash

Если GitHub с сервера недоступен:

    curl -fsSL https://zergont-gate.duckdns.org/install.sh | bash

Затем команда /login в личке бота — и чаты MAX начинают появляться в группе. Ручная установка без скриптов (docker compose и .env) описана в README.

Подойдёт и российский VPS: если Telegram с него не открывается, мост может работать через прокси. Сам прокси в комплект не входит — нужен свой SOCKS5 или HTTP-прокси, его адрес указывается при установке; MAX при этом идёт напрямую.

## Ограничения

- Проект неофициальный и работает с вашим аккаунтом MAX на ваш страх и риск.
- Это не сквозное шифрование: переписка проходит через ваш сервер, его стоит защищать.
- Любой участник группы Telegram видит все чаты MAX — группу держат закрытой.
- Аккаунт MAX нужен свой: регистрация и пароль делаются в приложении MAX, дальше приложение можно не открывать.
- Звонки приходят только уведомлениями; мини-приложения ботов открываются в MAX.

## Ссылки

- [Сайт](https://telemax.svnest.ru/): возможности, установка, частые вопросы
- [Пошаговая инструкция: как читать и отвечать на MAX из Telegram](https://telemax.svnest.ru/max-v-telegram/)
- [Исходный код и README на GitHub](https://github.com/Trollobot/Telemax)
- [Первый пост на Хабре (август 2026)](https://habr.com/ru/posts/1070812/)
- [Статья на Хабре: бан на GitHub и что изменилось за месяц](https://habr.com/ru/articles/1092754/)
- [Статья на vc.ru](https://vc.ru/id973711/3179706-telemax-integratsiya-max-i-telegram)
- [Обратная связь: баги, идеи, вопросы по установке — бот @TelemaxSvv_bot](https://t.me/TelemaxSvv_bot), ответ приходит в Telegram
- [Открытая статистика посещений сайта](https://telemax.svnest.ru/stats/)