Telemax Telemax Возможности Инструкция Новости Вопросы GitHub
Новости

Что нового в Telemax

Каждая версия моста — коротко и по-человечески. О новой версии бот сам скажет в группе, а обновиться можно одной кнопкой «Обновить» в /version.

📡 Версия 1.3.5 📡 RSS-лента Как установить
Последняя версия — 1.3.5, 13 октября 2026 33 версий с 22 августа 2026

Октябрь 2026

v1.3.5

Трансляция чатов и контакты MAX

  • «➕ В контакты MAX» — в карточке найденного человека (поиск по номеру, MAX ID или контакт из Telegram) и в /info: в личке собеседник добавляется сразу, в группе — выбранный участник. Контакт из Telegram сохраняется под тем же именем, что у вас в Telegram
  • Трансляция: /broadcast в теме чата копирует новые сообщения этого чата MAX в группы и каналы Telegram — для тех, у кого нет MAX. Мест сколько угодно, бота туда Telegram добавит сам. Остановить — кнопкой в том же /broadcast
v1.3.4

Вход в MAX снова работает

  • Вход в MAX снова работает. MAX перестал пускать устаревшие версии клиента — при /login приходило «Приложение устарело, пожалуйста, обновитесь».
  • Если MAX снова поднимет минимальную версию, вход можно починить самому: MAX_APP_VERSION и MAX_BUILD_NUMBER в .env (как узнать текущие — в README) или вручную проверьте обновление Телемакс - может оно уже готово )))
v1.3.3

Большие файлы: понятные причины сбоев и отправка с сервера

  • Если ссылку на большой файл подготовить не удалось, бот первой строкой называет причину — у сервера нет белого IP, закрыты или заняты порты 80 и 443, домен не тот, временный лимит Let's Encrypt — и объясняет, почему это мешает и что сделать
  • Установщик сам проверяет, есть ли у сервера белый IP и свободны ли порты 80 и 443. Если нет — объясняет и по умолчанию выключает большие файлы, остальное работает как обычно. Включить или выключить позже: ./setup.sh → «Большие файлы»
  • /file в теме чата показывает и файлы, которые уже лежат на сервере: нажали — файл уходит в этот чат MAX прямо с сервера, загружать его заново не нужно
  • Ссылка на загрузку, которой не воспользовались, живёт сутки, а не 3 дня, и сообщение с ней скажет, что она истекла. Ждущие ссылки видны в «📁 Файлы» — их можно открыть или отменить. Загрузка, которая уже идёт, по сроку не обрывается
v1.3.2

Поиск по номеру в любом виде, подсказки прямо в пульте

  • Поиск контакта по номеру понимает номер в любом виде: с пробелами, скобками, тире и с 8 в начале. Контакт из Telegram, отправленный в общую тему группы, тоже находит человека в MAX
  • Если номер не найден, бот объясняет почему и что делать
  • Всё, где пульт просит что-то написать, выбрать или нажать, появляется прямо в пульте, а не внизу чата: поиск, бан и разбан, обновление, список команд, загрузка в файлообменник. Вернуться можно кнопкой «◀️ Назад»
v1.3.1

Свой файлообменник

  • Файлообменник: /panel → 📁 Файлы → «📤 Загрузить файл». Положите на свой сервер файл любого размера — сколько вместит диск — и получите ссылку на скачивание, которой можно делиться где угодно. Файл хранится 3 дня от последней ссылки
  • Кнопка, нажатая, пока мост перезапускался (например, во время обновления), теперь срабатывает, а не молчит — и в группу больше не приходит ложное «⚠️ Ошибка при обработке сообщения или команды»
v1.3.0Крупное обновление

Большие файлы — по ссылке, до 4 ГБ

  • Файлы больше 50 МБ из MAX в Telegram пересылаются по ссылке — напрямую больше бот принять не может. Файл сохраняется на вашем сервере, а в тему приходит кнопка «⬇️ Скачать». Пока файл сохраняется, в теме видно, сколько уже скачано
  • Из Telegram в MAX файл больше 20 МБ — больше бот скачать не может — загружается через страницу на вашем сервере и уходит в MAX обычным файлом, до 4 ГБ. Чтобы не загружать файл дважды, напишите в теме чата /file: ссылка на загрузку придёт сразу
  • Пульт → «📁 Файлы»: файлы на сервере, новая ссылка, удаление и повторная отправка в MAX, если она не удалась. «📤 Загрузить файл» — свой файлообменник: положить файл на сервер и делиться ссылкой где угодно. Файл хранится 3 дня от последней ссылки, потом удаляется сам
  • Для ссылок на сервере открываются порты 80 и 443 — только пока есть хотя бы одна действующая ссылка; служба файлов запускается за несколько секунд. HTTPS настраивается сам, домен не нужен. Если на сервере уже есть свой веб-сервер, файлы можно пустить через него (см. README). Перед каждой передачей мост проверяет свободное место и оставляет 1,5 ГБ для обновлений. Отключить: FILES=off в .env
  • Кнопки мини-приложений ботов MAX стали ссылками: нажатие переправляет в веб к мини-приложению MAX
  • Поиск в пульте больше не оставляет «В ответ …» над полем ввода: после кнопки поиска просто напишите номер, ID или ник следующим сообщением
  • Сбои при пересылке больших файлов попадают в анонимные отчёты об ошибках, без имён файлов
v1.2.1

Боты и каналы MAX снова находятся по нику

  • Поиск по нику снова находит ботов MAX: ник можно писать с «@» или без, а можно вставить ссылку max.ru/ник. Найденный бот приходит карточкой с кнопкой «Начать чат», дальше с ним можно переписываться и нажимать его кнопки
  • В поиске по нику видны и каналы MAX: они приходят кнопками-ссылками и открываются в MAX. Добавить канал в мост пока нельзя
  • Людей по нику MAX не находит — таков его поиск. Подсказка теперь говорит об этом прямо: человека ищите по номеру или MAX ID, а ник из Telegram здесь не подойдёт
v1.2.0Крупное обновление

Кнопки ботов MAX заработали в Telegram

  • Кнопки ботов MAX теперь работают в Telegram. Ссылки открываются, «Скопировать код» копирует текст, а кнопки с действием нажимаются: нажатие уходит боту от вашего имени, его ответ приходит как обычно
  • Нажимать кнопки ботов могут только администраторы группы. После перезапуска моста кнопки под старыми сообщениями перестают работать: напишите боту ещё раз, и он пришлёт свежие
  • Кнопка с готовым текстом отправляет его боту. На запрос геопозиции или контакта мост подсказывает отправить их в тему, оттуда они уходят боту. Мини-приложения открываются только в приложении MAX
  • Анонимные отчёты об ошибках: при неудачном обновлении или сбое моста разработчику уходит отчёт с версией, шагом, текстом ошибки, свободным местом и памятью, версиями ОС, Docker и git. Без текста сообщений, названий чатов и номера телефона. Отключается вместе с телеметрией: TELEMETRY=off в .env
  • Если MAX временно ограничил запросы истории («Слишком много запросов»), мост сам дозаливает чат позже. Раньше тема оставалась пустой до следующего сообщения
  • Тема чата с ботом больше не получает ваше имя, когда вы пишете боту первым
v1.1.1

Обновления стали легче

  • Если обновление не прошло на шаге «сборка образа» — на сервере не хватило места, мост при этом остался на прежней версии. Нажмите «Обновить» ещё раз: тяжёлая часть уже собрана и повторно не скачивается. Не помогло — выполните на сервере docker builder prune -af и docker image prune -f и повторите
  • Обновления стали легче: большая часть образа (браузер для анимированных стикеров, около 1 ГБ) больше не пересобирается при каждом обновлении. Раньше это случалось раз в одну-две недели и требовало 2–3 ГБ свободного места
  • Перед сборкой мост проверяет свободное место, сам убирает остатки прошлых сборок и, если места всё равно мало, сразу говорит, сколько нужно и сколько есть
  • Сообщение о неудачной сборке теперь называет причину, а не только отправляет читать лог на сервере
  • После успешного обновления чистится кэш старых сборок: раньше он только рос и со временем занимал несколько гигабайт
v1.1.0Крупное обновление

Большая работа над надёжностью

  • Удаление темы, /ban, /reboot и /kill больше не стирают ваши сообщения у собеседника в MAX. Раньше мост принимал исчезновение темы за удаление сообщений и отзывал в MAX то, что вы написали за последние часы
  • Догрузка пропущенных сообщений больше не теряет их, если во время неё идёт переписка или Telegram временно недоступен
  • Сообщение из Telegram длиной от 4001 до 4096 знаков теперь доходит в MAX: мост режет его на части по границе строки или слова. Раньше MAX такое сообщение отклонял
  • Альбомы и сообщения с несколькими вложениями удаляются целиком: раньше при удалении в MAX в Telegram оставались «хвосты»
  • Сбои связи при входе больше не сбрасывают сессию: войти по SMS заново мост просит, только если MAX сам трижды отклонил сессию. Зависшее соединение обнаруживается за одну-две минуты, раньше на это уходило 15 минут и больше
  • Правка сообщения, которое мост уже не помнит, приходит с пометкой «✏️ Изменено», вложения повторно не отправляются
  • Музыкальные файлы (mp3 и подобные) из Telegram теперь доходят в MAX как файлы: раньше терялись молча
  • Если тип сообщения передать в MAX нельзя (кубик, история, игра, платное медиа), мост пишет об этом в тему, а не молчит
  • Опросы: опрос, который не проходит ограничения Telegram, приходит текстом, а не теряется. У опроса, созданного в Telegram, появилась подсказка о том, куда попадают голоса
  • Удалять сообщения реакцией 👎 и голосовать в опросах от вашего имени могут только администраторы группы
  • Одно неудачное вложение больше не мешает доставке остальных. Файл больше 50 МБ приходит текстовой заметкой: Telegram не принимает от ботов файлы крупнее
  • Номер телефона в /help и в логах показывается маской
  • Восстановление истории идёт ровнее: сообщения отправляются по одному в три секунды, мост укладывается в ограничения Telegram
  • Установка и обновление через установщик идут только с подписанного релиза
  • Требования: Ubuntu 22.04+ или Debian 12+. Для проверки подписи нужен git 2.34 или новее. На Ubuntu 20.04 и Debian 11 установщик откажется работать, а обновление кнопкой сообщит, что подписанного релиза нет: причина в версии git. Рабочая версия при этом остаётся нетронутой. На Debian 11 помогает git из bullseye-backports

Сентябрь 2026

v1.0.1

Тема нового собеседника — сразу с его именем

  • Тема для нового собеседника называется его именем, а не «MAX chat …»: раньше, если незнакомый контакт писал первым, тема создавалась до того, как мост успевал получить его профиль, и запасное имя оставалось навсегда (хотя закреплённая карточка имя уже знала). Теперь тема переименовывается в момент получения карточки контакта
v1.0.0Версия 1.0

Версия 1.0: несколько мостов на одном сервере

  • Установщик стал менеджером мостов: если на сервере уже есть установленный мост (или несколько), та же команда установки открывает меню — обновить или перенастроить существующий, переустановить его начисто (со сбросом настроек и автоматическим бэкапом старых в /root), поставить ещё один мост рядом или удалить ненужный (один или все; перед удалением настройки и данные тоже сохраняются в бэкап). Вместе с последним мостом убирается и общий таймер автообновления
  • Явный каталог (INSTALL_DIR=…) и неинтерактивный запуск работают как раньше, без меню и лишних вопросов
  • README: новый раздел «Несколько мостов на одном сервере» — что у мостов общее, что у каждого своё, и как ими управлять
Ранние версии 0.4.1 — 0.6.6 · 22 августа — 18 сентября 2026

Сентябрь 2026

v0.6.6

Боты находятся по MAX ID

  • Пульт: поиск по MAX ID теперь находит и ботов — их длинные ID (например, из ника вида @id4725009270_bot) раньше отвергались MAX с «Ошибкой валидации». Починены и «Начать чат» с ботом, и /invite с /kick по таким ID
v0.6.5

Чек-лист при установке и укреплённая безопасность

  • Установка: проверка токена и группы показывает полный чек-лист — что уже в порядке, что именно не так и куда нажать, чтобы исправить. Отдельно подсвечено право «Управление темами»: оно не входит в базовый набор прав администратора, и именно на нём спотыкаются чаще всего
  • Безопасность: содержимое анимированного стикера больше не может вырваться со страницы рендера и выполнить свой код внутри контейнера
  • Надёжность: входящий файл из MAX ограничен по размеру — один огромный файл больше не способен исчерпать память и уронить мост
  • Обновление: если на коммите несколько тегов, проверяются все — одна лишняя метка рядом с настоящим релизом больше не блокирует обновления навсегда
  • Сессия MAX: одновременные записи выстроены в очередь (как в карте чатов), поэтому гонка при переподключении не может повредить файл сессии
  • Пульт: номер телефона показывается маской (карточка закреплена в группе и видна всем участникам); пауза «Навсегда» переименована в «До перезапуска» и честно предупреждает, что перезапуск моста её снимет
v0.6.4

Обновления, которые не залипают

  • Обновления больше не залипают: кнопка «Обновить» переставала работать навсегда, если предыдущая попытка была прервана (перезагрузка, нехватка памяти) — теперь забытый признак распознаётся и не мешает; «✅ Обновлено» приходит только после реально удавшейся сборки и запуска
  • Обновление безопаснее и надёжнее: подпись релиза проверяется ДО того, как новые файлы попадут на диск, при любой неудаче версия откатывается на прежнюю; если на GitHub нет подписанного релиза — мост берёт его с зеркала (раньше в этом случае обновления вставали намертво); проверка «контейнер поднялся» больше не принимает контейнер, падающий по кругу
  • Если сервер ходит в Telegram через прокси, сообщения об обновлении наконец доходят — раньше весь процесс, включая отказы, шёл в полной тишине
  • Сборка при обновлении: секунды вместо минут и без разрастания диска — тяжёлый слой с Chromium перестал пересобираться на каждом коммите
  • Автообновление теперь обслуживает ВСЕ мосты на сервере: один таймер обходит список установок вместо одного выбранного каталога (раньше второй мост молча отбирал автообновление у первого, и то же делал обычный заход в меню настроек). Если автообновления нет вовсе (setup.sh запускали не от root), кнопка «Обновить» прямо говорит об этом, а не обещает несбыточное
  • Несколько мостов на одном сервере: второй ставится в свой каталог (INSTALL_DIR=/opt/telemax-2), имя контейнера фиксируется явно, установка второго не предлагает погасить чужой контейнер
  • Личная переписка защищена: /deletegroup в теме личного чата теперь прямо предупреждает, что удалит её и у собеседника, называя человека по имени; остальные групповые команды в личном чате отвечают понятным отказом вместо невнятной ошибки MAX
  • Мост больше не кирпичится: повреждённый файл сессии MAX не уводит контейнер в вечный перезапуск — мост поднимается и просит /login
  • Спецсимволы в пароле прокси ($, пробел, &) больше не ломают установку и обновления: раньше Docker молча искажал такое значение и Telegram просто не подключался
  • «📊 Статус» больше не сообщает «актуальная версия», когда проверить обновления не удалось
v0.6.3

Честный статус до входа в MAX

  • Пульт и «📊 Статус» честно показывают, что вход в MAX ещё не выполнен: 🔴 «не авторизован — /login» вместо зелёного кружка, который на свежей установке читался как «всё в порядке»
  • «🔄 Пересинхронизация» без входа не запускается, а объясняет, что сначала нужен /login — после входа синхронизация идёт сама
v0.6.2

Исправлена настройка на серверах без прокси

  • setup.sh: исправлен молчаливый выход первичной настройки сразу после «Сделали? Enter» на серверах без прокси для Telegram (сидел с 0.4.9 — то самое «Enter нажимаю и ничего»); найден сквозным прогоном установки с нуля
v0.6.1

Понятные ошибки при поиске группы

  • setup.sh: поиск группы больше не молчит при ошибке Telegram — показывает её текст; при 409 объясняет, что у бота уже запущен другой экземпляр с тем же токеном (старый сервер/контейнер), при 401 — что дело в токене; перед поиском снимает случайно оставленный webhook; подсказка про то, что бот без прав администратора ваших сообщений не видит
v0.6.0Крупное обновление

Статус сервера и поиск по контакту из Telegram

  • Пульт: кнопка «📊 Статус» — версия, аптайм, состояние MAX и Telegram, когда прошли последние сообщения в каждую сторону, диск/RAM/нагрузка сервера, доступность обновления
  • Пульт: поделитесь в общей теме группы контактом из Telegram — бот найдёт его в MAX по номеру и предложит начать чат (автоматически сопоставлять с вашей книгой контактов Telegram бот не может — Bot API не даёт такого доступа)
  • Установка (setup.sh): проверка токена с показом имени бота, ручной ввод id группы, проверка группы — темы включены, бот администратор с «Управлением темами» — с понятным списком того, чего не хватает
  • Установка (install.sh): лог в /var/log/telemax-install.log, предварительная проверка сервера (ОС, диск, RAM, сеть, время), ожидание фонового обновления apt, запасной путь установки Docker
  • /kill: честно про сессию — завершить её на стороне MAX снаружи нельзя; после /kill завершите её в приложении MAX (Настройки → Устройства)
v0.5.3

Установка на свежих VPS без вопросов apt

  • Установка: apt больше не задаёт вопросов про конфиги — conffile-промпт cloud-init на свежих VPS ломал dpkg, и Docker не ставился. На время установки dpkg глобально оставляет текущие конфиги (это доходит и до установщика Docker), dpkg лечится перед установкой Docker, по завершении настройка убирается
v0.5.2

Личка с участником группы в одно нажатие

  • Группы: сообщение о выходе/добавлении участника теперь называет человека, показывает его MAX ID и даёт кнопку «✍️» — открыть с ним личку в один тап (раньше вышедший исчезал из ростера, и написать ему из Telegram было нельзя)
  • Панель: поиск контакта «🆔 По ID» — любой MAX ID из карточки группы или сообщения о выходе можно вставить и начать чат
v0.5.1

Fail2ban чинится сам

  • Fail2ban при установке: исправлена мёртвая тюрьма sshd из 0.5.0 — ставится python3-systemd (без него backend systemd не стартует), успех проверяется по самой тюрьме, а не по службе; если Fail2ban уже стоял без модуля — доставит и перезапустит
v0.5.0Крупное обновление

Открытая лицензия и защита сервера

  • Лицензия: код открыт под GNU AGPL-3.0 (файл LICENSE, раздел в README). Закрытое коммерческое использование — по отдельной лицензии; правообладатель Zergont
  • Защита сервера: install.sh предлагает поставить Fail2ban (по умолчанию — да) — бан подбора пароля по SSH, IP вашей сессии установки в белом списке, работает и на минимальных Ubuntu без auth.log

Август 2026

v0.4.10

Правки с отметкой времени

  • Пометка правок из MAX в Telegram: ✏️ с временем (МСК по умолчанию, TZ в .env) — Telegram не показывает «изменено» у бот-правок; заодно правка группового сообщения больше не теряет авторский префикс
  • README: команда установки с резервного зеркала (когда GitHub недоступен)
v0.4.9

Аудит безопасности и меню настроек

  • Безопасность и надёжность (полный аудит): зеркало и телеметрия переведены на HTTPS, ключ подписи релизов закреплён в install.sh, контейнер работает без root, авто-реконнект при повреждённом кадре MAX, корректное завершение по SIGTERM, таймауты скачиваний и лимиты памяти
  • Настройка после установки: повторный ./setup.sh открывает меню — прокси Telegram с живой проверкой до записи, смена токена/группы, режим стикеров, проверка связи; README без веб-панели
v0.4.8

Личка из списка участников работает

  • Кнопка «Открыть личку» в карточке группы снова открывает чат с выбранным участником, а ошибки отправки видны прямо в теме
v0.4.7

Новая группа появляется сразу

  • Когда вас добавляют в группу MAX, её тема в Telegram появляется сразу, без пустой подписи автора
v0.4.6

Мелкие исправления

  • Служебные события в группах больше не приходят с пустым «Имя:»
  • /help стал короче и понятнее, установщик подсказывает написать что-нибудь в группу
v0.4.5

Личка из карточки группы

  • Ростер группы: кнопка «Открыть личку» → список участников → тап открывает 1:1
v0.4.4

Состав группы в карточке

  • Ростер участников группы в карточке + свои сообщения метятся «Вы» при синхронизации
v0.4.3

В групповых чатах видно автора

  • Автор сообщений в групповых чатах: в теме видно, кто написал
v0.4.2

Проверка подписи обновлений

  • Контрольный выпуск без подписи: мост обязан был отказаться его ставить — и отказался. Проверка подписи работает
v0.4.1

Подписанные обновления

  • Подпись обновлений включена: релизы подписываются SSH-ключом, update.sh проверяет

Как обновиться

Бот сам проверяет обновления раз в сутки и пишет в группу, что нового. Обновиться — кнопкой «Обновить» в этом сообщении или в /version: мост пересоберётся за пару минут, переписка не потеряется. Каждый релиз подписан, а если обновление сорвётся, мост вернётся на прежнюю версию.

Ещё не поставили? Пошаговая инструкция · есть идея или нашли баг — напишите боту.