n8n은 다양한 서비스를 연결하고 복잡한 프로세스를 자동화할 수 있는 강력한 워크플로 자동화 도구입니다.
하지만 워크플로에 너무 많은 요청이 몰리기 시작하면 어떻게 될까요? 적절한 속도 제한(rate limiting)이 없다면 API에 과부하가 걸리거나, 외부 서비스의 호출 한도를 초과하거나, 심한 경우 워크플로 자체가 중단될 수도 있습니다.
이 글에서는 Upstash Redis를 활용해 n8n 워크플로에 견고한 속도 제한 기능을 추가하는 방법을 소개합니다. 간단하고 효과적이며, 필요에 따라 손쉽게 확장할 수 있는 방식입니다.
해결해야 할 과제: n8n 워크플로 보호
웹훅(webhook)이나 API 엔드포인트처럼 외부 요청을 처리하는 n8n 워크플로를 만들 때는 다음 사항들을 고려해야 합니다.
- API 남용 방지: 악의적인 사용자가 워크플로에 과도한 요청을 보내는 것을 차단합니다.
- 외부 서비스 보호: 서드파티 API의 호출 한도를 준수하도록 합니다.
- 리소스 관리: 워크플로가 과도한 리소스를 소비하는 것을 방지합니다.
- 비용 통제: 과도한 API 호출로 인한 예상치 못한 비용 발생을 막습니다.
Upstash Redis와 n8n을 함께 사용하면 단 몇 개의 노드만으로 속도 제한 시스템을 구축할 수 있습니다. 더불어 Upstash Redis가 제공하는 다양한 장점도 그대로 누릴 수 있습니다(자세한 내용은 공식 문서 참조).
n8n에서 Upstash Redis 연동 시작하기
구현에 들어가기 전에 먼저 Upstash Redis 계정을 n8n의 Redis 노드에 연결하세요. 이 가이드 전체에서 이 설정을 사용하게 됩니다(n8n과 Upstash Redis 연동 방법은 관련 문서를 참고하세요).
속도 제한 워크플로 만들기
이제 각 노드를 하나씩 살펴보며 실제 구현을 시작해 보겠습니다. 생각보다 훨씬 간단합니다.
1단계: 웹훅 트리거(Webhook Trigger)
Webhook 노드부터 시작합니다. 이 노드는 들어오는 요청을 받는 진입점 역할을 합니다.
기본 설정 그대로 두면 되며, 테스트 용도로 활용됩니다.
2단계: 필드 편집(Edit Field) 노드
다음으로 Edit Field 노드를 생성합니다. 이 노드는 Redis 키 이름을 USER_IP:REQUEST_MINUTE 형식으로 저장합니다. 형식은 필요에 따라 자유롭게 수정할 수 있습니다. 이 예제에서는 IP 기반으로 속도 제한을 적용하며, 제한 주기는 분 단위입니다.
3단계: Increment 액션이 포함된 Redis 노드
앞서 설명한 대로 Upstash Redis에 연결된 Redis 노드를 만듭니다. 이전 단계에서 설정한 필드를 Redis 키로 사용합니다. Increment 액션을 사용하면 첫 번째 요청에서 해당 키가 생성되고, 이후 요청마다 값이 1씩 증가합니다.
TTL은 60초로 설정하세요. 그러면 키가 1분 후 자동으로 삭제되어 저장 공간이 확보됩니다.
4단계: 조건 분기를 위한 IF 노드
IF 노드를 추가하여 허용된 요청과 차단된 요청을 구분합니다. 마찬가지로 2단계에서 설정한 필드를 JSON 파라미터로 사용해 3단계의 결과를 가져옵니다. 이 결과값은 해당 사용자가 엔드포인트로 보낸 요청 횟수입니다. 이 예제에서는 최대 4회까지 허용하고, 초과된 요청은 다음 분이 될 때까지 차단합니다.
5-1단계: 성공 응답(Success Response)
속도 제한을 초과하지 않았다면 사용자가 엔드포인트를 호출할 수 있도록 허용합니다. 실제 비즈니스 로직은 이 검증 뒤에 배치하여 과부하나 남용으로부터 보호하세요.
테스트 목적으로 간단한 성공 메시지를 반환하도록 구성했습니다.
5-2단계: 실패 응답(Fail Response)
제한을 초과하면 이후 요청은 차단됩니다.
테스트 목적으로 간단한 실패 메시지를 반환하도록 구성했습니다.
워크플로 테스트하기
웹훅에 정의된 URL로 GET 요청을 전송해 보세요.
1분 안에 처음 4개의 요청은 통과 경로를 따라가고, 그 이후의 요청은 차단되어 제한 경로로 이동합니다.
이것으로 n8n에서 속도 제한 구현을 완료했습니다!
커스터마이징 및 개선 아이디어
이 기본 구현은 탄탄한 기반이 되며, 필요에 따라 쉽게 커스터마이징하고 확장할 수 있습니다.
시간 창(Time Window) 조정
- 시간당 제한: TTL을 3600초로 변경하면 시간 단위 속도 제한이 됩니다.
- 일일 제한: TTL을 86400초로 설정하면 하루 기준 요청 제한이 됩니다.
- 사용자 지정 창: TTL을 원하는 기간으로 조정해 유스케이스에 맞출 수 있습니다.
다양한 제한 전략
- 사용자 기반 제한: 인증된 요청의 경우 IP 대신
Authorization헤더의 사용자 ID를 활용할 수 있습니다. - 엔드포인트별 제한: 리소스 요구량에 따라 엔드포인트마다 다른 제한치를 설정할 수 있습니다.
- 지역 기반 제한:
X-Forwarded-For또는CF-IPCountry헤더를 사용해 국가 또는 지역별로 속도를 제한할 수 있습니다.
오류 처리
- 재시도 메커니즘: Upstash Redis는 기본적으로 재시도 기능을 제공합니다.
- 서킷 브레이커 패턴: Redis 장애 발생 시 일시적으로 속도 제한을 해제할 수 있습니다.
모니터링 및 분석
- 실시간 대시보드: Upstash 콘솔에서 속도 제한 적중률과 위반 사항을 모니터링합니다.
- 사용 패턴 분석: 요청 패턴을 분석해 제한치를 최적화합니다.
- 알림 시스템: 비정상적인 트래픽 급증 시 알림을 받도록 설정합니다.
- 성능 지표: 응답 시간과 시스템 상태를 추적합니다.
마무리
이 알고리즘의 매력은 단순함과 확장성에 있습니다. 기본적인 IP 기반 제한으로 시작해서, 필요가 늘어남에 따라 사용자 인증, 등급별 제한, 고급 모니터링 같은 정교한 기능을 점진적으로 추가할 수 있습니다.
n8n 워크플로 자동화 플랫폼과 Upstash Redis의 강력한 기능을 결합하면, 여러분의 요구사항에 딱 맞는 견고하고 확장 가능한 속도 제한 솔루션을 무한히 만들어 낼 수 있습니다.
더 읽을거리
속도 제한과 n8n에 대해 더 깊이 알아보고 싶다면 다음 자료들을 확인해 보세요.
- Upstash Redis 공식 문서
- n8n 공식 문서
- 속도 제한 알고리즘 관련 자료