self-hosted · open source

Telegram-боты там,
где Telegram заблокирован

Прозрачный прокси для Bot API и вебхуков. Разверните на зарубежном сервере, поменяйте один URL — и боты снова работают. Совместимо с любой библиотекой.

одно изменение — и всё работает
  const bot = new Bot(token, {-   client: { apiRoot: "https://api.telegram.org" },+   client: { apiRoot: "https://proxy.example.com" },  });

Как это работает

Две сквозные поверхности: приём вебхуков от Telegram и прозрачный исходящий Bot API.

Входящие вебхуки

Telegram
/webhook
Прокси
forward
Ваш бэкенд

Исходящий Bot API

Ваш бэкенд
/bot…
Прокси
proxy
api.telegram.org

Возможности

Прозрачный Bot API

Drop-in замена api.telegram.org: любой метод и content-type, включая multipart-загрузку и скачивание файлов.

Входящие вебхуки

Принимаем апдейты от Telegram и пересылаем на ваш бэкенд, пробрасывая заголовок secret_token.

Повторные доставки

Если бэкенд не ответил 2xx — до 3 повторов с экспоненциальной паузой. Каждая попытка попадает в журнал.

Защита от open-relay

Проксируются только токены ботов, зарегистрированных в админке. Проверка кэшируется в Redis.

Веб-админка

Регистрация ботов, переустановка вебхука, живой getWebhookInfo и журнал доставок с навигацией.

Swagger / OpenAPI

Документированный админ-API с авторизацией по JWT — пробуйте методы прямо из браузера.

Self-hosted

Один docker compose up: Postgres, Redis, backend и фронтенд за nginx с TLS.

Современный стек

NestJS 11 + Prisma 7 + Next.js 15 на рантайме Bun. Типобезопасно, без лишних зависимостей.

Журнал доставок

Каждая пересылка вебхука пишется в БД: статус, длительность, номер попытки и текст ошибки.

Готовы подключить своего бота?

Поднимите прокси на своём сервере и следуйте пошаговому гайду с примерами на Python, TypeScript и JavaScript.