Нейротраф — делаем деньги из TelegramРаздел 2 · урок 1 из 5
12345уроки раздела 2
Раздел 2. Развертывание базы данных и запуск комбайна

Установка PostgreSQL и импорт структуры базы данных

≈ 4 минГарри Герд

Telegram-комбайн оперирует десятками и сотнями сущностей одновременно: сессиями аккаунтов, прокси-серверами, историями авторизаций, базой каналов и очередями реакций. Для надежного хранения этих данных, исключения конфликтов параллельных потоков и мгновенного доступа используется реляционная СУБД PostgreSQL. В этом уроке мы установим СУБД на Ubuntu 22.04 LTS, создадим пользователя, подготовим базу данных, адаптируем файл структуры bd.sql и выполним импорт таблиц.

Контекст и технические требования

Для работы необходим сервер с ОС Ubuntu 22.04 LTS и правами суперпользователя root. Команды выполняются в SSH-терминале PuTTY.

Убедитесь, что файлы билда комбайна скопированы через WinSCP в рабочую папку бота:

/root/bot/

В этой папке находится дистрибутив комбайна. На текущем этапе нам нужен только файл структуры bd.sql. Остальные файлы понадобятся на следующих уроках при настройке Docker и запуске контейнера.

Использование PostgreSQL обусловлено многопоточной архитектурой комбайна: файловые базы вроде SQLite блокируются при одновременной записи десятков сессий, тогда как PostgreSQL гарантирует стабильную работу транзакций под нагрузкой.

Подготовительные действия и риски

Дамп bd.sql сформирован в среде разработки и содержит роли владельцев таблиц postgres и tguser.

Риск некорректных прав на таблицы

Если запустить импорт bd.sql без предварительной замены владельцев ролей, таблицы создадутся с чужими правами владения. В результате комбайн не сможет сохранять сессии аккаунтов, вести лог реакций и обновлять прокси. Замена ролей утилитой sed перед импортом обязательна.

Требования к паролю базы данных

При создании пароля пользователя СУБД избегайте одинарных кавычек, пробелов и спецсимволов вроде $. Они нарушают экранирование в Bash и ломают парсинг переменной DATABASE_URL в файле .env.

Пошаговый протокол выполнения

  1. Установка PostgreSQL: Установите пакеты СУБД через apt:
    sudo apt update
    sudo apt install -y postgresql postgresql-contrib
    
    Пакетный менеджер установит СУБД и создаст системного пользователя postgres. Если появится диалоговое окно выбора конфигурации, подтвердите вариант по умолчанию.
  2. Запуск и автозагрузка: Активируйте службу PostgreSQL:
    sudo systemctl start postgresql
    sudo systemctl enable postgresql
    
    Проверьте статус службы через sudo systemctl status postgresql. Статус active подтверждает готовность базы данных к работе.
  3. Создание пользователя и базы данных: Подключитесь к консоли СУБД под системным пользователем postgres:
    sudo -u postgres psql
    
    В консоли выполните SQL-запросы (замените <DB_USER> и <DB_PASSWORD> на свои значения):
    CREATE USER <DB_USER> WITH PASSWORD '<DB_PASSWORD>';
    CREATE DATABASE telegabd OWNER <DB_USER>;
    GRANT ALL PRIVILEGES ON DATABASE telegabd TO <DB_USER>;
    \q
    
    Команда \q закрывает сеанс psql. Обязательно сохраните имя пользователя, пароль и название базы данных.
  4. Адаптация SQL-дампа через sed: Перейдите в директорию ~/bot и выполните пакетную замену имен владельцев таблиц на созданного пользователя <DB_USER>:
    cd ~/bot
    sed -i 's/Owner: postgres/Owner: <DB_USER>/g' bd.sql
    sed -i 's/Owned by: postgres/Owned by: <DB_USER>/g' bd.sql
    sed -i 's/FOR ROLE postgres/FOR ROLE <DB_USER>/g' bd.sql
    sed -i 's/Owner: tguser/Owner: <DB_USER>/g' bd.sql
    
    Утилита sed выполняет замену прямо в файле без необходимости открывать дамп во внешних редакторах.
  5. Проверка чистоты дампа: Убедитесь, что старые имена разработчика удалены из файла:
    grep -n "postgres\|tguser" bd.sql
    
    Если вывод команды пуст — файл готов к загрузке. Если выводятся строки с номерами — проверьте правильность имени пользователя в командах sed.
  6. Импорт структуры базы: Запустите импорт таблиц, передав пароль через переменную окружения PGPASSWORD:
    PGPASSWORD='<DB_PASSWORD>' psql -U <DB_USER> -d telegabd -h localhost -f bd.sql
    
    В процессе импорта терминал выведет сообщения CREATE TABLE, ALTER TABLE и CREATE INDEX, подтверждающие создание структуры комбайна.

Проверка работоспособности (Валидация)

Проверьте наличие таблиц в созданной базе:

sudo -u postgres psql -d telegabd

Введите команду:

\dt

Терминал должен вывести список таблиц комбайна:

 Schema |         Name           | Type  |  Owner   
--------+------------------------+-------+----------
 public | account_session_history| table | <DB_USER>
 public | accounts               | table | <DB_USER>
 public | api_keys               | table | <DB_USER>
 public | channels               | table | <DB_USER>

Убедитесь, что в столбце Owner указан ваш пользователь <DB_USER>, а не postgres или tguser. Введите \q для выхода.

Сохраните реквизиты СУБД

Имя пользователя, пароль и название базы понадобятся на уроке 07 для сборки строки DATABASE_URL в файле .env.

Разбор типичных ошибок (Troubleshooting)

Ошибка в терминалеПричинаСпособ устранения
FATAL: password authentication failedОпечатка в пароле при импортеПроверьте пароль в переменной PGPASSWORD
psql: error: connection to server on socket failedСлужба PostgreSQL не запущенаПроверьте статус и запустите службу через sudo systemctl restart postgresql
grep выдает строкиНе все вхождения старых имен замененыПовторите команды sed с точным именем созданного пользователя
database "telegabd" does not existБаза не создана перед импортомСоздайте базу через CREATE DATABASE telegabd OWNER <DB_USER>;
permission denied for table accountsДамп импортирован без очистки ролейПереназначьте права владельца или повторите импорт после очистки через sed

Чек-поинт готовности

Контроль СУБД

  • Пакеты PostgreSQL установлены и служба активна
  • База telegabd и пользователь созданы с полными правами
  • Дамп bd.sql очищен от старых ролей через sed
  • Импорт структуры выполнен без ошибок
  • Команда \dt отображает таблицы комбайна с владельцем <DB_USER>