Установить PostgreSQL и подключиться: что проверить заранее

На Ubuntu 24.04 LTS вы установите PostgreSQL из системных пакетов, создадите пользователя и базу, а затем проверите вход через psql. Обычно на это хватает 10–15 минут при наличии доступа sudo и интернет-соединения. Инструкция рассчитана на локальную установку: сервер и клиент работают на одном компьютере.

Что нужно до начала

• Компьютер с Ubuntu 24.04 LTS и доступом к интернету.
• Учётная запись, которой разрешено выполнять команды через sudo.
• Терминал. Команды ниже рассчитаны на стандартные пакеты Ubuntu, а не на PostgreSQL, установленный через Docker или сторонний репозиторий.
• Понимание, что PostgreSQL будет доступен локально. Настройку удалённого доступа эта инструкция не включает: для неё потребуется отдельно проверить сеть, файрвол и правила аутентификации.

В репозитории Ubuntu 24.04 обычно доступна ветка PostgreSQL 16. Проверьте фактически установленную версию после установки: содержимое репозиториев и обновления со временем меняются. Если вам нужна конкретная версия, сверьте способ установки с официальной документацией PostgreSQL для Ubuntu.

Установка и первый вход

1. Обновите список пакетов. Выполните в терминале sudo apt update. Проверка: команда завершается без сообщения об ошибке загрузки репозиториев.
2. Установите сервер и клиент. Выполните sudo apt install postgresql postgresql-client и подтвердите установку, если система спросит. Пакет сервера запускает службу PostgreSQL, клиентский пакет добавляет программу psql. Проверка: команда psql --version выводит номер версии.
3. Проверьте службу. Выполните systemctl status postgresql. В выводе найдите состояние active. Выйти из экрана статуса можно клавишей q. Если служба не запущена, попробуйте sudo systemctl start postgresql, затем снова проверьте статус.
4. Подключитесь к серверу от системного пользователя postgres. Выполните sudo -u postgres psql. Этот способ подходит для начальной настройки на локальной Ubuntu: он не требует заранее заданного пароля PostgreSQL. Проверка: приглашение изменится на postgres=#. Выйти из psql можно командой \q.

Если пакеты уже установлены, не переустанавливайте их автоматически: сначала проверьте версию и состояние службы. На компьютере могут работать несколько кластеров PostgreSQL, а приложения могут быть привязаны к конкретной версии.

Создайте отдельную базу и пользователя

Для приложения не стоит постоянно входить от имени системного администратора PostgreSQL. Создайте отдельную роль с правом входа и базу, владельцем которой будет эта роль. Войдите командой sudo -u postgres psql, затем выполните команды по очереди:

CREATE ROLE app_user LOGIN;
\password app_user
CREATE DATABASE app_db OWNER app_user;
\q

После \password app_user psql попросит ввести пароль и повторить его. Символы при вводе могут не отображаться — это нормально. Пароль не попадает в историю командной строки в виде SQL-текста. Не подставляйте его в команду подключения и не храните в репозитории проекта.

Проверка: создайте базу без ошибок, выйдите из psql и подключитесь как новый пользователь:

psql -h 127.0.0.1 -U app_user -d app_db

Ключ -h 127.0.0.1 задаёт TCP-подключение к локальному компьютеру. psql запросит пароль. После входа выполните SELECT current_database(), current_user;: результат должен содержать app_db и app_user. Завершите сеанс командой \q.

Успешная установка — не просто команда psql без ошибки. Проверьте, что приложение входит под отдельной ролью в свою базу, а не использует административную учётную запись.

Что означают сообщения об ошибках

psql: command not found

Клиент psql не установлен или команда недоступна в PATH. Проверьте установку пакета командой sudo apt install postgresql-client, затем повторите psql --version. Если у вас уже есть PostgreSQL из другого источника, выясните, где установлен его клиент, прежде чем смешивать пакеты.

connection refused

Клиент не нашёл сервер, принимающий соединения по указанному адресу и порту. Для локальной установки проверьте systemctl status postgresql. Если служба активна, выясните, на каком адресе и порту слушает нужный кластер; не открывайте сетевой доступ наугад.

password authentication failed for user

Сервер получил запрос, но не принял указанные имя пользователя и пароль. Проверьте, что вводите пароль роли PostgreSQL, а не пароль учётной записи Ubuntu, и что подключаетесь к нужному серверу. Если пароль потерян, войдите локально через sudo -u postgres psql и задайте его заново командой \password app_user.

database app_db does not exist

Указанной базы нет на сервере, к которому вы подключились. Проверьте имя в команде и список баз внутри psql командой \l. Создайте базу от имени администратора PostgreSQL, если её действительно ещё нет.

Где заканчивается эта настройка

Эти шаги подходят для локальной разработки, но не превращают компьютер в готовый сервер для публичного доступа. Удалённое подключение требует отдельной настройки адреса прослушивания, правил в pg_hba.conf, сетевого экрана и защиты учётных данных. Не выставляйте порт PostgreSQL в интернет только ради того, чтобы подключиться с ноутбука: сначала настройте ограниченный сетевой доступ и безопасную аутентификацию.

После установки запишите версию PostgreSQL, способ установки и имя кластера. Это поможет не перепутать базы, если позже на машине появятся другие версии. Если подключение нужно приложению, задайте параметры через секреты окружения или защищённое хранилище проекта и проверьте вход именно от его отдельной роли.

Термин. Кластер PostgreSQL — отдельный экземпляр сервера с собственными файлами данных и настройками. На одном компьютере может быть несколько кластеров, поэтому активная служба ещё не гарантирует, что приложение подключается к нужному.

Что делать дальше

Подключите к базе своё приложение, используя роль с минимально необходимыми правами, и выполните тестовый запрос. Для разработки добавьте миграции схемы и резервное копирование в рабочий процесс; для сервера отдельно разберите сетевую защиту и восстановление из резервной копии. Актуальные команды и параметры установки сверяйте с документацией именно вашей версии PostgreSQL.