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