Переносит переписку из мессенджера MAX в Telegram и обратно. Каждый чат MAX становится отдельной темой (топиком) у вашего Telegram-бота, ответы в теме уходят в MAX. Один экземпляр обслуживает несколько учеток.
В обе стороны поддерживаются:
- Правки, удаления, ответы (reply)
- Форматирование: жирный, курсив, код, ссылки, цитаты
- Изображения, голосовые сообщения, видео
Только из Телеграм в MAX:
- реакции
Многим не хочется запускать мессенджер MAX ни на телефоне, ни на десктопе. Какое-то время терпел работу в браузере, но нужна мобильность. Поэтому сделал небольшой сервис в Docker. Мне попадались похожие решения, но они были для MAX-ботов, а нужна была полноценная эмуляция клиента. Клиент реализует библиотека PyMax - огромная благодарность автору!
- Сервер с Docker Engine и Docker Compose.
- Аккаунт MAX с включённым паролем 2FA. Включите его в приложении MAX заранее: без пароля сервер MAX не пускает новое устройство, и вход с SMS-кодом не пройдёт.
- Telegram-бот от @BotFather с включёнными Threaded Mode (Топики).
-
Скопируйте
.env.exampleв.env, задайтеMAXGATE_UI_PASSWORD(пароль входа в веб-интерфейс) иMAXGATE_INTERNAL_TOKEN(любая случайная строка). -
Сгенерируйте ключ шифрования базы и запишите его в
.envкакMAXGATE_SECRET_KEY:docker compose -f docker-compose.yml run --rm --no-deps bridge maxgate gen-key
-
Соберите и запустите:
docker compose -f docker-compose.yml up --build -d
-
Откройте http://127.0.0.1:8501, войдите по паролю и нажмите «Создать учётку»: укажите имя, номер MAX, токен бота и ваш Telegram id.
-
Нажмите «Войти», введите SMS-код из MAX (около минуты на ввод), затем пароль 2FA. Пароль нигде не сохраняется: MAX запоминает устройство, и повторный вход его не требует.
-
Напишите боту
/start. Чаты MAX появятся темами в переписке с ботом.
Веб-интерфейс доступен только с самого сервера. Для доступа снаружи поставьте перед ним reverse proxy с HTTPS.
| Команда | Что делает |
|---|---|
/status |
Состояние учётки |
/mute, /unmute |
Выключить и включить перенос для темы |
/history N |
Подгрузить последние N сообщений чата (до 100), пропуская уже перенесённые |
/reload N |
Заново прислать последние N сообщений, даже если они уже были в теме |
/delete |
Ответом на сообщение в теме: удалить оригинал в MAX для всех и копию в Telegram |
/info |
Сведения о чате |
База лежит в томе maxgate-data. Для резервной копии остановите контейнеры и сохраните
файл maxgate.db вместе с MAXGATE_SECRET_KEY: без ключа база бесполезна.
Архитектура и решения: docs/design.md, docs/adr/, глоссарий CONTEXT.md, рабочие заметки CLAUDE.md.
GNU AGPL-3.0, © 2026 Sergey Filkin. Пользоваться, изменять и распространять можно свободно, в том числе в коммерческих целях. Если вы распространяете изменённую версию или даёте пользоваться ею по сети, её исходный код нужно открыть под той же лицензией.