Cloudflare Tunnel 구성하여 n8n 서비스 방법

tunnel: <터널-UUID-또는-이름>
credentials-file: /root/.cloudflared/<터널-UUID>.json # 실제 경로와 파일명으로 변경 필요

ingress:
  # 1. 특정 도메인에 대한 트래픽을 로컬 포트 5678로 라우팅
  - hostname: my-app.example.com
    service: http://localhost:5678 # 로컬 서비스 주소 및 포트 지정 (http 또는 https)

  # 2. 다른 도메인 또는 경로를 위한 추가 규칙을 정의할 수 있습니다.
  # 예시:
  # - hostname: another-app.example.com
  #   service: http://localhost:8080 
  
  # 3. 마지막 규칙: 위에 정의된 호스트 이름과 일치하지 않는 모든 트래픽에 대한 폴백 처리 (일반적으로 404 반환)
  - service: http_status:404 

cloudflared tunnel run <터널-UUID-또는-이름>

# .env 파일 내용

# n8n 서비스 환경 설정
N8N_HOST=n8n.your-domain.com           # n8n에 접근할 도메인 (필수)
WEBHOOK_URL=https://n8n.your-domain.com/ # 웹훅 리디렉션 URL (필수)
N8N_PORT=5678                          # n8n 컨테이너 내부 포트 (기본값 5678)
N8N_PROTOCOL=https                     # Cloudflare가 HTTPS로 트래픽을 처리하므로 https로 설정
GENERIC_TIMEZONE=Asia/Seoul            # 원하는 시간대로 변경

# Cloudflare Tunnel 설정 (필수)
# Cloudflare Zero Trust 대시보드에서 발급받은 실제 토큰으로 변경하세요.
TUNNEL_TOKEN=eyJhIjoi...

version: '3.7'

services:
  # n8n 서비스 정의 (로컬 포트 5678에서 실행)
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n
    restart: unless-stopped
    # n8n이 사용할 환경 변수 설정
    environment:
      - N8N_HOST=${N8N_HOST}
      - WEBHOOK_URL=${WEBHOOK_URL}
      - N8N_PORT=${N8N_PORT}
      - N8N_PROTOCOL=${N8N_PROTOCOL}
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      # 데이터베이스/인증 관련 추가 변수를 여기에 설정할 수 있습니다. (예: POSTGRES_USER 등)
    
    # Cloudflared가 n8n 서비스에 접근할 수 있도록 네트워크에 연결
    # 외부 포트를 호스트에 직접 노출하지 않습니다.
    # ports:
    #   - "5678:5678" # Cloudflare Tunnel을 사용하므로 주석 처리하는 것이 보안상 좋습니다.
      
    # n8n 데이터 영구 저장을 위한 볼륨
    volumes:
      - n8n_data:/home/node/.n8n

  # Cloudflare Tunnel 서비스 정의 (n8n 서비스로 트래픽을 라우팅)
  cloudflared:
    image: cloudflare/cloudflared:latest
    container_name: cloudflared
    restart: unless-stopped
    depends_on:
      - n8n # n8n이 먼저 시작되도록 의존성 설정
    
    # cloudflared 컨테이너에 환경 변수 전달
    environment:
      - TUNNEL_TOKEN=${TUNNEL_TOKEN}
      
    # Tunnel 명령 실행
    command: tunnel --no-autoupdate run --token ${TUNNEL_TOKEN}
    
    # (선택) 외부에서 접근할 수 있도록 클라우드플레어 인증 파일을 마운트할 수도 있습니다.
    # volumes:
    #   - ~/.cloudflared/cert.pem:/home/nonroot/.cloudflared/cert.pem 

# 데이터 영구 저장을 위한 Docker 볼륨
volumes:
  n8n_data:

# (선택) 클라우드플레어 Tunnel이 컨테이너 이름으로 n8n에 접근하기 위해 사용되는 네트워크
# bridge 네트워크를 사용하면 n8n 컨테이너 이름을 service: http://n8n:5678로 사용할 수 있습니다.
networks:
  default:
    name: n8n-cloudflare-network

docker-compose up -d