Supabase Self-Hosted: поднимаем свой Backend-as-a-Service

Все возможности Firebase — но на своём железе и с PostgreSQL под капотом.

Что такое Supabase?

Supabase — это open-source альтернатива Firebase, построенная поверх PostgreSQL. Из коробки даёт:

• PostgreSQL — полноценная реляционная база данных
• Auth — аутентификация через email, OAuth (GitHub, Google, Discord и др.)
• Storage — S3-совместимое хранилище файлов с политиками доступа
• Realtime — подписки на изменения в БД через WebSocket
• Edge Functions — серверные функции на Deno
• Studio — веб-панель для управления всем этим

Облачный Supabase бесплатен для небольших проектов, но имеет лимиты. Self-hosted версия снимает все ограничения.

Supabase vs чистый PostgreSQL vs другие

Прежде чем разворачивать Supabase — стоит понять, чем он отличается от голого PostgreSQL и других решений.

Supabase vs PostgreSQL

Когда хватит чистого PostgreSQL:

• Уже есть бэкенд на Express/FastAPI/Django
• Не нужна встроенная аутентификация — используешь свою или внешнюю
• Важна минимальная нагрузка на сервер
• Нужен максимальный контроль над каждым компонентом

Когда стоит взять Supabase:

• Хочешь быстро получить API без написания бэкенда
• Нужны Auth, Storage и Realtime из коробки
• Пишешь фронтенд-first приложение (Next.js, Nuxt, SvelteKit)
• Не хочешь склеивать 5 разных инструментов вручную

Supabase vs Firebase

Supabase vs Appwrite

Итог сравнения

• Чистый PostgreSQL — если уже есть бэкенд и нужна только база
• Firebase — если устраивает NoSQL, vendor lock-in и Google Cloud
• Appwrite — если не нужен прямой SQL и нравится их SDK-подход
• Supabase — если хочешь полноценный PostgreSQL с батарейками в комплекте

А что насчёт S3, Redis и MongoDB?

Supabase часто воспринимают как «замену всему», но это не совсем так.

S3 / файловое хранилище — да, частично заменяет. Supabase Storage предоставляет S3-совместимый API для хранения файлов (аватарки, документы, изображения). Под капотом можно использовать локальное хранилище, MinIO или настоящий AWS S3 / Cloudflare R2 как бэкенд. Но это именно файловое хранилище с RLS-политиками, а не полноценный object storage для терабайтов данных — для такого масштаба лучше напрямую MinIO или S3.

Redis — нет, не заменяет. Redis — это in-memory хранилище совсем другого класса:

Если нужен кэш, очереди или rate limiting — Redis по-прежнему нужен отдельно.

MongoDB — частично заменяет, зависит от задачи:

Если используешь MongoDB только для хранения JSON — PostgreSQL с jsonb это покроет, причём с бонусом в виде транзакций, JOIN-ов и строгой типизации там, где она нужна. Но если нужен горизонтальный шардинг на десятки серверов — PostgreSQL так не умеет без расширений.

Зачем хостить самому?

• Без лимитов — никаких ограничений на количество строк, запросов или файлов
• Контроль данных — всё хранится на твоём сервере
• Кастомизация — свои расширения PostgreSQL, настройки Auth, кастомные SMTP
• Стоимость — VPS за $5–10/мес вместо платных планов Supabase

Требования

Также понадобятся:

• VPS с Linux (Ubuntu 22.04+ / Debian 12+)
• Docker и Docker Compose v2
• Домен с DNS A-записью на IP сервера (для production)
• NGINX или Caddy для HTTPS (рекомендуется для OAuth)

Если не нужны все сервисы, можно отключить Logflare, Realtime, Storage, imgproxy или Edge Runtime — это снизит потребление ресурсов.

Установка Docker

Если Docker ещё не установлен:

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

Перелогинься, чтобы применить группу:

newgrp docker

Подготовка проекта

Клонируем репозиторий Supabase и копируем Docker-окружение в отдельную директорию:

git clone --depth 1 https://github.com/supabase/supabase
 
# Копируем только Docker-файлы в свой проект
mkdir supabase-project
cp -rf supabase/docker/* supabase-project
cp supabase/docker/.env.example supabase-project/.env
cd supabase-project
 
# Подтягиваем образы
docker compose pull

Если хочешь минимизировать объём загрузки, можно использовать sparse checkout:

git clone --filter=blob:none --no-checkout https://github.com/supabase/supabase
cd supabase
git sparse-checkout set --cone docker && git checkout master
cd ..
mkdir supabase-project
cp -rf supabase/docker/* supabase-project
cp supabase/docker/.env.example supabase-project/.env
cd supabase-project
docker compose pull

Генерация секретов

Важно: Никогда не запускай Supabase с дефолтными ключами из .env.example. Все секреты нужно заменить до первого запуска.

В репозитории есть готовый скрипт для генерации ключей:

sh ./utils/generate-keys.sh

Скрипт сгенерирует JWT_SECRET, ANON_KEY и SERVICE_ROLE_KEY и покажет их в выводе. Проверь результат и убедись, что .env обновлён.

Что генерируется

• JWT_SECRET — секрет для подписи и проверки JWT-токенов. Используется в Auth, PostgREST и других сервисах
• ANON_KEY — публичный ключ с ролью anon. Безопасен для клиентского кода (ограниченные RLS-права)
• SERVICE_ROLE_KEY — серверный ключ с ролью service_role. Полный доступ к БД — никогда не используй во фронтенде

Дополнительные секреты

Помимо JWT-ключей, нужно сгенерировать ещё несколько секретов:

Настройка .env

Открываем .env и заполняем основные параметры:

############
# Secrets — обязательно замени все значения!
############
POSTGRES_PASSWORD=your-super-secret-password   # Только буквы и цифры (без спецсимволов)
JWT_SECRET=your-jwt-secret-here
ANON_KEY=your-anon-key
SERVICE_ROLE_KEY=your-service-role-key
 
############
# Dashboard
############
DASHBOARD_USERNAME=admin
DASHBOARD_PASSWORD=your-dashboard-password     # Должен содержать хотя бы одну букву
 
############
# URLs
############
SUPABASE_PUBLIC_URL=https://supabase.your-domain.com  # Базовый URL для доступа
API_EXTERNAL_URL=https://supabase.your-domain.com     # Внешний URL Auth
SITE_URL=https://your-domain.com                       # URL приложения (редирект после OAuth)
 
############
# SMTP (опционально, для отправки email)
############
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your-email@gmail.com
SMTP_PASS=your-app-password
SMTP_SENDER_NAME=Your App
SMTP_ADMIN_EMAIL=your-email@gmail.com

Про POSTGRES_PASSWORD: используй только буквы и цифры — спецсимволы могут вызвать проблемы с URL-кодированием в connection string.

Запуск

docker compose up -d

Проверяем, что всё поднялось:

docker compose ps

Все сервисы должны перейти в состояние Up (healthy) в течение минуты. Если что-то не запустилось — смотрим логи:

docker compose logs <service-name>

Открытые порты

Остальные сервисы работают внутри Docker-сети и не имеют внешних портов.

Доступ к Studio

Studio доступна через Kong API Gateway на порту 8000:

• Локально: http://localhost:8000
• На VPS: http://<your-ip>:8000
• С доменом: https://supabase.your-domain.com (через reverse proxy)

Логин и пароль — из DASHBOARD_USERNAME и DASHBOARD_PASSWORD.

Настройка NGINX reverse proxy

Для production рекомендуется HTTPS — он обязателен для OAuth-провайдеров.

# /etc/nginx/sites-available/supabase
server {
    listen 80;
    server_name supabase.your-domain.com;
    return 301 https://$host$request_uri;
}
 
server {
    listen 443 ssl http2;
    server_name supabase.your-domain.com;
 
    ssl_certificate /etc/letsencrypt/live/supabase.your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/supabase.your-domain.com/privkey.pem;
 
    # Все API и Dashboard проксируются через Kong
    location / {
        proxy_pass http://localhost:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
 
    # Realtime (WebSocket)
    location /realtime/ {
        proxy_pass http://localhost:8000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}

Активируем и получаем SSL-сертификат:

sudo ln -s /etc/nginx/sites-available/supabase /etc/nginx/sites-enabled/
sudo certbot --nginx -d supabase.your-domain.com
sudo nginx -t && sudo systemctl reload nginx

Edge Functions

Edge Functions хранятся в volumes/functions. По умолчанию доступна функция hello:

https://supabase.your-domain.com/functions/v1/hello

Для добавления своей функции создай файл volumes/functions/<name>/index.ts и перезапусти сервис:

docker compose restart functions --no-deps

Подключение из приложения

Устанавливаем клиент:

npm install @supabase/supabase-js

Подключаемся к self-hosted инстансу:

import { createClient } from "@supabase/supabase-js";
 
const supabase = createClient(
  "https://supabase.your-domain.com",
  "your-anon-key"
);
 
// Пример: получить данные из таблицы
const { data, error } = await supabase
  .from("posts")
  .select("*");

Всё работает точно так же, как с облачным Supabase — те же SDK, те же методы.

Подключение к PostgreSQL напрямую

Через Supavisor (рекомендуется):

# Session mode
psql 'postgres://postgres.your-tenant-id:PASSWORD@supabase.your-domain.com:5432/postgres'
 
# Transaction pooling
psql 'postgres://postgres.your-tenant-id:PASSWORD@supabase.your-domain.com:6543/postgres'

Обновление

Стабильные релизы выходят примерно раз в месяц. Для обновления:

1. Проверь changelog и новые версии на Docker Hub
2. Обнови теги образов в docker-compose.yml (формат: supabase/service:YYYY.MM.DD-sha-hash)
3. Применяем:

docker compose pull
docker compose down && docker compose up -d

Внимание: Обновление вызывает даунтайм приложения. Перед обновлением обязательно сделай бэкап.

Бэкапы

Ручной бэкап

docker exec supabase-db pg_dump -U postgres | gzip > backup_$(date +%Y%m%d).sql.gz

Автоматический бэкап через cron

crontab -e
 
# Бэкап каждый день в 3:00
0 3 * * * docker exec supabase-db pg_dump -U postgres | gzip > /backups/supabase_$(date +\%Y\%m\%d).sql.gz

Не забудь создать директорию /backups и настроить ротацию старых файлов.

Смена пароля PostgreSQL

Если нужно изменить пароль базы данных:

sh ./utils/db-passwd.sh

Скрипт сгенерирует новый пароль, обновит роли в БД и .env. После этого перезапусти сервисы:

docker compose up -d --force-recreate

Возможные проблемы

Контейнер auth постоянно перезапускается

docker compose logs auth

Чаще всего причина — неправильный JWT_SECRET или отсутствие SMTP-настроек.

Studio не открывается

Убедись, что Kong-контейнер запущен и порт 8000 доступен:

docker compose ps kong
docker compose logs kong

Ошибки CORS

Добавь свой домен в SITE_URL и ADDITIONAL_REDIRECT_URLS в .env.

Rootless Docker

Если используешь rootless Docker, укажи путь к сокету в .env:

DOCKER_SOCKET_LOCATION=/run/user/1000/docker.sock

Безопасность

• Не коммить .env в репозиторий — добавь его в .gitignore
• Для production используй менеджеры секретов (Doppler, Infisical, HashiCorp Vault, AWS Secrets Manager)
• Обязательно настрой HTTPS — без него OAuth-провайдеры не работают
• Ограничь доступ к PostgreSQL через файрвол, если открываешь порты наружу
• Включи MFA для OAuth-провайдеров где возможно

Удаление

Если нужно полностью удалить Supabase:

# Остановить и удалить контейнеры + volumes
docker compose down -v
 
# Удалить данные (необратимо!)
rm -rf volumes/db/data
rm -rf volumes/storage

Итого

Self-hosted Supabase — это полноценный BaaS на своём сервере:

• PostgreSQL с realtime-подписками и connection pooling через Supavisor
• Аутентификация с OAuth-провайдерами
• S3-совместимое хранилище файлов с RLS-политиками
• Edge Functions на Deno
• Веб-панель Studio для управления

Всё это бесплатно, без лимитов и с полным контролем над данными. Для pet-проектов и средних приложений — отличная альтернатива облаку.

Если что-то не работает — пиши в комментариях, разберёмся вместе.