인프런 커뮤니티 질문&답변

docker-compose.yml 파일 입니다.

# Docker Compose 파일에서 사용할 최상위 볼륨을 미리 정의합니다.
# 여기서 정의된 이름으로 각 서비스에서 데이터를 영구적으로 저장할 수 있습니다.
volumes:
  n8n_storage:      # n8n의 설정, 데이터베이스 파일 등을 저장하기 위한 볼륨
  postgres_storage: # PostgreSQL 데이터베이스 파일을 저장하기 위한 볼륨
  qdrant_storage:   # Qdrant 벡터 데이터베이스 파일을 저장하기 위한 볼륨

# 서비스들이 서로 통신할 수 있도록 사용자 정의 네트워크를 생성합니다.
networks:
  demo:

# 'x-*'는 YAML의 'Extension Fields' 기능으로, 재사용할 설정 묶음을 정의할 때 사용합니다.
# '&service-n8n'은 'service-n8n'이라는 이름의 앵커(anchor)를 정의하는 것입니다.
# 이 앵커는 아래 n8n 관련 서비스에서 '<<: *service-n8n' 형태로 참조하여 설정을 그대로 가져와 사용합니다.
x-n8n: &service-n8n
  image: n8nio/n8n:1.123.9 # 사용할 n8n 도커 이미지 (최신 버전)
  networks: ['demo']        # 'demo' 네트워크에 연결
  environment:              # 컨테이너 내에서 사용할 환경 변수 설정
    # n8n에 접속할 외부 도메인 주소. '도메인주소' 부분은 실제 사용하는 도메인으로 변경해야 합니다.    
    - WEBHOOK_URL=https://n8n.thelimin.com
    - N8N_EDITOR_BASE_URL=https://n8n.thelimin.com
    - N8N_HOST=n8n.thelimin.com
    - N8N_CORS_ORIGIN=https://n8n.thelimin.com
    - N8N_SECURE_COOKIE=false # HTTPS를 사용하지 않을 경우 false로 설정. HTTPS 프록시 뒤에 있다면 true로 설정하는 것이 안전합니다.
    - TZ=Asia/Seoul           # 컨테이너의 시간대를 서울로 설정
    - N8N_PAYLOAD_SIZE_MAX=32 # 워크플로우에서 처리할 수 있는 최대 페이로드 크기 (MB 단위)
    - N8N_REQUEST_MAX_SIZE=100MB # 수신 요청의 최대 크기
    - N8N_PUSH_BACKEND=websocket    # 프론트엔드로 푸시 알림을 보낼 때 사용할 기술 (Server-Sent Events)
    #- N8N_PUSH_BACKEND=sse    # 프론트엔드로 푸시 알림을 보낼 때 사용할 기술 (Server-Sent Events)
    # 데이터베이스 연결 정보
    - DB_TYPE=postgresdb             # 사용할 데이터베이스 종류
    - DB_POSTGRESDB_HOST=postgres    # DB 호스트명 (아래 postgres 서비스의 hostname과 일치)
    - DB_POSTGRESDB_USER=${POSTGRES_USER} # DB 사용자명 (.env 파일에서 값을 가져옴)
    - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD} # DB 비밀번호 (.env 파일에서 값을 가져옴)
    # n8n의 익명 데이터 수집 기능 비활성화
    - N8N_DIAGNOSTICS_ENABLED=false
    - N8N_PERSONALIZATION_ENABLED=false
    # 보안을 위한 암호화 키와 JWT 시크릿. .env 파일에서 값을 설정해야 합니다.
    - N8N_ENCRYPTION_KEY
    - N8N_USER_MANAGEMENT_JWT_SECRET
  env_file: # 환경 변수를 파일에서 불러오기
    - path: .env      # 현재 디렉토리의 .env 파일
      required: true  # .env 파일이 반드시 있어야 함

# 실제로 실행할 컨테이너(서비스)들을 정의하는 부분입니다.
services:
  # PostgreSQL 데이터베이스 서비스
  postgres:
    image: postgres:16-alpine # 사용할 PostgreSQL 이미지 (16-alpine 버전)
    hostname: postgres        # 컨테이너 내부 및 다른 서비스에서 이 서비스를 호출할 때 사용할 이름
    networks: ['demo']        # 'demo' 네트워크에 연결
    restart: unless-stopped   # 사용자가 직접 중지하지 않는 한, 오류 발생 시 항상 다시 시작
    environment:              # .env 파일에서 DB 접속 정보를 가져와 환경 변수로 설정
      - POSTGRES_USER
      - POSTGRES_PASSWORD
      - POSTGRES_DB
    volumes:
      # 호스트의 './postgres_storage' 디렉토리를 컨테이너의 '/var/lib/postgresql/data'에 연결합니다.
      # 이를 통해 컨테이너가 삭제되어도 데이터베이스 데이터가 보존됩니다.
      - ./postgres_storage:/var/lib/postgresql/data
    healthcheck: # 컨테이너가 정상적으로 작동하는지 확인하는 설정
      test: ['CMD-SHELL', 'pg_isready -h localhost -U ${POSTGRES_USER} -d ${POSTGRES_DB}'] # 정상 여부 확인 명령어
      interval: 5s  # 5초마다 확인
      timeout: 5s   # 응답 대기 시간 5초
      retries: 10   # 실패 시 10번 재시도

  # n8n 초기 데이터(워크플로우, 인증정보)를 임포트하는 일회성 서비스
  n8n-import:
    <<: *service-n8n # 위에서 정의한 'service-n8n' 앵커의 설정을 그대로 가져옴
    hostname: n8n-import
    container_name: n8n-import
    entrypoint: /bin/sh # 컨테이너 시작 시 실행할 기본 명령어를 변경
    command:            # entrypoint로 지정된 셸에서 실행할 실제 명령어
      - "-c"
      - "n8n import:credentials --separate --input=/demo-data/credentials && n8n import:workflow --separate --input=/demo-data/workflows"
    volumes:
      # 호스트의 './n8n/demo-data' 디렉토리를 컨테이너의 '/demo-data'에 연결하여 임포트할 파일에 접근
      - ./n8n/demo-data:/demo-data
    depends_on: # 서비스 시작 순서 및 의존성 정의
      postgres:
        condition: service_healthy # 'postgres' 서비스가 healthcheck를 통과하여 'healthy' 상태가 되면 시작

  # 메인 n8n 애플리케이션 서비스
  n8n:
    <<: *service-n8n # 'service-n8n' 앵커의 설정을 상속받음
    hostname: n8n
    container_name: n8n
    restart: unless-stopped   # 사용자가 직접 중지하지 않는 한 항상 다시 시작
    ports:
      # 호스트의 5678번 포트를 컨테이너의 5678번 포트로 연결하여 외부에서 n8n에 접속 가능하게 함
      - "5678:5678"
    volumes:
      # 호스트와 컨테이너 간의 디렉토리 연결 (데이터 영속성 및 공유)
      - ./n8n_storage:/home/node/.n8n # n8n의 주요 데이터 및 설정 저장
      - ./n8n/demo-data:/demo-data    # 데모 데이터 접근용
      - ./shared:/data/shared         # 파일 노드 등에서 사용할 공유 폴더
    depends_on: # 서비스 시작 순서 정의
      postgres:
        condition: service_healthy # 'postgres' 서비스가 'healthy' 상태일 때
      n8n-import:
        condition: service_completed_successfully # 'n8n-import' 서비스가 성공적으로 완료되었을 때 시작

  # Qdrant 벡터 데이터베이스 서비스 (AI/RAG 기능에 사용)
  qdrant:
    image: qdrant/qdrant # 사용할 Qdrant 이미지
    hostname: qdrant
    container_name: qdrant
    networks: ['demo']        # 'demo' 네트워크에 연결
    restart: unless-stopped   # 오류 시 항상 다시 시작
    ports:
      # 외부에서 Qdrant API에 접속할 수 있도록 포트 포워딩
      - "6333:6333" # HTTP API 포트
    volumes:
      # Qdrant 데이터를 호스트에 저장하여 영속성 확보
      - ./qdrant_storage:/qdrant/storage

n8n proxy-host conf파일입니다.

# ------------------------------------------------------------
# n8n.thelimin.com
# ------------------------------------------------------------



map $scheme $hsts_header {
    https   "max-age=63072000; preload";
}

server {
  set $forward_scheme http;
  set $server         "thelimin.com";
  set $port           5678;

  listen 80;
listen [::]:80;

listen 443 ssl;
listen [::]:443 ssl;


  server_name n8n.thelimin.com;

  http2 on;


  # Let's Encrypt SSL
  include conf.d/include/letsencrypt-acme-challenge.conf;
  include conf.d/include/ssl-cache.conf;
  include conf.d/include/ssl-ciphers.conf;
  ssl_certificate /etc/letsencrypt/live/npm-1/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/npm-1/privkey.pem;








  # HSTS (ngx_http_headers_module is required) (63072000 seconds = 2 years)
  add_header Strict-Transport-Security $hsts_header always;





    # Force SSL
    include conf.d/include/force-ssl.conf;





  access_log /data/logs/proxy-host-4_access.log proxy;
  error_log /data/logs/proxy-host-4_error.log warn;







  location / {





proxy_set_header   Host n8n.thelimin.com;
proxy_set_header   Origin https://n8n.thelimin.com;
proxy_set_header   X-Forwarded-Proto https;
proxy_set_header   Upgrade $http_upgrade;
proxy_set_header   Connection "Upgrade";
proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header   X-Real-IP $remote_addr;

    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Scheme $scheme;
    proxy_set_header X-Forwarded-Proto  $scheme;
    proxy_set_header X-Forwarded-For    $remote_addr;
    proxy_set_header X-Real-IP		$remote_addr;

    proxy_pass       http://thelimin.com:5678;






  # HSTS (ngx_http_headers_module is required) (63072000 seconds = 2 years)
  add_header Strict-Transport-Security $hsts_header always;





    

    # Proxy!
    include conf.d/include/proxy.conf;
  }


  # Custom
  include /data/nginx/custom/server_proxy[.]conf;
}

이부분 문제가 있을까요??
한번만 더 확인 부탁드립니다.
^^;

connection lost 의 원인은 NPM 프록시를 경유하면서 서버와 브라우저와의 통신이 일치하지 않아서 생기는 문제입니다. 그렇기 때문에 소프트웨어의 버전이 문제라기 보다는 n8n 의 동작 방식에서 websocket 이냐 sse 방식이냐와 이 정보가 프록시를 통해서 잘 전달 되고 있느냐를 설정하는게 중요한 포인트 입니다. docker-compose.yml 에서 이 정보는 N8N_PUSH_BACKEND 값에 의해 결정되며 이 값이 sse 냐 websocket 이냐로 설정할 수 있습니다.

proxy_set_header   Host n8n.blogagent.kr;
proxy_set_header   Origin https://n8n.blogagent.kr;
proxy_set_header   X-Forwarded-Proto https;
proxy_set_header   Upgrade $http_upgrade;
proxy_set_header   Connection "Upgrade";
proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header   X-Real-IP $remote_addr;

이게 제 NPM 헤더 설정 값입니다만 여기서 proxy_set_header Upgrade $http_upgrade 이 값이 중요한 포인트 입니다. Upgrade 헤더는 HTTP 연결을 다른 프로토콜로 전환하겠다는 요청을 의미하는 값인데 만약 N8N_PUSH_BACKEND 이 websocket 으로 설정되어있다면 반드시 NPM 헤더가 위와 같이 설정되어있어야 합니다.

만약 docker-compose.yml 에서는 websocket 으로 설정되어있는데 NPM 헤더에 proxy_set_header Upgrade $http_upgrade이 설정이 없다면 클라이언트는 websocket 방식으로 요청을 했는데 프록시 서버가 이 값을 백엔드(n8n)로 전달하지 못하기 때문에 Connection Lost가 발생하게 됩니다.

이 부분을 다시한번 확인해보시기 바랍니다.

안녕하세요, 인프런 AI 인턴입니다. stylebygio님.

n8n 설치 후 “Connection lost” 문제가 지속되고 있군요. 이 문제는 네트워크 설정, 버전 호환성, 또는 도커 및 Nginx 설정 관련 문제가 주된 원인이 될 수 있습니다. 특히 Ubuntu 서버에 직접 설치하시는 경우에는, 서버 설정이나 네트워크 구성에서 발생할 수 있는 문제도 고려해야 합니다. 아래에 몇 가지 해결 방안을 제안 드립니다:

네트워크 및 서버 환경 점검:

1. 포트 및 방화벽 설정:

   • n8n이 사용하는 포트(기본적으로 5678)가 올바르게 열려 있는지, 그리고 방화벽에서 차단되지 않는지를 확인하세요.
     

2. Nginx 및 Proxy 설정:

   • proxy_set_header 설정이 올바르게 구성되어 있는지 확인하세요. 웹소켓 통신을 위해 Upgrade와 Connection 헤더가 정확히 설정되어야 합니다.
     
   • Nginx가 설치된 서버에 올바르게 검증된 SSL 인증서가 설정되어 있는지도 확인해 보세요.
     

설치 환경 및 구성 점검:

1. 도커 및 n8n 버전:

   • 도커와 n8n의 버전이 가이드와 일치하는지, 그리고 도커 컨테이너가 정상적으로 실행되고 있는지 점검하세요. docker ps로 상태를 확인할 수 있습니다.
     

2. 로그 확인:

   • docker logs <n8n-container-id> 명령어로 n8n의 로그를 점검하여 추가적인 오류를 찾을 수 있습니다.
     

3. 커뮤니티 포럼 확인:

   • 비슷한 문제를 다룬 다른 사례를 참고하기 위해 n8n 커뮤니티 포럼에서 유사한 이슈를 찾아보세요.
     

유사 문제 해결 사례:

• n8n 접속이 안됩니다: 이전에 관련된 문제를 해결한 사례로, 도커 버전 문제와 N8n 설정 문제 해결 방안이 공유되었습니다.
  
• n8n Connection lost: Docker와 Nginx proxy 설정 관련 문제의 해결 경험이 있습니다.
  

위의 방법들이 도움이 되기를 바라며, 추가적인 도움이나 질문이 필요하시다면, 상세한 환경 정보를 포함하여 질문해 주세요. 곧 지식공유자께서도 상세한 답변을 제공해 주실 것입니다.

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.