Спящий режим и экономия памяти

Бот, которому долго никто не пишет, платформа усыпляет: его контейнер останавливается, а на первом же сообщении запускается снова. Спящий бот почти не тратит память и процессор сервера — именно это позволяет держать пробный тариф бесплатным. На табло такой бот показан со статусом «Спит» и подписью «проснётся на первом сообщении».

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

  1. Простой. Раз в 30 секунд платформа смотрит на сетевой трафик контейнера и его нагрузку на процессор. Бот на long polling без сообщений делает примерно один запрос к Telegram в 25–50 секунд — это меньше 3 КБ в минуту. Если за интервал сна (на пробном тарифе — 30 минут) трафика меньше порога и процессор почти не занят, бот считается простаивающим.
  2. Засыпание. Контейнер останавливается штатно (docker stop, 10 секунд на завершение). В журнале бота появляется строка [AutoHoster] Бот уснул: нет сообщений 30 минут. Проснётся на первом сообщении. Данные в /app/data и переменные никуда не деваются.
  3. Ожидание. Пока бот спит, платформа сама слушает Telegram от его имени — вызывает getUpdates без подтверждения. Ничего не читается и не теряется: Telegram хранит необработанные сообщения до 24 часов и отдаст их боту, когда тот запустится.
  4. Пробуждение. Первое входящее сообщение запускает контейнер. Пользователь в Telegram заметит задержку, равную времени старта бота — обычно 2–5 секунд. В журнале: [AutoHoster] Бот проснулся: пришло сообщение. Разбудить бота можно и вручную — кнопкой «Разбудить» на странице бота, а также «Запустить», «Перезапустить», новым деплоем или «Применить настройки».
  5. Снова уснуть бот сможет не раньше, чем пройдёт полный интервал сна после пробуждения.

Если боту двое суток никто не пишет

Бот, которому 2 дня подряд никто не написал, засыпает на любом тарифе — даже если на платном тарифе сон выключен. Отсчёт идёт от последнего входящего сообщения, а если сообщений не было — от последнего запуска (деплой, «Перезапустить», «Применить настройки» начинают отсчёт заново). В журнале появится строка [AutoHoster] Бот уснул: 2 дня никто не писал. Проснётся на первом сообщении. Дальше всё как обычно: первое сообщение будит бота за 2–5 секунд, ничего не теряется.

Боты с задачами по расписанию так не засыпают никогда (см. ниже). Боты администраторов платформы тоже не засыпают ни по тишине, ни по таймеру сна.

Чем это грозит и кому не подходит

Сон безопасен для ботов, которые только отвечают на сообщения: они и так ждут событий от Telegram. Проблемы возможны у ботов, которые делают что-то сами по расписанию — рассылки, напоминания, парсинг по таймеру, cron-задачи. Пока такой бот спит, его таймеры не тикают.

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

  • в команде запуска есть cron, schedule или apscheduler;
  • при сборке в коде из репозитория найдены apscheduler, schedule, aiocron, job_queue / run_repeating / run_daily (python-telegram-bot), node-cron, node-schedule, setInterval или долгие паузы в цикле (asyncio.sleep(3600));
  • у бота из ИИ-конструктора есть периодические задачи (напоминания, рассылки).

Если платформа всё же не распознала расписание, отключите сон сами переменной AUTOHOSTER_NO_SLEEP=1 (см. ниже).

Второй случай — боты на вебхуках, а не на long polling. Платформа усыпляет по трафику, и вебхук-бот без сообщений тоже выглядит простаивающим; при этом ждать за него сообщения через getUpdates нельзя (Telegram не отдаёт апдейты, пока установлен вебхук). Такого бота платформа запускает снова сразу, как только увидит вебхук, — в журнале появится строка «Бот работает через вебхук…». Чтобы он не засыпал вовсе, добавьте AUTOHOSTER_NO_SLEEP=1.

Как отключить сон

  • На платных тарифах сон выключен по умолчанию. Включается на странице бота, в карточке «Спящий режим»: переключатель и интервал — 15, 30, 60 или 180 минут без сообщений. С выключенным сном бот работает, пока ему пишут, и засыпает, только если 2 дня никто не написал.
  • На пробном тарифе сон обязателен (30 минут), переключателя нет. Единственный способ его обойти — добавить боту переменную окружения AUTOHOSTER_NO_SLEEP=1 (вкладка «Переменные», затем «Применить настройки»). Так честно: бот с расписанием будет работать непрерывно, но пробный период всё равно закончится через 7 дней — дальше нужен тариф.
  • Та же переменная работает и на платных тарифах, если нужно гарантировать, что бот не уснёт, независимо от настроек в панели.

Почему сон отключён у конкретного бота, видно в поле blocked_reason карточки и в журнале бота ([AutoHoster] Сон отключён: …).

Экономия памяти

Помимо сна каждый контейнер запускается в экономном режиме — без изменений в коде бота:

  • переменные окружения по умолчанию: MALLOC_ARENA_MAX=2 (меньше арен аллокатора — заметно меньше RSS у Python и Node), PYTHONDONTWRITEBYTECODE=1, PYTHONUNBUFFERED=1, PYTHONHASHSEED=0, NODE_OPTIONS=--max-old-space-size=… (лимит кучи V8 — 60 % от памяти тарифа), UV_THREADPOOL_SIZE=2. Любую из них можно переопределить своей переменной с тем же именем;
  • образы собираются в два этапа: зависимости ставятся в отдельной стадии, в финальный образ попадают только они и исходники. Для Python компилятор добавляется, только если в requirements.txt есть пакеты с C-расширениями (pandas, numpy, lxml, psycopg2, cryptography, pillow); Node ставит зависимости через npm ci --omit=dev. Если в репозитории нет .dockerignore, добавляется стандартный (.git, *.md, tests/, __pycache__, .venv, node_modules);
  • в лог сборки пишется размер образа и строка «Экономный режим: …» — так видно, что включено.

На странице бота рядом с часовым графиком есть график «Память за 14 дней» (p50/p95/max по дням): по нему видно, сколько памяти бот занимает на самом деле и сколько экономит сон (у спящего бота память и CPU на графике равны нулю).

Частые вопросы

Бот уснул, а сообщение не дошло. Проверьте журнал: после Бот уснул должна быть строка Бот проснулся. Если её нет, а бот на вебхуках — отключите сон (AUTOHOSTER_NO_SLEEP=1). Если в журнале есть 409 от Telegram, этот же токен используется где-то ещё — см. «Типовые ошибки».

Телеграм отклонил токен (401). Токен отозван в @BotFather, пока бот спал. Бот остановлен; вставьте новый токен в параметрах и нажмите «Применить настройки».

Можно ли выключить сон совсем на пробном тарифе? Только переменной AUTOHOSTER_NO_SLEEP=1. На платных тарифах сон управляется из панели.

Почему бот уснул, хотя сон выключен? Ему 2 дня никто не писал — такой бот засыпает на любом тарифе, а проснётся на первом же сообщении. Если боту нужно работать без сообщений (напоминания, рассылки), а платформа этого не распознала, добавьте AUTOHOSTER_NO_SLEEP=1.