셀프 호스팅 동시성 제어

셀프 호스팅 n8n에서 프로덕션 실행의 동시성 제한을 설정하고 큐를 관리하는 방법을 설명합니다.

셀프 호스팅 n8n 전용 이 문서는 셀프 호스팅 동시성 제어에 관한 내용입니다. n8n Cloud 계정에서 동시성이 어떻게 동작하는지 알아보려면 Cloud 동시성 을 읽어보세요. 일반 모드에서 n8n은 동시에 실행할 수 있는 프로덕션 실행 수를 제한하지 않습니다. 이로 인해 너무 많은 동시 실행이 이벤트 루프를 혼잡하게 만들어 성능 저하와 응답 불능 상태를 야기할 수 있습니다. 이를 방지하기 위해 일반 모드에서 프로덕션 실행에 대한 동시성 제한을 설정할 수 있습니다. 이를 통해 동시에 실행되는 프로덕션 실행 수를 제어하고, 제한을 초과하는 동시 프로덕션 실행을 큐에 추가할 수 있습니다. 이러한 실행은 동시성 용량이 확보될 때까지 큐에 유지되며, 이후 FIFO 순서로 처리됩니다. 동시성 제어는 기본적으로 비활성화되어 있습니다. 활성화하려면: export N8N_CONCURRENCY_PRODUCTION_LIMIT=20 유의사항: 동시성 제어는 웹훅 또는 트리거 노드에서 시작된 프로덕션 실행에만 적용됩니다. 수동 실행, 서브 워크플로 실행, 오류 실행, CLI에서 시작된 실행 등 다른 종류에는 적용되지 않습니다. 큐에 있는 실행을 재시도할 수 없습니다. 큐에 있는 실행을 취소하거나 삭제하면 큐에서도 제거됩니다. 인스턴스 시작 시, n8n은 동시성 제한까지 큐에 있는 실행을 재개하고 나머지는 다시 큐에 추가합니다. 동시성 제어를 모니터링하려면 실행이 큐에 추가되고 해제되는 로그를 확인하세요. 향후 버전에서 n8n은 UI에서 동시성 제어를 표시할 예정입니다. 동시성 제어를 활성화하면 프로젝트 또는 워크플로의 실행 탭 상단에서 활성 실행 수와 설정된 제한을 확인할 수 있습니다. 큐 모드와의 비교 # 큐 모드에서는 --concurrency 플래그 를 사용하여 워커가 동시에 실행할 수 있는 작업 수를 제어할 수 있습니다. 큐 모드의 동시성 제어는 일반 모드의 동시성 제어와 별개의 메커니즘이지만, 환경 변수 N8N_CONCURRENCY_PRODUCTION_LIMIT 이 두 경우 모두를 제어합니다. 큐 모드에서 n8n은 이 변수가 -1 이외의 값으로 설정된 경우 해당 값을 제한으로 사용하며, 그렇지 않으면 --concurrency 플래그 또는 기본값으로 대체합니다. 평가 동시성 # 평가 테스트 실행은 프로덕션 실행과 별도의 동시성 제한을 사용합니다. 기본적으로 제한은 인스턴스의 라이선스 등급을 따릅니다(Community/Pro 1, Business 3, Enterprise 5). N8N_CONCURRENCY_EVALUATION_LIMIT 으로 재정의할 수 있습니다. UI에서 슬라이더 동작 방식은 지표 기반 평가 를 참조하세요.