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.
Пошаговый протокол выполнения
- Установка PostgreSQL:
Установите пакеты СУБД через
apt:Пакетный менеджер установит СУБД и создаст системного пользователяsudo apt update sudo apt install -y postgresql postgresql-contribpostgres. Если появится диалоговое окно выбора конфигурации, подтвердите вариант по умолчанию. - Запуск и автозагрузка:
Активируйте службу PostgreSQL:
Проверьте статус службы через
sudo systemctl start postgresql sudo systemctl enable postgresqlsudo systemctl status postgresql. Статусactiveподтверждает готовность базы данных к работе. - Создание пользователя и базы данных:
Подключитесь к консоли СУБД под системным пользователем
postgres:В консоли выполните SQL-запросы (заменитеsudo -u postgres psql<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. Обязательно сохраните имя пользователя, пароль и название базы данных. - Адаптация 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.sqlsedвыполняет замену прямо в файле без необходимости открывать дамп во внешних редакторах. - Проверка чистоты дампа:
Убедитесь, что старые имена разработчика удалены из файла:
Если вывод команды пуст — файл готов к загрузке. Если выводятся строки с номерами — проверьте правильность имени пользователя в командах
grep -n "postgres\|tguser" bd.sqlsed. - Импорт структуры базы:
Запустите импорт таблиц, передав пароль через переменную окружения
PGPASSWORD:В процессе импорта терминал выведет сообщенияPGPASSWORD='<DB_PASSWORD>' psql -U <DB_USER> -d telegabd -h localhost -f bd.sqlCREATE 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>