Как развернуть Supabase в облаке Timeweb Cloud

Инструкция обновлена 10.02.2025

Пакет Supabase — это бесплатный аналог облачных сервисов Google Firebase (БД, аутентификация, хранение файлов, realtime обмен данными, framework для популярных языков). Перечисленные инструменты позволяют разработчикам быстро создавать как простые мобильные приложения и сайты, так и сложные корпоративные системы. Кроме того, при использовании Supabase вам не нужно уметь управлять сервером, пользователями и обслуживать базу данных — для этого в пакете присутствует готовая административная панель.

Основное плюсы Supabase

• Бесплатно (устанавливается на ваш VDS/VPS или облачный сервер).
• Собственная админка для настройки БД, авторизации пользователей и многого другого.
• Готовая база данных «из коробки» с полной настройкой из админки.
• Аутентификация пользователей «из коробки».
• Очень быстрый API (REST и GraphQL).
• Хранение и раздача файлов (подойдет даже для собственного хостинга сайтов).
• Запуск из Docker за пять минут.

Сравнительная таблица

Как видно из таблицы, Supabase даст вам 95% функционала, который вы получали от Google Firebase. Вы получите готовый настроенный backend для создания сайтов, мобильных приложений, внутренних корпоративных площадок, утилит и много другого.

Процесс настройки и запуска проекта на Supabase достаточно прост. Разработчики могут начать работу, создав учетную запись на официальном сайте, после чего доступ к базовым функциям становится практически мгновенным. Однако бесплатно вы получите только 500 МБ места для баз данных, 500 МБ оперативной памяти и сильно ограниченный ресурс CPU (не более 5%). Поэтому мы рекомендуем развернуть свое неограниченное облако.

Далее мы рассмотрим покупку сервера на базе Ubuntu и установку на него пакета Supabase. Инструкция рассчитана на новичков, поэтому она будет сопровождаться подробными скриншотами. Если вы продвинутый пользователь, можете просто пропускать некоторые пункты или выбирать свои инструменты для установки Docker-контейнеров.

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

Начнем с создания нового сервера.

Установка облачного сервера Timeweb Cloud

1. Зарегистрируйте аккаунт на timeweb.cloud.

2. Перейдите в раздел «Облачный сервер».

3. Выберите вкладку «Маркетплейс».

4. Здесь выберите Portainer (визуальная оболочка для управления контейнерами Docker) и перейдите к оплате.

5. Задайте конфигурацию сервера. Рекомендуем выбирать минимум 2 ядра CPU, 4 ГБ памяти и 20 ГБ диска.

6. Подождите пару минут, пока идет создание вашего нового сервера. После создания сервера вам на email придет письмо с инструкцией по подключению к серверу, в том числе IP-адрес, логин и пароль.

Настройка Portainer для управления контейнерами

1. Перейдите в браузер на страницу http://ВАШ-IP-АДРЕС:9001. Далее вы попадете в удобную панель Portainer — админку для управления контейнерами Docker. Укажите логин admin и пароль, который получили по email.

2. Затем выберите пункт «Get started» и перейдите в раздел «Containers».

3. Выберите пункт «Container».

4. Вы перешли в раздел мониторинга работы контейнеров, где можно посмотреть логи, настройки, нагрузку и потребляемые ресурсы каждого контейнера.

Здесь вы сможете следить за своими запущенными контейнерами, смотреть log, перезапускать, устанавливать новые приложения.

На скриншоте видно, что мы установили на чистую систему Ubuntu только контейнер с Portainer. В нашем случае контейнер называется dockerui.

Генерация ключей

Далее очень важный момент: необходимо создать три ключа: JWT_SECRET, ANON_KEY и SERVICE_ROLE_KEY, которые будут использованы для установки вашей копии Supabase. 

• ANON_KEY — это основной ключ для использования в клиентских приложениях.
• SERVICE_ROLE_KEY — это ключ для администратора.

Переходим на сайт Supabase в гид по генерации ключей, где генерируем три основных ключа.

Первый главный ключ (JWT_SECRET) генерируется автоматически.

Второй ключ: в поле «KEY» выбираем ANON_KEY и нажимаем кнопку «Create JWT» — cгенерируется ANON_KEY:

Третий ключ: аналогично выбираем в верхнем дропбоксе SERVICE_ROLE и генерируем ключ для роли service_role:

Не забудьте сохранить все три ключа, они поотребуются для дальнейшей установки. 

Следующим шагом установим непосредственно сам пакет Supabase.

Установка Supabase

Переходим к установке Supabase на сервер.

Вход на сервер

Запустите терминал (для windows: PowerShell, Windows terminal или Putty. Подробнее читайте статью) и подключитесь к вашему новому серверу через SSH. Для этого вам нужно ввести команду:

Далее сервер попросит сохранить fingerprint (введите yes) и ввести пароль. В результате вы увидите приблизительно следующее сообщение:

Как видите, мы удачно авторизовались. Теперь мы на сервере и можем отдавать ему команды. 

Создание директорий

Первое, что необходимо сделать — создать каталог /docker_data/supabase, куда затем будет установлен наш пакет. Делается это просто, всего лишь введите команду и нажмите клавишу Enter (команда вводится в одну строку):

Получение дистрибутива с Github

Для экономии места и времени мы не будем скачивать весь репозиторий Supabase, а возьмём только папку docker, которая содержит необходимые установочные файлы и занимает всего несколько килобайт.

Для этого воспользуемся выборочным клонированием с помощью git sparse-checkout. Выполните следующие команды (обратите внимание: точка в конце первой команды обязательна):

Редактирование docker-compose.yml и .env

Теперь необходимо отредактировать два файла: docker-compose.yml и .env в директории docker для автоматической установки системы Supabase в контейнерах Docker. Первый файл отвечает за установку, а второй содержит настройки (например, параметры почтового сервера, порты и т. д.).

Эти файлы уже присутствуют в скачанном дистрибутиве, а для упрощения настройки скачаем подготовленный скрипт setup-config.sh и запустим его. Для этого в директории docker_data/supabase выполните следующую команду:

Далее скрипт запустится и попросит вас поочередно ввести значения констант. 

Никому и никогда не сообщайте данные, используемые при установке.

После выполнения скрипта вы увидите следующий результат:

После ввода всех значений скрипт заполнит файлы docker-compose.yml и .env, после чего можно будет запустить установку Supabase на вашем облачном сервере.

Запуск создания docker-контейнеров

Перейдем в директорию docker:

Далее запускаем установку в Docker:

Время установки составит около 5 минут, не переживайте и просто дождитесь окончания процесса. Картина установки выглядит примерно так:

Поскольку пакет очень объемный, при первом запуске будет происходить инициализация базы данных, подождите еще 1-2 минуты после установки и переходите в Portainer (в раздел Containers) для визуального наблюдения. После полной установки вы увидите такую картину:

Поздравляем! Вы успешно установили замену Google Firebase на свой собственный сервер.

Теперь вы можете перейти в браузер и авторизоваться в админ-панели Supabase по адресу: http://IP_ВАШЕГО_VPS:8000.

При входе введите логин и пароль, которые вы указывали при запуске скрипта:

Заключение

Итак, мы рассказали вам как установить Supabase на собственный сервер и избавиться от зависимости от Google Firebase.

В следующих гайдах мы расскажем о кейсах использования Supabase, покажем конкретные примеры реализации элементов сайта в связке HTML+JavaScript, а также разберем примеры написания мобильных приложений, демонстрирующих использование Supabase для remoteControl, отправки сообщений пользователям, создания чатов техподдержки и много другого, а также попробуем создать полезные сервисные функции отслеживания состояния здоровья вашего сервера без использования решений типа Grafana+Prometheus. Задавайте вопросы в комментариях на тему, какие кейсы вам интересны и как их реализовать.