Переменные окружения и данные

Всё, что бот должен знать (ключи, ID администраторов, настройки), передаётся через переменные окружения. Всё, что бот должен сохранять, живёт в папке /app/data.

Переменные и секреты

Во вкладке «Настройки» бота — таблица переменных окружения.

  • Имя переменной — латиница, цифры и подчёркивание (ADMIN_ID, OPENAI_API_KEY). Значение — до 8 КБ.
  • Отметьте переменную как секрет, и её значение больше не будет показываться в панели — только заменяться. Если при сохранении оставить значение секрета пустым, останется прежнее.
  • Можно вставить содержимое .env целиком — строки разберутся по ключам.
  • Все значения хранятся зашифрованными.
  • Переменную с именем токена Telegram (TELEGRAM_BOT_TOKEN по умолчанию) добавить нельзя: она задаётся полем токена в параметрах бота.

Как применить изменения

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

Папка /app/data

Всё, что бот должен сохранять между перезапусками (SQLite, JSON, загруженные фото), пишите в /app/data. Эта папка — постоянный том: она переживает обновления, откаты и «Применить настройки». Остальная файловая система контейнера сбрасывается при каждой сборке.

Папка создаётся автоматически при сборке по шаблону платформы. Если вы используете свой Dockerfile, пишите в тот же путь /app/data.

Файлы: посмотреть, загрузить, скачать

Во вкладке «Файлы» на странице бота:

  • Список файлов в /app/data с размерами и датой изменения.
  • Загрузка файла (например, начальной базы) — до 20 МБ за раз. Файл с тем же именем заменяется.
  • Скачать всё архивом — .tar со всем содержимым /app/data.

Резервная копия (бэкап)

Скачанный архив /app/data и есть резервная копия: сделайте её перед рискованными обновлениями и перед удалением бота. Чтобы восстановить данные, загрузите файлы из архива обратно во вкладке «Файлы» (по одному, до 20 МБ каждый) и нажмите «Применить настройки», чтобы бот перечитал их. Автоматических бэкапов на стороне платформы нет.

Файлы доступны только после первой сборки: пока контейнера нет, панель покажет «Бот ещё не задеплоен». Объём папки ограничен тарифом (см. раздел «Тарифы и оплата»): если места не хватает, загрузка отклоняется с подсказкой, сколько свободно.

Что удаляется вместе с ботом

При удалении бота удаляются его контейнер, образы и том с /app/data. Восстановить данные после этого нельзя — сначала скачайте архив.