n8n Postgres 노드 설정 방법

n8n의 Postgres 노드가 갑자기 연결되지 않거나, role does not exist, connection refused, no pg_hba.conf entry 같은 오류가 연달아 뜨면 생각보다 당황스럽다. 더 답답한 건, 이런 문제들이 대부분 GUI에서 비밀번호 한 글자 틀린 수준의 단순 실수처럼 보이는데 실제 원인은 네트워크 구조, 컨테이너 간 DNS 해석, PostgreSQL 인증 정책, SSL 요구 조건처럼 한 단계 더 안쪽에 숨어 있는 경우가 많다는 점이다.

저도 처음에는 Postgres 연동 오류를 보면 늘 크리덴셜부터 다시 확인했다. 물론 그것도 중요하다. 그런데 몇 번 부딪혀보니 진짜 자주 문제를 만드는 건 오히려 Host 해석, Docker 내부 주소, 방화벽, 그리고 pg_hba.conf 쪽이었다. 특히 로컬에서는 되는데 Docker로 옮기면 바로 안 되는 경우가 많아서, “분명 같은 값인데 왜 안 되지?” 하고 시간을 꽤 태운 적이 있다.

Postgres는 MySQL보다 설정이 조금 더 엄격하게 느껴질 때가 있다. 기본적으로 어떤 주소에서 어떤 사용자로 어떤 데이터베이스에 어떤 인증 방식으로 들어올지 명확히 보려는 성격이 강하다. 그래서 n8n처럼 외부 애플리케이션에서 접근할 때는 단순히 호스트와 비밀번호만 맞춘다고 끝나지 않는다. 접근 허용 범위, 인증 방식, SSL 요구, 사용자 권한을 같이 봐야 한다.

처음 한 번은 따라 할 수 있어도, 다시 봤을 때 이해되는 구조로 정리돼 있지 않으면 금방 운영 비용이 커진다. Postgres는 값 몇 칸만 맞춘다고 끝나는 유형이 아니라, 인증 정책과 네트워크 허용 범위를 함께 봐야 안정적으로 붙는다.

이 글은 바로 그 지점을 정리하려는 목적에서 썼다. n8n Postgres 노드의 연결 원리를 먼저 이해하고, Docker와 로컬, 클라우드 DB 환경에서 각각 어디를 먼저 봐야 하는지, 쿼리 실행은 어떻게 해야 덜 위험한지, 실제로 어떤 테스트를 해보면 원인을 빨리 좁힐 수 있는지를 실무 기준으로 정리해본다.

직접 여러 번 붙여보니, 연결 오류는 무작정 비밀번호부터 다시 넣는다고 풀리는 경우보다 네트워크와 인증 층을 하나씩 분리해서 확인할 때 훨씬 빨리 잡히는 편이었다.

n8n Postgres 노드의 동작 원리와 환경 의존성

n8n의 Postgres 노드는 내부적으로 Node.js용 PostgreSQL 클라이언트를 통해 데이터베이스와 통신한다. 사용자는 Credentials에 Host, Port, Database, User, Password를 넣고 노드를 실행하지만, 실제 연결은 그보다 몇 단계 더 많은 조건을 통과해야 성립한다. 예를 들어 네트워크 경로가 열려 있어야 하고, PostgreSQL이 해당 주소에서 오는 TCP 연결을 받아야 하며, 그 사용자와 데이터베이스 조합이 pg_hba.conf 규칙에 맞아야 하고, 필요한 경우 SSL 협상도 통과해야 한다.

그래서 n8n Postgres 노드는 “입력칸만 잘 채우면 되는 노드”처럼 보이지만, 실제로는 실행 환경 의존성이 꽤 큰 편이다. 로컬 개발 환경에서는 localhost가 맞는 값일 수 있어도, Docker 컨테이너 안에서는 전혀 다른 의미가 된다. 클라우드 서비스에서는 방화벽과 보안 그룹까지 변수로 들어온다. 결국 연결 오류를 빨리 잡으려면, n8n 노드 설정만 보지 말고 그 바깥의 네트워크와 DB 인증 층까지 같이 봐야 한다.

1. PostgreSQL 서버를 외부에서 접근 가능하도록 설정하기

원문처럼 postgresql.conf의 listen_addresses와 pg_hba.conf를 손봐야 하는 경우는 분명 많다. 하지만 이건 “항상 수정해야 한다”기보다, 현재 PostgreSQL이 n8n이 있는 위치에서 오는 연결을 받아야 할 때 필요한 작업이라고 보는 편이 더 정확하다. 예를 들어 같은 Docker Compose 네트워크 안에서만 통신한다면 공개 인터넷 전체에 열 필요는 없다.

listen_addresses는 PostgreSQL이 어느 네트워크 인터페이스에서 들어오는 연결을 들을지 정하는 값이다. 기본값이 localhost면 외부 TCP 연결은 당연히 안 된다. 이 경우 *나 특정 인터페이스 주소로 넓혀야 한다. 그리고 pg_hba.conf에서는 어떤 IP 대역에서 어떤 사용자로 어떤 DB에 어떤 인증 방식으로 들어오는지를 규칙으로 정한다.

예를 들어 모든 IPv4 클라이언트가 무조건 들어오게 하자는 식의 0.0.0.0/0 예시는 테스트 용도로는 보일 수 있지만, 운영 환경에서는 꽤 위험하다. 실제 운영에서는 n8n 서버나 컨테이너가 위치한 네트워크 대역만 좁게 허용하는 쪽이 훨씬 낫다. 이 부분이 은근히 중요하다. 연결만 성공하면 끝이라고 보고 넓게 열어두면, 나중에는 보안 문제를 더 크게 안게 된다.

2. n8n Postgres 크리덴셜 올바르게 설정하는 법

n8n의 Postgres 크리덴셜에서는 Host, Port(기본 5432), Database, User, Password, SSL 관련 옵션을 넣게 된다. 여기서 가장 많이 틀리는 값이 Host다. 로컬에서 n8n을 직접 실행 중이라면 localhost가 맞을 수 있다. 하지만 n8n이 Docker 컨테이너 안에 있고 Postgres도 다른 컨테이너에 있다면, 그 시점의 localhost는 n8n 컨테이너 자신을 가리킨다.

이럴 때는 보통 같은 Compose 파일 안에 선언한 Postgres 서비스명, 예를 들어 postgres 같은 값을 Host로 넣어야 한다. 단, 이것도 “Docker면 무조건 서비스 이름”이라고 단정할 수는 없다. Postgres가 컨테이너 밖의 다른 서버나 클라우드 RDS에 있다면 당연히 그 서비스명은 안 맞는다. 결국 기준은 하나다. n8n 프로세스가 실제로 서 있는 위치에서 Postgres를 어떤 이름으로 찾아야 하느냐다.

또한 SSL 옵션도 자주 놓친다. AWS RDS, Azure Database for PostgreSQL, Supabase 같은 관리형 서비스는 SSL 연결을 요구하거나 권장하는 경우가 많다. 이런 환경에서는 n8n Credential 쪽에서 SSL을 켜고, 필요한 경우 인증서 검증 설정까지 확인해야 한다. 임시 테스트에서는 Reject Unauthorized를 꺼서 붙여보는 경우가 있지만, 장기 운영에서는 신뢰된 CA 인증서를 맞춰 가는 편이 훨씬 안전하다.

현장에서 자주 마주치는 n8n Postgres 오류 사례

n8n과 Postgres 연동 오류는 크게 보면 세 층에서 나온다. 첫째는 연결 자체가 안 되는 네트워크 층, 둘째는 인증이나 권한이 막히는 인증 층, 셋째는 쿼리는 실행되지만 문법이나 입력값 때문에 깨지는 실행 층이다. 이 셋을 섞어 보면 원인 찾기가 더 어려워진다. 그래서 오류 메시지를 볼 때는 “지금 어디서 멈췄는가”부터 먼저 구분하는 편이 낫다.

오류 메시지원인 및 해결 방향
connect ECONNREFUSEDPostgres가 해당 주소/포트에서 연결을 받지 않거나, 방화벽·보안 그룹·포트 바인딩이 막고 있을 가능성이 크다. listen_addresses, 포트 공개 여부, 네트워크 경로를 먼저 본다.
role “xxx” does not exist해당 사용자가 실제로 없거나, 오타가 있거나, 기대한 계정과 다른 계정으로 접속 중이다. 먼저 CREATE ROLE보다 현재 어떤 User로 접속을 시도하는지부터 다시 확인하는 편이 빠르다.
no pg_hba.conf entry현재 접속 출발지 IP, 사용자, DB 조합에 맞는 pg_hba.conf 규칙이 없다는 뜻이다. 네트워크 대역과 인증 방식을 좁혀서 다시 지정해야 한다.
syntax error at or near “{{“SQL 안에 {{ }} 표현식을 직접 끼워 넣어 파서가 문법 오류를 낸 경우다. Query Parameters와 플레이스홀더를 사용하는 쪽으로 바꾸는 것이 안전하다.

3. 쿼리 파라미터 바인딩의 필요성과 안전한 실행

n8n의 Postgres 노드는 Query Parameters 기능을 제공한다. 이건 단순 편의 기능이 아니라, 실제 운영에서 꽤 중요한 안전장치다. 문자열 안에 따옴표가 들어가거나, 특수문자가 섞이거나, 외부 입력이 그대로 SQL에 꽂힐 때 생기는 오류와 위험을 줄여준다.

원문처럼 SQL 안에 {{ }}를 직접 써 넣다가 깨지는 사례는 정말 흔하다. n8n에서는 표현식이 편해서 뭐든 템플릿처럼 넣고 싶어지는데, SQL은 그 방식이 늘 안전한 게 아니다. 보통은 쿼리에 $1, $2 같은 플레이스홀더를 쓰고, Parameters 쪽에 값을 따로 넣는 편이 더 안정적이다.

예를 들면 SELECT * FROM users WHERE email = $1처럼 쓰고, Parameters에는 이메일 값을 넣는 식이다. 이렇게 하면 입력값이 따옴표나 특수문자를 포함하더라도 구문 오류 위험이 크게 줄고, SQL 인젝션 위험도 낮아진다. 실제로는 문법 오류를 덜 보는 쪽에서 체감이 더 빠르게 온다. “보안”보다 “왜 자꾸 쿼리가 깨지지?”를 먼저 해결해주는 느낌에 가깝다.

4. Docker 환경에서의 호스트 이름 설정

Docker Compose 환경에서는 이 부분이 정말 자주 꼬인다. n8n과 Postgres를 한 번에 띄울 때, n8n 크리덴셜에서 Host를 습관적으로 localhost라고 넣으면 거의 항상 막힌다. 왜냐하면 컨테이너 내부에서 localhost는 같은 컨테이너 자신만 가리키기 때문이다. Postgres 컨테이너는 다른 프로세스다.

예를 들어 아래처럼 Compose에 서비스가 정의되어 있다면, 같은 네트워크 안에서는 Host를 보통 postgres로 넣는다.

services:
  n8n:
    ...
  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: mydb
      POSTGRES_USER: n8n_user
      POSTGRES_PASSWORD: securepass

이 구조에서는 n8n이 Postgres를 postgres:5432로 찾는다. 물론 Postgres가 다른 서버라면 이야기가 달라진다. 그래서 이 부분은 “Docker = 서비스명”이라는 공식보다, “n8n 컨테이너에서 지금 Postgres가 어디로 보이느냐”를 먼저 생각하는 게 핵심이다. 실제로는 Compose 파일만 보고도 원인을 꽤 빨리 찾을 수 있는 경우가 많다.

📌 핵심 포인트 & 주의사항

PostgreSQL은 로컬 소켓 연결과 TCP 연결에서 인증 흐름이 다르게 보일 수 있다. 같은 서버에 있다 해도 Docker처럼 TCP/IP로 들어오면 peer나 ident가 아니라 md5 또는 scram-sha-256 기반 규칙이 적용되어야 하는 경우가 많다. 즉 “psql로는 되는데 n8n에서는 안 된다”면, 비밀번호보다 먼저 접속 방식과 pg_hba.conf 인증 메서드 차이를 보는 편이 훨씬 빠르다.

직접 확인해보면 좋은 테스트 예시

이런 글은 연결 원리만 설명하면 금방 추상적으로 보인다. 실제로는 테스트를 어떻게 해보느냐가 더 중요하다. 아래처럼 일부러 다른 유형의 오류를 만들어보고, 기대 결과와 실제 확인 포인트를 같이 보면 어디서 막히는지 훨씬 빨리 보인다.

1. Host 해석 오류 테스트

테스트 예시

환경: Docker Compose
설정 A: Host = localhost
설정 B: Host = postgres

기대 결과
같은 Compose 네트워크 안이라면 설정 A는 실패하고, 설정 B가 성공하는 경우가 많다.

실제 확인 포인트
n8n 컨테이너 안에서 ping postgres 또는 네트워크 도달 여부를 확인하고, 실패 메시지가 인증이 아니라 연결 거부 층에서 나는지 본다.

2. pg_hba.conf 규칙 누락 테스트

테스트 예시

허용 전:
no pg_hba.conf entry for host ...

허용 후:
특정 IP 대역만 추가
Postgres reload 또는 restart

기대 결과
올바른 네트워크 대역과 사용자 규칙을 추가한 뒤에는 같은 연결이 통과되어야 한다.

실제 확인 포인트
설정 파일을 바꾼 뒤 실제로 reload/restart를 했는지, 허용 범위를 너무 넓게 열지 않았는지, 같은 User/DB 조합으로 다시 테스트했는지 확인한다.

3. 파라미터 바인딩 테스트

테스트 예시

쿼리 A:
SELECT * FROM users WHERE email = '{{ $json.email }}'

쿼리 B:
SELECT * FROM users WHERE email = $1
Parameters:
{{ $json.email }}

기대 결과
쿼리 B가 따옴표와 특수문자 처리에서 더 안정적으로 동작해야 한다.

실제 확인 포인트
이메일 값에 특수문자나 작은따옴표가 들어갔을 때 A는 깨질 수 있고 B는 통과하는지 확인한다.

4. SSL 강제 환경 테스트

테스트 예시

환경: AWS RDS / Azure Database for PostgreSQL
설정 A: SSL 비활성
설정 B: SSL 활성

기대 결과
관리형 DB에서 SSL 요구 조건이 있다면 설정 A는 실패하고 B가 통과해야 한다.

실제 확인 포인트
단순 연결 성공만 보지 말고, 인증서 검증 옵션과 장기 운영 시 CA 인증서 마운트 계획까지 같이 확인한다.

실제 검증 실행 결과

실제 검증 기준으로 보면 가장 먼저 차이가 난 건 비밀번호보다 Host와 pg_hba.conf 쪽이었다. Docker Compose 환경에서 Host를 localhost로 둔 상태에서는 연결이 되지 않았고, 같은 설정에서 서비스명으로 바꾸자 바로 붙는 경우가 있었다. 반대로 사용자 계정과 비밀번호가 맞아도 pg_hba.conf 규칙이 빠져 있으면 인증 단계 이전에서 거부되는 경우가 분명히 보였다. 또 쿼리 쪽에서는 {{ }}를 직접 꽂은 방식보다 파라미터 바인딩 쪽이 문법 오류와 특수문자 처리에서 훨씬 덜 흔들렸다. 결국 Postgres 연동은 “값 몇 개 잘 넣기”보다, 지금 어디서 실패하는지 층을 나눠 보는 쪽이 훨씬 빨리 해결된다.

실무에서 자주 놓치는 운영 포인트

5. 권한은 접속 성공 이후에 다시 봐야 한다

연결이 됐다고 끝이 아니다. 어떤 계정은 접속은 되는데 SELECT만 되고 INSERT는 안 되거나, 특정 스키마에만 접근이 안 되는 식의 권한 문제가 뒤늦게 나온다. 그래서 Postgres 연동은 연결 성공과 쿼리 성공을 분리해서 보는 편이 더 정확하다.

특히 운영 계정을 슈퍼유저로 대충 열어두고 시작하면 초반에는 편할 수 있다. 하지만 장기적으로는 권한을 너무 넓게 준 계정 하나가 자동화 전체의 위험 지점이 된다. 그래서 실제로는 n8n 전용 사용자, 필요한 DB와 스키마, 최소 권한 정도는 따로 설계하는 편이 낫다.

6. 시간대(timezone) 문제는 연결보다 늦게 터진다

시간대 문제는 연결 오류처럼 바로 티가 나지 않아서 더 골치 아프다. 쿼리는 잘 들어가는데, 저장된 시간이 실제 기대와 몇 시간씩 어긋나는 식으로 뒤늦게 드러난다. Postgres 서버의 timezone, n8n 실행 환경의 timezone, 그리고 쿼리 안에서 다루는 timestamp 타입이 서로 다르면 이런 일이 쉽게 생긴다.

이 경우에는 TZ=Asia/Seoul 같은 환경 변수 설정만 믿기보다, Postgres 쪽 timezone과 애플리케이션 입력값이 어떤 기준인지 같이 보는 편이 더 안전하다. 특히 로그 기준 시간과 DB 저장 시간이 엇갈리면 원인 추적이 더 어려워진다.

7. 운영형 구조라면 SQLite와 역할을 구분해서 생각해야 한다

n8n 내부 메타데이터 저장소와, 워크플로우가 업무 데이터를 다루는 외부 PostgreSQL은 역할이 다르다. 초반에는 이 둘이 머릿속에서 섞이기 쉽다. 예를 들어 “n8n이 PostgreSQL을 써야 하나요?”라는 질문은, n8n 자체 DB를 PostgreSQL로 둘지와 Postgres 노드로 외부 업무 데이터를 다룰지를 나눠서 봐야 더 정확하다.

장기 운영에서는 n8n 내부 DB와 외부 업무 DB를 혼동하지 않는 게 중요하다. 연결 오류를 잡을 때도 지금 내가 붙이려는 대상이 n8n의 메타데이터 DB인지, 워크플로우 안에서 쓰는 외부 Postgres인지 구분해야 진단이 덜 꼬인다.

FAQ: 자주 묻는 질문

Q. n8n의 Postgres 노드에서 INSERT 후 생성된 ID 값을 다음 노드에서 활용하려면 어떻게 해야 할까?

A. SQL에 RETURNING 절을 넣으면 된다. 예를 들어 INSERT INTO users (name) VALUES ($1) RETURNING id처럼 쓰면, 결과 데이터에 생성된 ID가 포함되어 다음 노드에서 참조할 수 있다.

Q. AWS RDS의 Postgres에 n8n을 연결할 때 SSL 오류가 나타난다면?

A. 관리형 PostgreSQL 서비스는 SSL 연결을 요구하거나 권장하는 경우가 많다. 우선 n8n 크리덴셜에서 SSL 옵션을 켜고, 테스트 단계에서는 검증 설정을 완화해 붙여볼 수 있다. 다만 장기 운영에서는 신뢰된 CA 인증서를 맞춰서 검증을 유지하는 쪽이 더 안전하다.

Q. n8n Postgres 연동 시 저장되는 데이터의 시간대가 맞지 않는다면?

A. Postgres 서버의 timezone, n8n 실행 환경의 timezone, 쿼리에서 다루는 timestamp 타입이 서로 다를 수 있다. 이럴 때는 쿼리에서 명시적으로 변환하거나, 컨테이너의 TZ 설정과 DB 서버 timezone을 같이 확인하는 편이 좋다.

Q. Docker Compose에서 Host를 서비스명으로 바꿨는데도 연결이 안 되면 어디를 봐야 하나요?

A. 그 경우는 Host 해석 다음 단계인 포트, 같은 네트워크 연결 여부, PostgreSQL의 listen_addresses, pg_hba.conf 규칙, 실제 사용자/비밀번호 순서로 좁혀가는 편이 빠르다. 서비스명만 맞춘다고 끝나는 문제는 아니다.


n8n과 Postgres의 연동은 겉으로 보기엔 단순한 연결 설정처럼 보이지만, 실제로는 네트워크, 인증, 권한, 쿼리 실행 방식이 다 맞물려 돌아가야 안정적으로 유지된다. 그래서 문제를 만났을 때도 “왜 안 되지?”라고 한 번에 보지 말고, 연결 층·인증 층·쿼리 층으로 나눠 보는 쪽이 훨씬 빠르다.

독자 입장에서 바로 체감되는 이득도 분명하다. Host 해석, pg_hba.conf, SSL, 파라미터 바인딩만 제대로 잡아도, “분명 같은 값인데 왜 안 되지?” 같은 답답한 시간을 꽤 줄일 수 있다. 결국 자동화의 안정성은 눈에 보이는 노드 설계보다, 그 아래 연결 구조가 얼마나 견고한지에서 먼저 갈린다.

직접 여러 번 붙여보니, Postgres 연동은 한 번에 완성되는 설정이라기보다 오류 층을 하나씩 줄여가며 단단하게 만드는 과정에 더 가까웠다. 초반에는 비밀번호부터 다시 넣기 쉽지만, 결국 오래 남는 건 네트워크와 인증 구조를 정확히 이해하고 맞춘 쪽이었다.

실제로 적용할 때 체크할 부분

이 글을 읽고 바로 적용해보려면 먼저 현재 n8n이 어디에서 실행 중인지부터 분명히 정리하는 것이 좋다. 로컬인지, Docker인지, VPS인지, 클라우드 관리형 DB인지가 정리되면 Host와 SSL, 접근 허용 범위 설정이 훨씬 빨리 좁혀진다.

그다음에는 연결 테스트 → 인증 테스트 → 간단한 SELECT 쿼리 → 파라미터 바인딩 쿼리 → INSERT/RETURNING 테스트 순으로 한 단계씩 확인하는 편이 가장 덜 꼬인다. 한 번에 모든 자동화를 붙이지 말고, 연결이 단단한지부터 먼저 보는 것이 훨씬 현실적인 출발점이다.


참고 자료: n8n 공식 문서 – Postgres 노드 | n8n 공식 문서 – Postgres 노드 common issues | n8n 공식 문서 – Docker 설치

Postgres는 값 몇 칸만 맞춘다고 끝나는 유형이 아니라, 인증 정책과 네트워크 허용 범위를 함께 봐야 안정적으로 붙는다. 그래서 이 글도 단순 기능 소개보다, 실제로 다시 손댈 때 바로 체크할 수 있는 기준이 남도록 흐름을 정리하는 쪽이 더 유용하다.

Eddy Glen
Eddy Glen

Eddy Glen은 n8n 자동화와 워드프레스 연동, API 기반 업무 자동화를 중심으로 콘텐츠를 운영합니다. 이 사이트에서는 설치, 업데이트, 오류 해결, 실전 적용 과정에서 자주 막히는 지점을 중심으로 글을 정리하며, 공식 문서와 실제 적용 흐름을 함께 검토해 내용을 구성합니다.

기사 : 72

댓글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다