Сейчас один номер = один аккаунт MAX (свой номер, свой Telegram-бот, своя группа). Для второго аккаунта — да, поднимаете второй контейнер с отдельным .env (другой номер, другой бот-токен, другая группа, свой порт). Несколько аккаунтов в одном инстансе — в планах, пока так.
Сейчас прокси для Telegram пока нет, стоит в планах на ближайшее обновление. Считайте что завтра всё будет )
Честно - теоретически риск есть. Telemax заходит как обычный пользователь по тому же протоколу, что и родное приложение (device/handshake/TLS — как у официального клиента), но это неофициальный клиент, и гарантий «никогда не прилетит» я не дам. На практике за время работы (личный номер крутится в проде не первую неделю) блокировок не ловил.
За ссылки, спасибо, посмотрел - немного не то. Там связки БОТ МАХ - БОТ ТГ, с вытекающими недостатками: в групповой чат Мах никто стороннего (Вашего) бота админом не пустят, а по-другому он не увидит сторонние сообщения в чатах. И там TG→MAX удаление в принципе не работает — они сами пишут, что Bot API не шлёт событие удаления. У меня этот момент обойдён, удаление работает в обе стороны )
бот вообще как-то проявляется в вашей Telegram-группе? В свежей версии он после старта сам пишет туда «✅ Telemax подключён к этой группе» и заводит отдельную тему под каждый MAX-чат.
— Если активности бота в группе нет совсем — он не достучался до Telegram. Частая причина на российских хостингах: IPv6-маршрут до api.telegram.org заблокирован, а Node по умолчанию сначала пробует именно IPv6 и виснет на подключении. Только что выкатил фикс (форсирую IPv4) — обновитесь: /version в группе → «Обновить» (или ./update.sh). Ещё проверьте, что бот добавлен в группу админом с правом «Управление темами», а TARGET_TELEGRAM_GROUP в .env — id именно этой группы.
— Если бот в группе активен, но сообщения из MAX не идут — почти наверняка не завершена авторизация MAX. docker compose logs --tail=30: нет строки Resumed session for +… → аккаунт не подключён. Добейте через веб-панель или заново запустите ./setup.sh — он теперь замечает, что MAX не авторизован, и предлагает доввести номер и код прямо в консоли.
Пароль: консоль спрашивает его только ПОСЛЕ номера и SMS — похоже, этот шаг проскочил (в свежей версии сделал его заметнее). А MAX_SESSION_KEY в параметрах докера — это не пароль от MAX, а ключ шифрования сессии, не перепутайте. Через веб-панель шаг пароля есть — им и логинились, всё верно.
IPv6 - баг. Спасибо, поправлю: добавлю в приложение принудительный IPv4-first, чтобы не приходилось руками лезть в hosts.
Про Chromium — да, там реально внутри образа сидит целый headless-браузер. Отвечаю честно: он нам нужен ровно для одной фичи — анимированных стикеров (жена попросила 😄). MAX-ские «живые» стикеры — это Lottie-анимации, и чтобы протащить их в MAX как видео, мост рендерит их покадрово в headless Chromium (через lottie-web на canvas), а потом ffmpeg склеивает кадры в WebM. Так что да — целый браузер + ffmpeg в комплекте живут только ради того, чтобы ваш пляшущий стикер доехал через мост и там крутился 🕺. На хосте он не нужен и его там нет — он внутри контейнера. На обычные сообщения не влияет от слова совсем: если бы Chromium вдруг пропал, сломалась бы только отправка анимированных стикеров, не более.
Спасибо добрый человек за первый практический отзыв )))
Прогнал полную установку на чистой Debian 13 (trixie) с <1 ГБ RAM, всё ставится и запускается. Скорее всего проблема с заметности последнего шага — запрос номера MAX и кода из SMS появляется уже после сборки образа (её простыня в консоли легко принимается за финал). Без него мост поднят, но к аккаунту не подключён — отсюда «не работает».
Что сделать если виртуалку еще не снесли: откройте веб-панель https://<ip>:3000 (ключ на сервере — grep API_KEY /opt/telemax/.env), в разделе конфигурация введите ключ, затем номер и код из SMS. Или просто удалите .env на сервере и запустите ./setup.sh заново.
По Вашему фидбэку уже поправил: шаг авторизации теперь с явным баннером «без него не заработает» и финальным статусом, подсказку про ключ в панели дописал, плюс добавил в README раздел «Если что-то не работает».
Тут не «анализ vs альтернатива» — это разные задачи. Веб-версия и урезанные клиенты решают «как безопаснее пользоваться Максом». Мост решает другое: не пользоваться Максом как приложением вообще — читать и отвечать из мессенджера, где я и так сижу, с уведомлениями, голосовыми, стикерами и всей перепиской в одном месте. «Обречён на забвение» — возможно; но проект открытый, поднимается за минуту на своём сервере и лично мне уже полезен. Этого достаточно, чтобы поделиться.
Вариант с PWA в песочнице тоже рабочий и, пожалуй, стабильнее — просто другой набор компромиссов (браузер открытым, часть функций недоступна, удобство использования). Выбор по вкусу. Тут да — звеньев больше, чем у прямого клиента, это цена подхода. Встроено пара моментов для стабильности: мост сам переподключается к MAX при обрыве и переживает рестарты (сессия сохраняется), плюс есть автообновление, чтобы поспевать за изменениями протокола. Но да — если MAX что-то ломает у себя, мосту, как любому стороннему клиенту, надо чинить оперативно.
Веб версия - хороший вариант, но надо постоянно держать открытым браузер что бы уведомления приходили, не работают голосовые, стикеры и в целом ТГ удобнее и привычнее пользоваться.
Ничто же не мешает на свой VPS пихать. И вообще можно держать его в ОЗУ, что бы при отключении питания сервера всё исчезало ) Степень паранойи у всех разная.
Холивар на тему установки/бойкота Мах можно продолжать бесконечно и это не тема этого поста. Тут логика простая, если необходимый функционал можно получить в привычном приложении - зачем плодить другие?
MAX на сервер не ставится — ни приложения, ни эмулятора Android. Мост это отдельная программа (Node.js), которая подключается к серверам MAX как обычный клиент: авторизуется вашим номером (SMS, при необходимости пароль) и дальше работает как ваш аккаунт — принимает и отправляет сообщения.
По библиотекам:
— Telegram-сторона обычная: официальный Bot API + библиотека Telegraf, ничего экзотического.
— Со стороны MAX готового API или SDK нет, поэтому клиент к нему написан свой. Код открытый, лежит в репе — устройство можно просто посмотреть. Отдельный разбор протокола в статью я сознательно не тащил, чтобы не превращать её в мануал.
А дальше всё просто: пришло из MAX → ушло в вашу Telegram-группу отдельной темой, написали в теме → ушло обратно в MAX.
Если на РУ сервере будет связь с ТГ и Мах, то всё будет работать. У меня пока стоит на забугорном.
Спасибо! По пунктам:
Сейчас один номер = один аккаунт MAX (свой номер, свой Telegram-бот, своя группа). Для второго аккаунта — да, поднимаете второй контейнер с отдельным
.env(другой номер, другой бот-токен, другая группа, свой порт). Несколько аккаунтов в одном инстансе — в планах, пока так.Сейчас прокси для Telegram пока нет, стоит в планах на ближайшее обновление. Считайте что завтра всё будет )
Честно - теоретически риск есть. Telemax заходит как обычный пользователь по тому же протоколу, что и родное приложение (device/handshake/TLS — как у официального клиента), но это неофициальный клиент, и гарантий «никогда не прилетит» я не дам. На практике за время работы (личный номер крутится в проде не первую неделю) блокировок не ловил.
За ссылки, спасибо, посмотрел - немного не то. Там связки БОТ МАХ - БОТ ТГ, с вытекающими недостатками: в групповой чат Мах никто стороннего (Вашего) бота админом не пустят, а по-другому он не увидит сторонние сообщения в чатах. И там TG→MAX удаление в принципе не работает — они сами пишут, что Bot API не шлёт событие удаления. У меня этот момент обойдён, удаление работает в обе стороны )
бот вообще как-то проявляется в вашей Telegram-группе? В свежей версии он после старта сам пишет туда «✅ Telemax подключён к этой группе» и заводит отдельную тему под каждый MAX-чат.
— Если активности бота в группе нет совсем — он не достучался до Telegram. Частая причина на российских хостингах: IPv6-маршрут до
api.telegram.orgзаблокирован, а Node по умолчанию сначала пробует именно IPv6 и виснет на подключении. Только что выкатил фикс (форсирую IPv4) — обновитесь:/versionв группе → «Обновить» (или./update.sh). Ещё проверьте, что бот добавлен в группу админом с правом «Управление темами», аTARGET_TELEGRAM_GROUPв.env— id именно этой группы.— Если бот в группе активен, но сообщения из MAX не идут — почти наверняка не завершена авторизация MAX.
docker compose logs --tail=30: нет строкиResumed session for +…→ аккаунт не подключён. Добейте через веб-панель или заново запустите./setup.sh— он теперь замечает, что MAX не авторизован, и предлагает доввести номер и код прямо в консоли.Скинете
docker compose logs --tail=50(без токенов/ключей) — скажу точнее.Пароль: консоль спрашивает его только ПОСЛЕ номера и SMS — похоже, этот шаг проскочил (в свежей версии сделал его заметнее). А
MAX_SESSION_KEYв параметрах докера — это не пароль от MAX, а ключ шифрования сессии, не перепутайте. Через веб-панель шаг пароля есть — им и логинились, всё верно.IPv6 - баг. Спасибо, поправлю: добавлю в приложение принудительный IPv4-first, чтобы не приходилось руками лезть в hosts.
Про Chromium — да, там реально внутри образа сидит целый headless-браузер. Отвечаю честно: он нам нужен ровно для одной фичи — анимированных стикеров (жена попросила 😄). MAX-ские «живые» стикеры — это Lottie-анимации, и чтобы протащить их в MAX как видео, мост рендерит их покадрово в headless Chromium (через lottie-web на canvas), а потом ffmpeg склеивает кадры в WebM. Так что да — целый браузер + ffmpeg в комплекте живут только ради того, чтобы ваш пляшущий стикер доехал через мост и там крутился 🕺. На хосте он не нужен и его там нет — он внутри контейнера. На обычные сообщения не влияет от слова совсем: если бы Chromium вдруг пропал, сломалась бы только отправка анимированных стикеров, не более.
Спасибо добрый человек за первый практический отзыв )))
Прогнал полную установку на чистой Debian 13 (trixie) с <1 ГБ RAM, всё ставится и запускается. Скорее всего проблема с заметности последнего шага — запрос номера MAX и кода из SMS появляется уже после сборки образа (её простыня в консоли легко принимается за финал). Без него мост поднят, но к аккаунту не подключён — отсюда «не работает».
Что сделать если виртуалку еще не снесли: откройте веб-панель
https://<ip>:3000(ключ на сервере —grep API_KEY /opt/telemax/.env), в разделе конфигурация введите ключ, затем номер и код из SMS. Или просто удалите.envна сервере и запустите./setup.shзаново.По Вашему фидбэку уже поправил: шаг авторизации теперь с явным баннером «без него не заработает» и финальным статусом, подсказку про ключ в панели дописал, плюс добавил в README раздел «Если что-то не работает».
Тут не «анализ vs альтернатива» — это разные задачи. Веб-версия и урезанные клиенты решают «как безопаснее пользоваться Максом». Мост решает другое: не пользоваться Максом как приложением вообще — читать и отвечать из мессенджера, где я и так сижу, с уведомлениями, голосовыми, стикерами и всей перепиской в одном месте. «Обречён на забвение» — возможно; но проект открытый, поднимается за минуту на своём сервере и лично мне уже полезен. Этого достаточно, чтобы поделиться.
Вариант с PWA в песочнице тоже рабочий и, пожалуй, стабильнее — просто другой набор компромиссов (браузер открытым, часть функций недоступна, удобство использования). Выбор по вкусу. Тут да — звеньев больше, чем у прямого клиента, это цена подхода. Встроено пара моментов для стабильности: мост сам переподключается к MAX при обрыве и переживает рестарты (сессия сохраняется), плюс есть автообновление, чтобы поспевать за изменениями протокола. Но да — если MAX что-то ломает у себя, мосту, как любому стороннему клиенту, надо чинить оперативно.
В тыкву они превратились, в том числе, благодаря приложениям типа Мах установленными в телефонах пользователей.
Веб версия - хороший вариант, но надо постоянно держать открытым браузер что бы уведомления приходили, не работают голосовые, стикеры и в целом ТГ удобнее и привычнее пользоваться.
Вынужден обновлять оперативно, так как у самого рабочие чаты там висят...
Ничто же не мешает на свой VPS пихать. И вообще можно держать его в ОЗУ, что бы при отключении питания сервера всё исчезало ) Степень паранойи у всех разная.
Большая разница - в свой телефон чужое ПО не пихаешь.
Холивар на тему установки/бойкота Мах можно продолжать бесконечно и это не тема этого поста. Тут логика простая, если необходимый функционал можно получить в привычном приложении - зачем плодить другие?
MAX на сервер не ставится — ни приложения, ни эмулятора Android. Мост это отдельная программа (Node.js), которая подключается к серверам MAX как обычный клиент: авторизуется вашим номером (SMS, при необходимости пароль) и дальше работает как ваш аккаунт — принимает и отправляет сообщения.
По библиотекам:
— Telegram-сторона обычная: официальный Bot API + библиотека Telegraf, ничего экзотического.
— Со стороны MAX готового API или SDK нет, поэтому клиент к нему написан свой. Код открытый, лежит в репе — устройство можно просто посмотреть. Отдельный разбор протокола в статью я сознательно не тащил, чтобы не превращать её в мануал.
А дальше всё просто: пришло из MAX → ушло в вашу Telegram-группу отдельной темой, написали в теме → ушло обратно в MAX.
Автор женского рода, а статья написана от мужского.
Похоже ИИ тут использовал человека как инструмент )
Честно пытался осилить - ничего не понял. Для тех кто ничего про это не знает - ничего не понятно, а для тех кто знает это совсем не нужно