[Docker] Docker PostgreSQL 연결 문제 : localhost 바인딩 우선순위와 'role postgres does not exist' 오류 해결

Docker 기반 PostgreSQL 컨테이너를 사용하던 중 DataGrip에서 연결 테스트 시 "[28000] FATAL: role 'postgres' does not exist" 오류가 발생했다.

 

아래와 같은 명령어로 Docker 컨테이너를 생성하고 PostgreSQL 데이터베이스 서버를 실행했다.

PostgreSQL 데이터베이스를 Docker 컨테이너로 실행하되, 데이터는 호스트 시스템의 볼륨에 저장하고, 호스트의 5432 포트를 통해 컨테이너의 내 5432 포트에 접근할 수 있게 했다.

 상태도 정상인 것을 확인할 수 있었다.

 

다음으로 Datagrip에서 Test Connection을 시도해 보았다. 아래와 같이 [28000] FATAL: role 'postgres' does not exist 에러가 발생했다.

 

우선 문제의 컨테이너의 로그를 확인하여 더 자세한 정보를 확인했다.

처음에 포트 충돌문제를 의심했지만 위 로그 상으로는 문제가 없어 보여 넘어갔다.

[28000] FATAL: role 'postgres' does not exist 오류는 PostgreSQL에 'postgres' 사용자로 접속하려고 할 때 해당 사용자가 데이터베이스 시스템에 존재하지 않을 때 발생한다.

다시 처음 컨테이너를 생성했던 명령어를 살펴보았고, 분명 슈퍼 유저를 postgres로 설정한 것을 확인할 수 있었다. 

관련 오류를 겪은 사람들의 글을 찾아 보며 username을 명시적으로 지정해 보는 옵션을 포함해서 실행하는 등 여러 시도를 했지만 해결되지 않았다.

 

해결 방법 1: 포트 매핑 변경

포트 문제인가 싶어서 5433:5432로 포트를 매핑해보았더니 허무하지만 정상 연결이 되었다.

 

포트 매핑 변경후 연결에 성공한 뒤에서야 현재 5432 포트를 사용 중인 프로세스를 확인해 보았다.

 

• 첫 번째와 두 번째 줄: 동일한 PostgreSQL 프로세스(PID 1701)가 IPv6와 IPv4 각각에서 localhost(5432 포트)에서 LISTEN 상태이다.
• 세 번째 줄: Docker 관련 프로세스(com.docke, PID 82303)가 모든 인터페이스(*)에서 LISTEN 상태이다. 

아래글부터"Homebrew PostgreSQL"과 "호스트 PostgreSQL"로 단어를 혼용해 사용하고 있는데 같은 프로세스를 지칭하고 있다는 점을 언급하고 다음으로 넘어가겠다.

---

의문: localhost와 모든 인터페이스(*)에서 동일 포트가 열려 있어도 문제가 발생하지 않는 이유는 무엇일까?

커널의 바인딩에서는 특정 IP에 명시적으로 바인딩된 소켓은 0.0.0.0(*) 바인딩보다 우선순위를 가진다. 때문에 해당 경우  lostcalhost:postgresql(127.0.0.1:5432)로의 연결 시도는 항상 IP가 localhost 명시적으로 바인딩된 Homebrew PostgreSQL로 라우팅 된다.

아래와 같이 간단한 흐름으로 해당 상황을 정리해 보았다.

 

네트워크 트래픽 흐름

1. 클라이언트 -> localhost:5432

2. 커널 루프백 드라이버 -> Homebrew PostgreSQL

* Docker 컨테이너는 *:5432에서 대기 중이지만 localhost 트래픽을 가로챌 수 없었던 것이다.

 

그렇다면 Datagrip에서 localhost가 아닌 다른 ip로 접속을 시도하면 Docker 컨테이너 Postgresql로 연결이 가능해질까 궁금해져 시도해 보았다.

en0 인터페이스에 할당된 로컬 IP 주소를 이용해 연결을 시도해 보자.

Host를 로컬 IP 주소로 한 뒤 user는 postgres로 설정하고 연결을 테스트하니 아래와 같이 Docker 컨테이너 PostgreSQL에 연결에 성공할 수 있는 것을 확인할 수 있었다.

 

 

위 두 상황을 다시 정리해 보자.

localhost:5432로 접속 시

1. 클라이언트 요청 → localhost:5432

2. 커널의 바인딩 우선순위에 따라 localhost에 명시적으로 바인딩된 프로세스로 라우팅

3. Homebrew PostgreSQL이 요청 처리 (Docker 컨테이너는 무시됨)

로컬 네트워크 IP:5432로 접속 시

1. 클라이언트 요청 → 192.168.x.x:5432 (로컬 IP)

2. 네트워크 인터페이스를 통해 *(모든 인터페이스)에 바인딩된 프로세스로 라우팅

3. Docker 컨테이너의 PostgreSQL이 요청 처리

해결 방법 2: 호스트 PostgreSQL 중지

"[28000] fatal: role 'postgres' does not exist" 오류 원인은 호스트와 해당 Docker 컨테이너 모두 5432 포트를 사용하고 있지만, DataGrip은 Homebrew PostgreSQL 인스턴스에 연결하려고 시도하려 했기 때문이다.

Homebrew로 설치된 PostgreSQL에서 존재하는 역할(role) 목록을 확인해 보자.

Role name에 'postgres'가 존재하지 않았다. 때문에 "[28000] fatal: role 'postgres' does not exist"라는 에러가 발생한다.

Homebrew Postgresql에 존재하는 Role name으로 5432 포트에 대해 test connection에 연결을 시도해 보자.

discodeit_user로 user 명을 변경하고 다시 시도해 보니 아래와 같이 연결에 성공함을 확인할 수 있었다.

 

이제 문제의 원인을 파악했으니 다시 문제를 해결하기 위한 두 번째 방법으로 호스트 PostgreSQL을 중지한 뒤 연결을 테스트해보자.

호스트에서 실행 중인 Homebrew PostgreSQL 서비스를 중지하고 5432:5432 포트, user는 postgres로 연결을 시도해 봤고, 정상적으로 test connection에 성공한 것을 확인할 수 있었다.

 

정리

 

• 네트워크 바인딩 우선순위
  • 동일한 포트에서 구체적인 바인딩(localhost)이 일반적인 바인딩(*)보다 우선시 된다.
• 포트 확인
  • lsof -i :포트번호로 동일 포트번호에 할당된 프로세스들을 파악하자.
  • 에러 메시지가 실제 원인과 직결되지 않을 수도 있다.
• Docker 컨테이너와 호스트 서비스 간 상호작용
  • 같은 포트를 사용해도 네트워크 인터페이스에 따라 다른 서비스로 연결된다.

 

 

참고자료:

https://seosh817.tistory.com/373

[Docker] 도커 네트워크 이해하기

https://onthegoalways.com/blog/port-sharing-os-and-docker/

 

https://www.baeldung.com/linux/socket-options-differencep

 

 

https://docs.docker.com/engine/network/packet-filtering-firewalls/

Packet filtering and firewalls

https://serverfault.com/questions/1084915/still-confused-why-docker-works-when-you-make-a-process-listen-to-0-0-0-0-but-no

Still confused why docker works when you make a process listen to 0.0.0.0 but not 127.0.0.1