Типовые ошибки

Почти всегда ответ есть в логе: лог сборки — во вкладке «Сборки», журнал бота — во вкладке «Логи». Строка с ✗ в конце лога сборки говорит, на чём она остановилась.

ModuleNotFoundError: No module named '…'

Бот импортирует библиотеку, которой нет в requirements.txt (или в pyproject.toml). В контейнер устанавливается только то, что там перечислено. Добавьте пакет, закоммитьте и запустите сборку заново. Для Node.js то же самое с package.json (Cannot find module): зависимость должна быть в dependencies, а не только в devDependencies — установка идёт с --omit=dev.

Conflict: terminated by other getUpdates request

Этот же токен используется где-то ещё: бот запущен локально, на другом хостинге или в двух ботах AutoHoster одновременно. Telegram отдаёт обновления только одному процессу. Остановите второй экземпляр. Если непонятно, где он запущен, — отзовите токен в @BotFather (/revoke), вставьте новый в параметрах бота и нажмите «Применить настройки».

Бот «Остановлен» или «Ошибка» сразу после сборки

Образ собрался, но процесс завершился в первые секунды. Платформа ждёт 4 секунды, и если контейнер не работает, помечает сборку ошибкой «Бот не запустился» и дописывает последние строки журнала бота в лог сборки. Типичные причины:

  • не хватает переменной окружения (KeyError: 'ADMIN_ID') — добавьте её в «Настройках» и нажмите «Применить настройки»;
  • неверный токен в коде вместо переменной TELEGRAM_BOT_TOKEN;
  • бот запускается в режиме webhook (см. ниже);
  • скрипт выполняет работу и выходит — бот должен работать бесконечно (polling), а не завершаться.

Если на табло «Перезапуск» — процесс падает циклически; причина та же, смотрите журнал.

Нехватка памяти (OOM)

Контейнер получает столько памяти, сколько даёт тариф (128 МБ на «Пробном»). Если бот превышает лимит, система его завершает — в журнале обрыв без traceback, бот уходит в «Перезапуск». Что делать: не загружать большие файлы целиком в память, не держать тяжёлые библиотеки (например, pandas/torch) ради простой задачи, или перейти на тариф с большей памятью. Графики памяти — на странице бота.

Приватный репозиторий: Repository not found / 404

Для приватного репозитория платформе нужен токен GitHub: fine-grained token с правом *Contents: Read-only* на этот репозиторий. Укажите его в параметрах бота. Проверьте также, что ветка существует: клонируется именно та ветка, что указана в параметрах (git clone: ... Remote branch … not found).

Неверный токен

«Telegram отклонил токен» — проверьте, что скопировали всю строку 123456789:AAH... без пробелов, и что токен не отозван в @BotFather. «Telegram недоступен, попробуйте позже» — временная сетевая ошибка, повторите через минуту.

Polling vs webhook

Контейнеры AutoHoster не принимают входящих соединений, поэтому режим webhook (setWebhook, run_webhook, app.run_webhook) не работает. Бот должен использовать long polling: getUpdates, в библиотеках — run_polling(), executor.start_polling(), bot.polling(), dp.start_polling().

Если раньше для этого токена был установлен webhook, polling отвечает ошибкой Conflict: can't use getUpdates method while webhook is active. Снимите его один раз: откройте в браузере https://api.telegram.org/bot<ТОКЕН>/deleteWebhook или вызовите delete_webhook() при старте бота.

Бот молчит, в журнале Connection to api.telegram.org timed out

Варианты той же ошибки: ConnectTimeoutError, Read timed out, ETIMEDOUT, ServerDisconnectedError при запросе к api.telegram.org. Контейнер работает, а ответов нет.

Причина: серверы AutoHoster в России не достают до api.telegram.org напрямую — соединение висит до таймаута. Поэтому платформа ходит в Telegram через свой релей и передаёт его адрес боту в переменной TELEGRAM_API_BASE. Если бот работает на сервере за рубежом, переменная пустая, и подключаться нужно напрямую.

Ботам на Python (aiogram, pyTelegramBotAPI, python-telegram-bot) платформа подставляет релей сама — после новой сборки, если бот не указал свой адрес API. Если ошибка осталась или бот написан на Node.js или ходит в Bot API своими запросами, прочитайте переменную в коде.

Правило одно: адрес API = TELEGRAM_API_BASE, а если она пустая — https://api.telegram.org.

pyTelegramBotAPI (telebot) — до создания TeleBot:

import os
from telebot import apihelper

base = os.environ.get("TELEGRAM_API_BASE", "").rstrip("/")
if base:
    apihelper.API_URL = base + "/bot{0}/{1}"
    apihelper.FILE_URL = base + "/file/bot{0}/{1}"

aiogram 3:

from aiogram.client.session.aiohttp import AiohttpSession
from aiogram.client.telegram import TelegramAPIServer

base = os.environ.get("TELEGRAM_API_BASE", "").rstrip("/")
session = AiohttpSession(api=TelegramAPIServer.from_base(base)) if base else None
bot = Bot(token, session=session)

python-telegram-bot 20+:

base = os.environ.get("TELEGRAM_API_BASE", "").rstrip("/") or "https://api.telegram.org"
app = ApplicationBuilder().token(token).base_url(base + "/bot").base_file_url(base + "/file/bot").build()

Node.js: Telegraf — new Telegraf(token, { telegram: { apiRoot: process.env.TELEGRAM_API_BASE || "https://api.telegram.org" } }); node-telegram-bot-api — опция baseApiUrl с тем же значением.

Свои запросы к Bot API (requests, httpx, fetch) собирайте от той же базы: f"{base}/bot{token}/sendMessage". Не прописывайте api.telegram.org в коде, не ставьте прокси и не закрепляйте IP Telegram в hosts. После правки закоммитьте и запустите сборку заново.

«Не удалось определить точку входа»

Платформа ищет bot/__main__.py, app/__main__.py, затем main.py, bot.py, app.py, run.py в корне. Если файл называется иначе или лежит в подпапке — укажите команду запуска в параметрах бота (например, python src/main.py) или добавьте Dockerfile.

«Не найден ни Dockerfile, ни requirements.txt/pyproject.toml, ни package.json»

В корне репозитория нет файла, по которому можно понять язык. Добавьте requirements.txt (Python) или package.json (Node.js), либо свой Dockerfile.

Сборка идёт слишком долго или прервана

На сборку отводится 15 минут и 1 ГБ памяти. Чаще всего время уходит на установку тяжёлых зависимостей — уберите лишнее из requirements.txt. Параллельно на сервере собирается не больше двух ботов, так что сборка может немного подождать в очереди.

«Аккаунт ожидает подтверждения администратором»

На платформе включена модерация новых аккаунтов: добавить бота можно, но сборка и запуск заработают после одобрения. Напишите в поддержку, если ждёте долго.

Ничего не помогло

Напишите в поддержку через чат-ассистента (кнопка «Передать человеку») или создайте обращение в разделе «Поддержка» кабинета. Приложите название бота и последние строки лога — так ответ будет быстрее.