🚀 n8n + PostgreSQL Docker Compose 설치 튜토리얼

안녕하세요! 오늘은 자동화 워크플로우 툴인 n8n을 PostgreSQL 데이터베이스와 함께 Docker Compose로 설치하는 방법을 알려드리려고 합니다.

조금 복잡해 보일 수 있지만, 차근차근 따라오시면 누구나 쉽게 n8n을 실행할 수 있습니다.

---

n8n이 뭐예요?

n8n은 오픈소스 워크플로우 자동화 툴이에요.
쉽게 말해, 반복적인 작업을 자동화해주는 프로그램입니다.

예를 들어:

• 이메일이 오면 자동으로 구글 시트에 기록
• RSS 피드에서 새 글이 올라오면 Slack으로 알림 보내기
• API에서 데이터 가져와서 DB에 저장

이런 걸 클릭 몇 번만으로 만들 수 있답니다.

---

1. Docker Compose 파일 준비

먼저, docker-compose.yml 파일을 하나 만듭니다.
아래 내용을 그대로 복사해서 붙여 넣어 주세요.

version: '3.8'

services:
  postgres:
    image: postgres:16
    container_name: postgres_n8n
    restart: always
    environment:
      POSTGRES_USER: n8nuser
      POSTGRES_PASSWORD: yourpasswd # 꼭 다른 비밀번호로 변경!
      POSTGRES_DB: n8n
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - n8n_network

  n8n:
    image: n8nio/n8n:1.114.2 # 특정 버전으로 실행
    container_name: n8n_workflow
    restart: always
    ports:
      - "5678:5678"
    environment:
      DB_TYPE: 'postgresdb'
      DB_POSTGRESDB_HOST: postgres_n8n
      DB_POSTGRESDB_PORT: 5432
      DB_POSTGRESDB_DATABASE: n8n
      DB_POSTGRESDB_USER: n8nuser
      DB_POSTGRESDB_PASSWORD: yourpasswd # 위에서 입력한 비밀번호와 동일해야 함
      N8N_ENCRYPTION_KEY: 'secretkey425524qdfe' # 꼭 자신만의 키로 변경!
      NODE_FUNCTION_ALLOW_EXTERNAL: '*' # 외부 모듈 사용 가능
      GENERIC_TIMEZONE: 'Asia/Seoul'
      WEBHOOK_URL: 'https://your-domain.com' # 도메인이 없다면 이 줄은 지워도 됨
    volumes:
      - D:/Docker/n8n:/home/node/.n8n # 윈도우 기준 저장 경로
    depends_on:
      - postgres
    networks:
      - n8n_network

volumes:
  postgres_data:

networks:
  n8n_network:

---

2. 환경 변수(설정 값) 살펴보기

이 부분은 꼭 확인해 주세요 👇

• POSTGRES_PASSWORD: DB 비밀번호 → 절대 그대로 두지 말고 자신만의 비밀번호로 바꾸세요.
• N8N_ENCRYPTION_KEY: 워크플로우 안의 민감 정보를 암호화하는 키 → 꼭 랜덤 문자열로 변경하세요.
• WEBHOOK_URL: 도메인이 없다면 그냥 주석 처리하거나 삭제해도 됩니다.
• volumes: n8n과 PostgreSQL의 데이터를 영구 저장할 경로입니다. (윈도우/리눅스 환경에 맞게 수정하세요.)

---

3. 실행하기

터미널(또는 PowerShell)을 열고 docker-compose.yml이 있는 폴더로 이동한 뒤 아래 명령어를 입력합니다.

docker-compose up -d

잠시 기다리면 PostgreSQL과 n8n이 동시에 실행돼요.

---

4. 접속해보기

브라우저에서 아래 주소를 입력하세요.

http://localhost:5678

n8n 초기 화면이 뜨면 성공입니다 🎉

---

5. 마무리

여기까지 따라오셨다면 이제 n8n을 PostgreSQL과 함께 안정적으로 실행할 수 있습니다.

• 테스트 용도라면 SQLite로도 충분하지만,
• 실제 운영 환경에서는 PostgreSQL을 쓰는 게 훨씬 안전합니다.

이제부터는 직접 워크플로우를 만들고, 반복적인 작업을 마음껏 자동화해보세요.