Данные
Хранение файлов и данных
Куда приложение может писать, что сохраняется и что пропадает. SQLite, загруженные файлы и DATA_DIR.
Код приложения или бота во время работы доступен только для чтения. Писать можно в два места, и они ведут себя по-разному.
Что сохраняется
| Место | Сохраняется | Для чего |
|---|---|---|
/app/data |
Да — и после деплоя, и после перезапуска | Файл базы, загрузки, сессии |
/tmp |
Нет — очищается при каждом перезапуске и деплое, 128 МБ | Временные файлы |
Папка с кодом (/app) |
Писать нельзя | — |
/app/data — собственный диск проекта. Его путь лежит и в переменной DATA_DIR: лучше брать путь оттуда, чем зашивать в код.
Если в репозитории есть папка data, диск её перекрывает: файлы из неё запущенному приложению не видны.
У проектов с Dockerfile или готовым образом диск смонтирован в /data, DATA_DIR=/data.
SQLite сам попадает на диск
Файл SQLite, имя которого прямо написано в коде, сам связывается с диском. Например:
sqlite3.connect('bot.db')- SQLAlchemy:
sqlite:///app.db - better-sqlite3:
new Database('app.db')
Такой файл пишется в /app/data и после деплоя не пропадает. Если имя приходит из переменной или конфига, платформа его не видит — тогда берите путь из DATA_DIR.
Примеры
Python, sqlite3:
import os, sqlite3
db = sqlite3.connect(os.path.join(os.environ["DATA_DIR"], "bot.db"))
Бот на aiogram, пользователи в SQLite:
import os
import aiosqlite
DB = os.path.join(os.environ.get("DATA_DIR", "data"), "users.db")
async def save_user(user_id: int):
async with aiosqlite.connect(DB) as db:
await db.execute("CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY)")
await db.execute("INSERT OR IGNORE INTO users VALUES (?)", (user_id,))
await db.commit()
Node, better-sqlite3:
import path from 'node:path'
import Database from 'better-sqlite3'
const db = new Database(path.join(process.env.DATA_DIR ?? 'data', 'app.db'))
Prisma: добавьте в переменные проекта.
DATABASE_URL=file:/app/data/app.db
Папка для загрузок:
const uploads = path.join(process.env.DATA_DIR, 'uploads')
fs.mkdirSync(uploads, { recursive: true })
Для настоящих данных — база
Диск принадлежит одному приложению: другие сервисы его не видят, резервных копий с него не делается. Для небольшого бота или прототипа SQLite хватит. Если там клиенты, заказы, платежи — заведите базу PostgreSQL: у неё есть бэкапы и к ней подключаются несколько сервисов. Для множества картинок и больших файлов — хранилище S3.