Supabase
Бэкенд для приложений, который ставится на свой сервер: PostgreSQL, готовые API, авторизация, файлы и события в реальном времени. Развернули self-hosted 0.8.2 на Fatmetal Cloud Server, замерили ресурсы и проверили разделение данных двух пользователей.
Вердикт
- Разработчику личного кабинета: нужны вход по паролю, SQL и отдельные записи каждого клиента.
- Команде, которая хочет обращаться к PostgreSQL из приложения через готовый API.
- Автору сайта, который ожидает получить готовые страницы и пользовательский интерфейс.
- Разработчику, который считает вход по паролю достаточной защитой строк базы.
Что такое Supabase и зачем он приложению
Supabase дает приложению серверную часть. Вы создаете таблицу в PostgreSQL, получаете HTTP API для ее чтения и добавляете вход пользователей через Auth.
Это BaaS: backend as a service, набор готовых серверных возможностей. В собственной установке сервисы работают на вашей VM, а код сайта или мобильного приложения остается отдельным.
Пример из разбора - личные заметки. Алиса и Боб входят с разными учетными записями, добавляют записи в одну таблицу и получают через API только свои строки.
За это отвечает RLS, Row Level Security: PostgreSQL проверяет разрешение для каждой строки. Auth устанавливает личность пользователя, а политика RLS определяет, какие данные ему доступны.
Такой подход убирает часть однотипных обработчиков из вашего сервера. Вместо собственного маршрута «показать мои заметки» можно обратиться к таблице через PostgREST и доверить фильтрацию базе.
Что изменилось после августовской статьи
В августовской установке API принимал Kong, база работала на PostgreSQL 17.6. Теперь проверен отдельный тег self-hosted/v0.8.2 с согласованными версиями сервисов.
| Часть установки | Август | Сборка 0.8.2 |
|---|---|---|
| Шлюз API | Kong | Envoy 1.39.1 |
| Авторизация | Auth 2.189.0 | Auth 2.196.0, новые ключи |
| Файлы | Storage 1.60.4 | Storage 1.74.0 |
| База | PostgreSQL 17.6 | Образ postgres:17.6.1.136 |
Поменялась настройка ключей: официальный помощник добавляет publishable и secret API keys и асимметричные ключи подписи. На стенде токены пользователей подписывались алгоритмом ES256.
У новой сборки обнаружилась зависимость запуска функций от доступности JSR. Ниже она устранена локальными зависимостями: проверка токена остается включенной, пример hello отвечает через публичный HTTPS.
Чем собственная установка отличается от облака и Firebase
Supabase называют аналогом Firebase, потому что оба дают приложению авторизацию, данные и файлы. Но Supabase строится вокруг SQL и PostgreSQL, а Firestore хранит документы.
| Вариант | Цена | Что оплачивается |
|---|---|---|
| Supabase Cloud Free | $0 | Два активных проекта; неактивный проект приостанавливается после недели |
| Supabase Cloud Pro | От $25/мес. | Управляемое облако; $10 compute credits входят в план |
| Firebase Spark | $0 в пределах квот | Бесплатные квоты сервисов |
| Firebase Blaze | По потреблению | Использование сервисов через Cloud Billing |
| Supabase на VPS | 1100 ₽/мес. за стенд | CPU4-RAM8-DISK100; копии и работа администратора отдельно |
Это разные покупки: облачный план продает обслуживание, собственная VM дает контроль над сервером. Сравнивать один VPS с полной облачной подпиской только по цене некорректно.
Для платного Supabase Cloud нужна кредитная карта. Новые регистрации Google Cloud для пользователей в России приостановлены; это существенно для подключения Firebase Blaze к новому billing-аккаунту.
Источники цен и условий: Supabase, Firebase, Google Cloud Billing. VPS Fatmetal оплачивается в рублях.
Как устроен локальный бэкенд
Envoy принимает внешние запросы и отправляет их нужному сервису. Studio показывает таблицы, Auth выдает токены, PostgREST превращает SQL-таблицы в HTTP API, Storage принимает файлы.
Все сервисы обращаются к одной базе PostgreSQL. Supavisor обслуживает подключения SQL-клиентов, а Edge Runtime выполняет функции. В проверенном Compose работают 11 контейнеров.
Клиенту приложения нужен публичный адрес API и publishable key. Secret key и service_role дают повышенные права; храните их на сервере приложения, не в браузерном коде.
Вход в Studio защищен отдельно: имя и пароль находятся в DASHBOARD_USERNAME и DASHBOARD_PASSWORD файла .env. Это доступ администратора к инструментам базы, а не учетная запись клиента приложения.
Realtime передает события между подключенными клиентами: на стенде два WebSocket-клиента обменялись broadcast-сообщением. База, файлы и функции оставались в той же локальной установке.
Какую конфигурацию выбрать
Для инструкции возьмите чистую Ubuntu 24.04 и CPU4-RAM8-DISK100. Вендор указывает минимум 2 CPU, 4 ГБ RAM и 40 ГБ диска; рекомендация здесь основана на нагрузке стенда.
| Стенд | 4 vCPU, 8 ГБ RAM, 100 ГБ диска |
| ОС | Ubuntu 24.04.4 LTS |
| Инструменты | Docker 29.8.2, Compose 5.6.0, Caddy 2.11.7 |
| Процессы контейнеров в простое | 850 МиБ RAM |
| Наблюдаемый пик процессов контейнеров | 984 МиБ RAM |
| Вся VM: память в простое | 1,7 ГиБ RAM |
| Вся VM: наблюдаемый пик памяти | 1,9 ГиБ RAM |
| Образы работающих сервисов | 8,5 ГиБ |
| Занято на системном диске | 11,1 ГиБ |
850 МиБ - память процессов контейнеров, а не расход всей VM. Для выбора сервера учитывайте ОС и службы: вместе они использовали до 1,9 ГиБ.
При открытии SQL Editor нагрузка кратковременно достигла 2,33 ядра. Поэтому выбран тариф с четырьмя vCPU; 8 ГБ памяти оставляют запас для базы и файлового кеша.
Первыми обычно растут данные, а не число контейнеров. Тысяча заметок добавила таблице около 1 МиБ, тогда как один CSV занял почти 20 МиБ файлового хранилища.
Если приложение принимает 200 таких CSV в сутки, за 30 дней накопится 116,6 ГиБ. Это расчет по размеру проверенного файла: диск этого тарифа закончится, потребуется расширение или отдельное хранилище.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.
Рекомендуемая конфигурация:
4 vCPU · 8 ГБ RAM · 100 ГБ NVMe от 990 ₽/мес
Развертывание на Fatmetal Cloud Server
Понадобятся SSH, права root и домен. На чистой машине подготовка и запуск контейнеров заняли 15 минут. Команды ниже рассчитаны на новую машину: повторная генерация ключей в установленном проекте нарушит доступ клиентов и сохраненные секреты.
Установите Docker и Caddy
Выполняйте команды от root: сначала войдите по SSH и запустите sudo -i. Caddy выдаст HTTPS-сертификат.
sed -i 's|http://security.ubuntu.com|https://security.ubuntu.com|g' /etc/apt/sources.list.d/ubuntu.sources apt-get update && apt-get install -y git curl ca-certificates openssl gnupg curl -fsSL https://get.docker.com -o /tmp/get-docker.sh sh /tmp/get-docker.sh curl -fsSL https://dl.cloudsmith.io/public/caddy/stable/gpg.key | gpg --batch --yes --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg curl -fsSL https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt -o /etc/apt/sources.list.d/caddy-stable.list apt-get update && apt-get install -y caddyЗакрепите сборку 0.8.2
Тег фиксирует совместимый набор компонентов. Рабочие файлы будут лежать в /opt/supabase.
git clone --depth 1 --branch self-hosted/v0.8.2 --filter=blob:none --sparse https://github.com/supabase/supabase.git /opt/supabase-source git -C /opt/supabase-source sparse-checkout set docker cp -a /opt/supabase-source/docker /opt/supabase cd /opt/supabaseСоздайте собственные ключи
Официальные помощники заменят демонстрационные секреты. Их запускают только при первой установке.
umask 077 cp .env.example .env sed -i 's/node:22-alpine/node:22.19.0-alpine3.22/g' utils/add-new-auth-keys.sh sh utils/generate-keys.sh --update-env >/dev/null sh utils/add-new-auth-keys.sh --update-env >/dev/null rm -f .env.oldЗадайте адрес и безопасные значения
Замените ваш-домен на домен сервера. Для регистрации по почте потребуется SMTP; ключ ИИ-провайдера пока пуст.
sed -i -e 's|^COMPOSE_FILE=.*|COMPOSE_FILE=docker-compose.yml:docker-compose.override.yml|' \ -e 's|^API_GW_HTTP_PORT=.*|API_GW_HTTP_PORT=127.0.0.1:8000|' \ -e 's|^SITE_URL=.*|SITE_URL=https://ваш-домен|' -e 's|^SUPABASE_PUBLIC_URL=.*|SUPABASE_PUBLIC_URL=https://ваш-домен|' \ -e 's|^API_EXTERNAL_URL=.*|API_EXTERNAL_URL=https://ваш-домен/auth/v1|' \ -e 's|^FUNCTIONS_VERIFY_JWT=.*|FUNCTIONS_VERIFY_JWT=true|' \ -e 's|^ENABLE_PHONE_SIGNUP=.*|ENABLE_PHONE_SIGNUP=false|' -e 's|^ENABLE_PHONE_AUTOCONFIRM=.*|ENABLE_PHONE_AUTOCONFIRM=false|' \ -e 's|^ENABLE_EMAIL_SIGNUP=.*|ENABLE_EMAIL_SIGNUP=true|' -e 's|^ENABLE_EMAIL_AUTOCONFIRM=.*|ENABLE_EMAIL_AUTOCONFIRM=false|' \ -e 's|^SMTP_HOST=.*|SMTP_HOST=|' -e 's|^SMTP_USER=.*|SMTP_USER=|' -e 's|^SMTP_PASS=.*|SMTP_PASS=|' \ -e 's|^SMTP_ADMIN_EMAIL=.*|SMTP_ADMIN_EMAIL=|' -e 's|^SMTP_PORT=.*|SMTP_PORT=587|' -e 's|^OPENAI_API_KEY=.*|OPENAI_API_KEY=|' .envЗакройте порты базы и настройте ИИ-прокси
Studio использует прокси Fatmetal к внешним моделям. Для работы с таблицами ключ модели не требуется.
cat > docker-compose.override.yml <<'YAML' services: studio: environment: HTTP_PROXY: http://api-proxy.fatmetal.net:8080 HTTPS_PROXY: http://api-proxy.fatmetal.net:8080 NO_PROXY: localhost,127.0.0.1,10.0.0.0/8,172.16.0.0/12,db,api-gw,studio,auth,rest,realtime,storage,imgproxy,meta,functions,supavisor NODE_USE_ENV_PROXY: "1" OPENAI_BASE_URL: ${OPENAI_BASE_URL:-https://api.openai.com/v1} supavisor: ports: !override ["127.0.0.1:5432:5432", "127.0.0.1:6543:6543"] YAMLСохраните зависимости Edge Functions локально
Это устраняет обнаруженный сбой загрузки JSR. Проверка токенов сохраняется; пример hello собирается из исходников вендора.
mkdir -p volumes/functions/main/vendor/jose /opt/supabase-function-build curl -fsSL https://registry.npmjs.org/jose/-/jose-6.1.0.tgz | tar -xz --strip-components=3 -C volumes/functions/main/vendor/jose package/dist/webapi sed -i 's|jsr:@panva/jose@6|./vendor/jose/index.js|' volumes/functions/main/index.ts sed '/import "@supabase\/functions-js\/edge-runtime.d.ts"/d' /opt/supabase-source/docker/volumes/functions/hello/index.ts > /opt/supabase-function-build/hello.ts docker run --rm -v /opt/supabase-function-build:/build -w /build node:22.19.0-alpine3.22 sh -c 'npm install --no-audit --no-fund @supabase/server@1.9.1 esbuild@0.25.9 && ./node_modules/.bin/esbuild hello.ts --bundle --platform=browser --main-fields=module,main --format=esm --outfile=hello-bundle.js --conditions=browser,deno,import,default' cp /opt/supabase-function-build/hello-bundle.js volumes/functions/hello/index.tsПоднимите стек и откройте HTTPS
Откройте входящие 80 и 443, направьте A-запись домена на сервер. Домен Fatmetal с IP через дефисы уже разрешается автоматически.
docker compose pull docker compose up -d --wait printf '%s {\n reverse_proxy 127.0.0.1:8000\n}\n' 'ваш-домен' > /etc/caddy/Caddyfile systemctl reload caddy docker compose ps
Откройте https://ваш-домен. Браузер запросит DASHBOARD_USERNAME и DASHBOARD_PASSWORD из /opt/supabase/.env; после входа откроется Studio. Не публикуйте этот файл и храните его с правами 600.
Для подтверждения почты заполните в .env SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS, SMTP_ADMIN_EMAIL и SMTP_SENDER_NAME; оставьте ENABLE_EMAIL_AUTOCONFIRM=false. Затем выполните docker compose up -d auth и подтвердите тестовую регистрацию письмом.
Создайте таблицу и проверьте права клиента
В Authentication → Users создайте двух тестовых пользователей через Add user с подтвержденными адресами. Затем откройте SQL Editor → New query и выполните запрос:
create table public.fatmetal_notes (
id bigint generated always as identity primary key,
owner_id uuid not null default auth.uid() references auth.users(id),
note text not null
);
alter table public.fatmetal_notes enable row level security;
grant select on public.fatmetal_notes to anon;
grant select, insert on public.fatmetal_notes to authenticated;
create policy own_select on public.fatmetal_notes
for select to authenticated using (owner_id = auth.uid());
create policy own_insert on public.fatmetal_notes
for insert to authenticated with check (owner_id = auth.uid());
Выполните вход с данными созданного пользователя. Ответ содержит access_token, который приложение передает при работе с его записями:
curl 'https://ваш-домен/auth/v1/token?grant_type=password' \
-H 'apikey: ваш-publishable-key' -H 'Content-Type: application/json' \
-d '{"email":"alice@example.com","password":"ваш-пароль-пользователя"}'
Для записи используйте publishable key и access_token из ответа входа. owner_id заполнится автоматически; чтение вернет строки этого пользователя:
curl 'https://ваш-домен/rest/v1/fatmetal_notes' \
-H 'apikey: ваш-publishable-key' -H 'Authorization: Bearer ваш-access-token' \
-H 'Content-Type: application/json' -d '{"note":"Моя заметка"}'
curl 'https://ваш-домен/rest/v1/fatmetal_notes?select=id,note' \
-H 'apikey: ваш-publishable-key' -H 'Authorization: Bearer ваш-access-token'
Повторите чтение под вторым пользователем; затем попробуйте вставить запись с чужим owner_id. На стенде такая вставка вернула 403. Без пользовательского токена данные не раскрывались.
В Storage создайте private bucket и загрузите файл. Проверяйте его своим клиентом с разрешенным доступом: для приватного файла маршрут object/public не должен выдавать содержимое.
Что происходит после настоящей работы
Стенд прошел вход пользователей, запись и чтение заметок, обмен событиями, загрузку файлов и вызов hello. После этой работы стек занимал 947 МиБ памяти.
| API: запись 1000 заметок | 176 мс |
| API: чтение 1000 заметок | 59 мс |
| Загрузка CSV: 200000 строк, 19,9 МиБ | 1,3 с |
| Скачивание того же CSV | 1,1 с |
| HTTPS-запрос к Studio | 50 мс |
| Повторный запуск до Studio и API | 21 с |
| Повторный запуск всех сервисов | 37 с |
Повторный запуск использовал готовые образы и сохраненную базу. Это время восстановления сервисов после остановки; первую установку приходится начинать со скачивания нескольких гигабайт образов.
Запросы выполнял один клиент последовательно: эти задержки показывают отклик приложения, а не предел числа одновременных пользователей.
После скачивания CSV совпала его контрольная сумма. Публичный запрос к приватному объекту вернул 400, поэтому успешную загрузку удалось проверить вместе с ограничением доступа.
Где может сломаться
Причина. Edge Runtime не загрузил зависимость, хотя проверка адреса обычным curl проходила.
Решение. Выполните шаг с локальными JOSE и сборкой hello, затем docker compose restart functions. Проверяйте ответ /functions/v1/hello с ключом и токеном; выключать FUNCTIONS_VERIFY_JWT не требуется.
Причина. COMPOSE_FILE перечисляет только основной файл, поэтому Compose не читает override автоматически.
Решение. Исправьте COMPOSE_FILE в файле .env:
sed -i 's|^COMPOSE_FILE=.*|COMPOSE_FILE=docker-compose.yml:docker-compose.override.yml|' .env
Затем выполните docker compose up -d. Проверьте ss -lnt: 8000, 5432 и 6543 должны слушать 127.0.0.1.
Причина. На стенде помощник зависал с Node 18.19.1.
Решение. Используйте Docker-вариант с Node 22 из инструкции. На машине с Node 18 перед первым запуском помощника выполните:
sed -i 's/"$major" -ge 16/"$major" -ge 22/g' utils/add-new-auth-keys.sh
Как сохранить и восстановить проект
Для этой установки подойдет холодная копия: остановите сервисы и сохраните рабочий каталог вместе с именованным томом db-config. В нем находится конфигурация базы, включая ключ pgsodium.
cd /opt/supabase
install -d -m 700 /root/supabase-backup
umask 077
docker compose stop
tar -czf /root/supabase-backup/project.tgz -C /opt supabase
tar -czf /root/supabase-backup/db-config.tgz -C "$(docker volume inspect supabase_db-config -f '{{.Mountpoint}}')" .
docker compose up -d --wait
Перенесите копию на свой компьютер командой:
ssh пользователь@ваш-домен 'sudo -n tar -C /root/supabase-backup -cf - project.tgz db-config.tgz' > supabase-backup.tar
Копия содержит пароли, ключи, пользователей и файлы; доступ к ней должен быть ограничен.
Для восстановления на том же сервере остановите стек и распакуйте оба архива. Сохраненные Compose и .env возвращают те же версии и секреты:
cd /opt/supabase
docker compose stop
mv /opt/supabase /opt/supabase.before-restore
tar -xzf /root/supabase-backup/project.tgz -C /opt
cd /opt/supabase
tar -xzf /root/supabase-backup/db-config.tgz -C "$(docker volume inspect supabase_db-config -f '{{.Mountpoint}}')"
docker compose up -d --wait
После восстановления войдите прежним пользователем, прочитайте его заметку и скачайте сохраненный файл. Наличие архива без этих трех действий еще не подтверждает, что копия пригодна.
Для повторного получения образов закрепленного Compose выполните:
docker compose pull && docker compose up -d --wait
. Затем повторите проверки данных и docker compose ps.
Новый тег сначала скачайте в исходный каталог:
git -C /opt/supabase-source fetch --depth 1 origin self-hosted/v0.8.2
. Для другой версии замените тег и сравните изменения командой:
git -C /opt/supabase-source diff HEAD FETCH_HEAD -- docker
Переносите настройки после резервной копии.
Что подключить к Supabase
- SMTP - ваш почтовый сервер отправляет подтверждения и восстановление доступа. Фиктивные SMTP-параметры из примера уже удалены инструкцией.
- Файловое хранилище - начните с локального диска; при росте регулярных загрузок планируйте отдельное место для объектов. Для часто читаемых объектов выбирайте горячее S3 на SSD, для редко читаемых архивов и копий - холодное на HDD. Каталог PostgreSQL остается на файловой системе.
- ИИ-помощник Studio - добавьте собственный OPENAI_API_KEY в .env и пересоздайте Studio командой
docker compose up -d studio. Прокси Fatmetal к внешним API входит в VPS и настроен выше; модели оплачиваются у провайдера. - Другой backend - PocketBase стоит рассмотреть для небольшого приложения, которому достаточно SQLite; Appwrite - как другую готовую серверную платформу.
Studio сможет обращаться к совместимому провайдеру по OPENAI_BASE_URL. На стенде штатный запрос ИИ-помощника прошел через этот прокси и вернул ответ; настройки внутренних сервисов обходят прокси через NO_PROXY.
Когда это НЕ ваш выбор
Нужен готовый перенос Firebase
SDK и модель данных различаются. Если приложение уже написано под Firestore, заменить адрес сервера недостаточно: запросы, авторизацию и правила доступа придется переносить.
Нужно обслуживание как в Supabase Cloud
Один Compose на VM не дает управляемых резервных копий, восстановления на момент времени и отказоустойчивого облака. Если некому отвечать за восстановление и обновления, выбирайте управляемый сервис.
Нужна панель на русском
Проверенная Studio работает на английском; настройки языка нет. Для команды, которая будет ежедневно управлять пользователями и таблицами без знания английского, это практическое препятствие.
Supabase разрабатывает компания, основанная в 2020 году. Основной репозиторий опубликован под Apache-2.0; собственное размещение не требует подписки Supabase. Лицензии включенных компонентов проверяются отдельно.
Частые вопросы
Что ставить в браузерный клиент?
SUPABASE_PUBLIC_URL и SUPABASE_PUBLISHABLE_KEY из .env. SUPABASE_SECRET_KEY и SERVICE_ROLE_KEY остаются на сервере, где приложение выполняет административные операции.
Почему клиент не видит строки, а Studio видит?
Проверьте роль и RLS: административный postgres имеет другие права. Запрос клиента должен содержать токен вошедшего пользователя, а SELECT-политика - разрешать его owner_id.
Как посмотреть причину отказа?
В /opt/supabase выполните docker compose logs --tail=100 auth rest functions. Это покажет сообщения входа, API таблиц и функций без вывода всего .env.
Как подключиться к SQL с ноутбука?
Оставьте порт закрытым снаружи и создайте SSH-туннель: ssh -L 15432:127.0.0.1:5432 пользователь@ваш-домен. SQL-клиент подключается к localhost:15432: пользователь postgres.tenant_id, где tenant_id - POOLER_TENANT_ID из .env; пароль - POSTGRES_PASSWORD, база - postgres.
Как защитить публичный адрес?
Caddy выдает HTTPS, Envoy запрашивает пароль для Studio. Доступ к API приложения ограничивают ключи, пользовательские токены и политики базы; открытыми остаются только веб-порты и SSH.
Проверено на версии 0.8.2, 7 октября 2026. На новых версиях результаты могут отличаться.
Итог
Supabase подходит, когда приложению нужны PostgreSQL и готовые API/Auth. Начните с таблицы, разделите данные двух пользователей политиками и проверьте восстановление проекта; после этого подключайте рабочее приложение.
Рекомендуемая конфигурация для установки:
4 vCPU · 8 ГБ RAM · 100 ГБ NVMe
Не хотите устанавливать вручную?
Запустите Supabase на этой конфигурации автоматически - от 990 ₽/мес.
Этот стек у нас запущен на тарифе CPU4-RAM8-DISK100. Нашли баг в гайде - напишите, поправим в течение дня.