Переменные окружения и данные
Всё, что бот должен знать (ключи, 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. Восстановить данные после этого нельзя — сначала скачайте архив.