1. 소개
PostgreSQL은 Ubuntu 환경에서 많은 애플리케이션과 시스템에서 널리 사용되는 고신뢰성·고성능 관계형 데이터베이스 시스템입니다. 이 문서에서는 Ubuntu에 PostgreSQL을 설치하고 기본 설정을 수행하는 방법을 설명합니다. 초보자를 위해 설치 확인 및 연결 문제 해결까지 각 단계를 명확히 안내하므로 안심하고 환경을 구성할 수 있습니다.
2. 전제 조건 및 준비
먼저 Ubuntu 버전이 20.04 또는 22.04인지 확인하십시오. PostgreSQL을 설치하기 전에 최신 패키지 정보를 가져오기 위해 패키지 목록을 업데이트합니다.
sudo apt update
이렇게 하면 설치 과정이 원활하게 진행됩니다.
3. PostgreSQL 설치 단계
3.1 PostgreSQL 저장소 추가
기본 Ubuntu 저장소에는 최신 PostgreSQL 버전이 포함되지 않을 수 있습니다. 최신 릴리스를 설치하려면 공식 PostgreSQL 저장소를 추가합니다.
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
sudo wget -qO- https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo tee /etc/apt/trusted.gpg.d/pgdg.asc
3.2 PostgreSQL 설치
저장소를 추가한 후 다음 명령을 사용하여 PostgreSQL 및 추가 도구를 설치합니다.
sudo apt update
sudo apt install postgresql postgresql-contrib
3.3 설치 확인
설치가 완료되면 버전을 확인하여 PostgreSQL이 정상적으로 설치되었는지 검증합니다.
postgres --version
4. 초기 구성
4.1 PostgreSQL 사용자 구성
설치 과정에서 postgres라는 시스템 사용자가 생성됩니다. 데이터베이스 작업을 수행하려면 이 사용자로 전환합니다.
sudo -i -u postgres
4.2 로컬 연결 설정 편집
pg_hba.conf 파일을 편집하여 인증 방식을 설정합니다. 기본적으로 로컬 연결만 허용됩니다. 원격 접근을 허용하려면 다음 파일을 수정합니다.
sudo nano /etc/postgresql/14/main/pg_hba.conf
예를 들어 보안을 강화하기 위해 “md5” 인증을 적용할 수 있습니다.
local all postgres md5
host all all 127.0.0.1/32 md5
편집이 끝나면 변경 사항을 적용하기 위해 PostgreSQL 서비스를 재시작합니다.
sudo systemctl restart postgresql
5. 기본 운영 확인
5.1 PostgreSQL 시작 및 중지
PostgreSQL은 설치 시 자동으로 시작되지만, 다음 명령을 사용해 수동으로 시작·중지·상태 확인을 할 수 있습니다.
sudo systemctl status postgresql
sudo systemctl start postgresql
sudo systemctl stop postgresql
5.2 데이터베이스 확인
psql 명령을 이용해 PostgreSQL에 접속하고 기존 데이터베이스를 확인합니다.
sudo -u postgres psql
명령 프롬프트에서 \l을 입력하면 현재 데이터베이스 목록이 표시됩니다.
6. pgAdmin 설치 및 구성 (선택 사항)
pgAdmin은 PostgreSQL 관리 작업을 간소화하는 GUI 도구입니다. 다음 명령으로 설치하고 브라우저를 통해 PostgreSQL을 관리할 수 있습니다.
sudo apt install pgadmin4
설치 후 http://localhost/pgadmin 주소로 인터페이스에 접근합니다.
7. 일반 오류 해결
7.1 설치 및 저장소 오류
설치 중 의존성이나 저장소 오류가 발생하면 저장소 URL을 확인하고 패키지 목록을 다시 업데이트하십시오.
sudo apt update
7.2 연결 오류
“Password authentication failed”와 같은 오류가 나타나면 pg_hba.conf 파일을 확인하고 비밀번호를 검증한 뒤 서비스를 재시작합니다.
sudo systemctl restart postgresql
7.3 네트워크 오류 해결
원격 연결이 실패할 경우 postgresql.conf 파일에 listen_addresses가 “localhost”로 설정되어 있을 수 있습니다. 원격 접근을 허용하도록 다음과 같이 수정합니다.
sudo nano /etc/postgresql/14/main/postgresql.conf
설정을 아래와 같이 변경하십시오:
listen_addresses = '*'
변경 사항을 적용하려면 서비스를 재시작하십시오.
sudo systemctl restart postgresql
8. 결론
이 가이드는 Ubuntu에 PostgreSQL을 설치하고, 구성하며 기본 운영 확인을 수행하는 방법을 설명했습니다. pgAdmin, 원격 액세스 구성 및 문제 해결 팁을 포함하여, 처음 사용하는 사용자도 환경을 원활하게 설정할 수 있습니다.
