Supabase бесплатный Postgres: настройка и подводные камни

Хочешь облачную базу данных — быстро, бесплатно и без администрирования сервера? Supabase закрывает эту задачу для большинства стартапов и пет-проектов. Но первое подключение скрывает одну ловушку, которая стоит людям часов отладки. Разберём всё по порядку.

Что даёт бесплатный тариф Supabase

Supabase — это облачная платформа поверх PostgreSQL с открытым исходным кодом. Бесплатный план включает:

• 50 000 активных пользователей в месяц — хватит для MVP и небольших продуктов
• 500 MB хранилища — достаточно для старта и тестирования
• Автоматические бэкапы и SSL — без дополнительных настроек
• Дашборд, Studio и REST API — из коробки

Главное: тебе не нужно поднимать и обслуживать сервер. Supabase делает это за тебя.

Как получить строку подключения

После регистрации на supabase.com и создания проекта:

1. Открой Settings → Database
2. Найди раздел Connection string
3. Переключись на вкладку Session Pooler — это критически важно (объясним ниже)
4. Скопируй строку вида:

postgresql://postgres.[ref]:[password]@aws-0-eu-central-1.pooler.supabase.com:5432/postgres

1. Замени [password] на пароль своего проекта (задаётся при создании проекта или в Settings → Database → Reset password)

Строку можно использовать в любом ORM: Prisma, SQLAlchemy, Drizzle, Sequelize — синтаксис стандартный PostgreSQL.

Главный гоча: Session Pooler и символ «@» в пароле

Здесь спотыкается большинство новичков — и разработчики с опытом тоже.

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

Supabase предлагает три режима подключения:

• Direct — прямое подключение к Postgres
• Transaction Pooler — для serverless-функций (каждый запрос = новое соединение)
• Session Pooler — для долгоживущих приложений и большинства фреймворков

Для обычных бэкендов, ботов и автоматизаций используй Session Pooler. Прямое подключение лимитировано по количеству коннектов и быстро упирается в потолок на бесплатном тарифе.

Символ «@» ломает URI — тихо и без ошибки

URI-формат строки подключения устроен так:

postgresql://user:password@host:port/database

Символ @ используется как разделитель между паролем и хостом. Если пароль содержит @, парсер URI воспримет его как конец пароля и начало хоста — строка сломается, и ты получишь непонятную ошибку подключения (или вообще молчание).

Как исправить:

Вариант 1 — сбросить пароль в Settings → Database и задать новый без спецсимволов (@, #, %, ?, /).

Вариант 2 — URL-энкодировать символ: @ → %40. Итого пароль my@pass в строке становится my%40pass:

postgresql://postgres.[ref]:my%[email protected]:5432/postgres

Вариант 3 — передавать параметры подключения отдельно (host, port, user, password, dbname), не через единую строку URI. Большинство библиотек поддерживают оба формата.

Чек-лист перед первым подключением

• [ ] Взял строку из вкладки Session Pooler, не Direct
• [ ] Пароль не содержит @, %, #, ? — или все спецсимволы закодированы
• [ ] Порт 5432 (Session Pooler), не 5432 Direct или 6543 Transaction
• [ ] SSL включён (Supabase требует SSL по умолчанию, большинство клиентов подхватывают автоматически)

Быстрый тест подключения

Проверь соединение через psql или любой GUI (TablePlus, DBeaver):

psql "postgresql://postgres.[ref]:[password]@aws-0-eu-central-1.pooler.supabase.com:5432/postgres"

Если видишь postgres=# — всё работает.

Для Python (psycopg2 / SQLAlchemy) передавай параметры словарём, чтобы обойти проблему URI целиком:

import psycopg2

conn = psycopg2.connect(
    host="aws-0-eu-central-1.pooler.supabase.com",
    port=5432,
    dbname="postgres",
    user="postgres.[ref]",
    password="твой_пароль",
    sslmode="require"
)

Итог

Supabase — один из лучших вариантов для старта с облачным PostgreSQL: щедрый бесплатный тариф, нулевое администрирование, стандартный SQL. Две вещи, которые нужно помнить с первого дня: Session Pooler вместо прямого подключения и никакого «@» в пароле без URL-энкодирования. Зная эти нюансы заранее, ты поднимешь рабочую базу за 10 минут, а не потратишь их на дебаг.

---

*Разбираем ИИ-инструменты и автоматизацию в ContentRun Club.*