mirror of
https://github.com/BEARlogin/max-telegram-bridge-bot.git
synced 2026-04-28 03:39:46 +00:00
Bi-directional message bridge between Telegram and MAX messengers. Features: 1:1 chat pairing, reply support, message formatting, prefix toggle, SQLite/PostgreSQL with golang-migrate, Dockerfile, CI/CD with GitHub Actions. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
3.6 KiB
3.6 KiB
MaxTelegramBridgeBot
Мост между Telegram и MAX мессенджером. Пересылает сообщения, медиа, файлы и редактирования между связанными чатами.
Возможности
- Пересылка текстовых сообщений в обе стороны
- Пересылка медиа: фото, видео, документы, голосовые, аудио
- Поддержка ответов (reply) — сохраняется контекст
- Отслеживание редактирования сообщений
- Настраиваемый префикс
[TG]/[MAX] - SQLite или PostgreSQL для хранения связок и маппинга сообщений
Установка
Из бинаря
Скачайте бинарь со страницы релизов и запустите:
chmod +x max-telegram-bridge-bot
./max-telegram-bridge-bot
Docker
docker run -e TG_TOKEN=your_token -e MAX_TOKEN=your_token ghcr.io/bearlogin/max-telegram-bridge-bot:latest
Для сохранения БД между перезапусками:
docker run -e TG_TOKEN=your_token -e MAX_TOKEN=your_token \
-v ./data:/data -e DB_PATH=/data/bridge.db \
ghcr.io/bearlogin/max-telegram-bridge-bot:latest
Из исходников
git clone https://github.com/BEARlogin/max-telegram-bridge-bot.git
cd max-telegram-bridge-bot
go build -o max-telegram-bridge-bot .
./max-telegram-bridge-bot
Быстрый старт
1. Создайте ботов
- Telegram: через @BotFather, отключите Privacy Mode (Bot Settings → Group Privacy → Turn off)
- MAX: через настройки платформы
2. Настройте и запустите
Передайте токены через переменные окружения:
TG_TOKEN=your_token MAX_TOKEN=your_token ./max-telegram-bridge-bot
Или через export:
export TG_TOKEN=your_token
export MAX_TOKEN=your_token
./max-telegram-bridge-bot
3. Свяжите чаты
- Добавьте бота в Telegram-группу и MAX-группу
- В MAX сделайте бота админом группы
- В одном из чатов отправьте
/bridge - Бот выдаст ключ — отправьте
/bridge <ключ>в другом чате
Команды
| Команда | Описание |
|---|---|
/start, /help |
Инструкция |
/bridge |
Создать ключ для связки |
/bridge <ключ> |
Связать чат по ключу |
/bridge prefix on/off |
Включить/выключить префикс [TG]/[MAX] |
/unbridge |
Удалить связку |
Переменные окружения
| Переменная | Описание | По умолчанию |
|---|---|---|
TG_TOKEN |
Токен Telegram бота | — (обязательно) |
MAX_TOKEN |
Токен MAX бота | — (обязательно) |
DB_PATH |
Путь к SQLite базе | bridge.db |
DATABASE_URL |
DSN для PostgreSQL (если задана — SQLite игнорируется) | — |
TG_BOT_URL |
Ссылка на TG-бота (показывается в /help) |
https://t.me/MaxTelegramBridgeBot |
MAX_BOT_URL |
Ссылка на MAX-бота (показывается в /help) |
https://max.ru/id710708943262_bot |