🚀 n8n을 Docker Compose로 손쉽게 구축하고 활용하는 완벽 가이드

🌟 n8n이란?

n8n(에이트엔)은 오픈소스 워크플로우 자동화 툴로, 200개 이상의 서비스(Google Sheets, Slack, Telegram 등)를 연결해 복잡한 작업을 자동화합니다.
✅ 코드리스 인터페이스
✅ 자체 호스팅 가능
✅ 확장성 높은 노드 기반 구조
🔥 “If This Then That(IFTTT)”의 업무용 강화판이라고 생각하세요!

🐳 Docker Compose로 설치하는 이유

⚙️ 사전 준비

1. Docker 설치
   공식 문서 참고

   sudo apt update && sudo apt install docker.io docker-compose

2. 디렉토리 생성

   mkdir n8n-docker && cd n8n-docker

🛠️ docker-compose.yml 작성 (기본편)

version: '3.8'

services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"  # 웹 인터페이스 포트
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin  # 🔑 사용자명
      - N8N_BASIC_AUTH_PASSWORD=securepassword123!  # 🔒 비밀번호
    volumes:
      - n8n_data:/home/node/.n8n  # 데이터 지속성 보장
    networks:
      - n8n_network

volumes:
  n8n_data:  # 볼륨 생성

networks:
  n8n_network:

🔥 고급 설정 (DB + HTTPS)

version: '3.8'

services:
  postgres:
    image: postgres:13
    environment:
      POSTGRES_USER: n8n_user
      POSTGRES_PASSWORD: db_password123!
      POSTGRES_DB: n8n_db
    volumes:
      - pg_data:/var/lib/postgresql/data

  n8n:
    image: n8nio/n8n
    depends_on:
      - postgres
    environment:
      DB_TYPE: postgresdb
      DB_POSTGRESDB_DATABASE: n8n_db
      DB_POSTGRESDB_USER: n8n_user
      DB_POSTGRESDB_PASSWORD: db_password123!
      DB_POSTGRESDB_HOST: postgres
      N8N_HOST: yourdomain.com  # 🌐 도메인 설정
      N8N_PROTOCOL: https       # 🔐 HTTPS 강제 적용
      VUE_APP_URL_BASE_API: https://yourdomain.com/
    volumes:
      - n8n_data:/home/node/.n8n
    ports:
      - "443:5678"  # HTTPS 표준 포트 매핑

volumes:
  n8n_data:
  pg_data:

# 💡 Tip: Nginx 역방향 프록시 추가 시 보안 강화 가능!

🚀 실행 및 중지 명령어

# 시작
docker-compose up -d

# 상태 확인
docker-compose ps

# 로그 보기
docker-compose logs -f n8n

# 중지 (데이터 보존)
docker-compose down

📍 초기 설정 가이드

1. 접속 주소: http://서버IP:5678
   
2. 워크플로우 생성
   • ➕ Add Node로 트리거(시작점) 설정
   • 🔗 노드 연결해 자동화 흐름 구성
   • 예시: Gmail 수신 → Slack 알림 전송
3. 크레덴셜 저장
   🔐 통합 서비스 API 키를 안전하게 관리!

⚠️ 주의사항 & 최적화 팁

1. 보안 강화
   • 기본 인증 필수 (N8N_BASIC_AUTH_ACTIVE=true)
   • N8N_ENCRYPTION_KEY 설정으로 민감 데이터 암호화
2. 백업 전략

   # 볼륨 데이터 백업
   docker run --rm -v n8n_data:/source -v $(pwd):/backup busybox tar cvf /backup/n8n_backup.tar /source

3. 리소스 제한

   # docker-compose.yml 추가
   deploy:
   resources:
   limits:
     cpus: '1.0'
     memory: 2G

🎯 마무리

> “n8n + Docker Compose = 무한 자동화 가능성”
🚀 비즈니스 효율성 200% 향상
💡 상용 툴 대비 비용 절감 (자체 호스팅 무료!)
🔧 유연한 커스터마이징 가능

오늘 구성한 인프라로 매일 반복되는 업무를 자동화해보세요.
첫 워크플로우 실행 성공 시 여러분의 시간은 이미 절약되고 있습니다!

> ✨ 추천 다음 단계:
> – 공식 문서에서 고급 노드 학습
> – GitHub 연동으로 코드 푸시 시 알림 설정
> – 일일 리포트 자동 생성 워크플로우 구현

문의사항은 댓글로 남겨주세요. 함께 성장하는 IT 인프라 되길! 😊 D