데이터베이스 클러스터 초기화

PostgreSQL 15를 설치한 후에는 먼저 데이터베이스 클러스터를 초기화해야 합니다.

sudo /usr/pgsql-15/bin/postgresql-15-setup initdb

기화 완료 후, 서비스 등록 및 실행 명령어는 다음과 같습니다.

sudo systemctl enable postgresql-15
sudo systemctl start postgresql-15
sudo systemctl status postgresql-15

환경 변수 설정

시스템 전역에서 psql 등의 명령어를 사용하려면 /etc/profile에 경로를 추가합니다.

sudo vim /etc/profile

export PG_HOME=/usr/pgsql-15
export PATH=$PATH:$PG_HOME/bin

적용을 위해 소스 명령을 실행합니다.

source /etc/profile

데이터베이스 및 계정 생성

postgres 운영 계정으로 전환 후 psql 인터랙티브 쉘에 진입합니다.

su - postgres
psql

새로운 데이터베이스와 사용자를 생성하고, 관리자 계정의 비밀번호를 설정합니다.

CREATE DATABASE sample_db;
CREATE ROLE app_user WITH LOGIN PASSWORD 'secure_password';
ALTER USER postgres WITH PASSWORD 'new_password';

외부 접속 허용 설정

기본적으로 PostgreSQL은 로컬 연결만 허용합니다. 원격 접속을 위해 두 개의 핵심 파일을 수정해야 합니다.

1. postgresql.conf 파일에서 수신 대상 주소를 변경합니다.

sudo vim /var/lib/pgsql/15/data/postgresql.conf

listen_addresses = '*'

2. pg_hba.conf 파일에서 인증 규칙을 추가합니다.

sudo vim /var/lib/pgsql/15/data/pg_hba.conf

host    all    all    0.0.0.0/0    scram-sha-256

설정 반영을 위해 서비스를 재시작합니다.

sudo systemctl restart postgresql-15

원격 접속 테스트

설정 변경 후, postgres 계정의 비밀번호가 설정되어 있지 않으면 인증에 실패할 수 있습니다. 반드시 먼저 비밀번호를 설정한 후 접속을 시도하세요.

# 비밀번호 설정 전 접속 시도 - 실패 예시
psql -h 127.0.0.1 -p 5432 -U postgres

# 비밀번호 설정
su - postgres
psql -c "ALTER USER postgres WITH PASSWORD 'new_password';"

# 원격 접속 테스트
psql -h <호스트_IP> -p 5432 -U postgres

핵심 디렉터리 및 파일 구조

PostgreSQL 15의 주요 경로는 다음과 같습니다.

데이터 디렉터리 내 주요 파일

데이터 디렉터리 내 주요 하위 디렉터리