n8n 자체호스팅의 일반 모드에서는 환경 변수로 동시에 처리할 production 실행 수를 제한하고, 초과한 실행을 대기시킬 수 있습니다. 웹훅이나 트리거로 시작된 실행에 적용되는 이 동시 실행 제어를 별도의 Queue mode 도입과 혼동하지 않아야 합니다.
동시 실행 제어의 필요성 및 기본 원리
일반 모드에서 n8n은 동시에 실행될 수 있는 production 실행의 수를 제한하지 않습니다.
너무 많은 실행이 동시에 발생하면 이벤트 루프에 부하가 걸려 성능 저하와 응답 지연이 발생할 수 있습니다.
동시 실행 제한을 설정하면 허용 범위를 초과하는 실행은 대기열에 추가됩니다.
설명 도해 · 하루보탬 Studio
동시 실행 제한 설정 및 작동 방식
환경 변수 N8N_CONCURRENCY_PRODUCTION_LIMIT을 설정하여 동시 실행 제한을 활성화할 수 있습니다.
대기열에 포함된 실행은 동시 실행 용량이 확보되는 대로 선입선출(FIFO) 순서로 처리됩니다.
인스턴스가 재시작될 때, n8n은 동시 실행 제한 범위 내의 대기열 실행을 재개하고 나머지는 다시 대기열에 넣습니다.
설명 도해 · 하루보탬 Studio
적용 범위 및 제약 사항
동시 실행 제어는 webhook 또는 trigger 노드에서 시작되는 'production' 실행에만 적용됩니다.
수동 실행, 서브 워크플로우 실행, 에러 실행 또는 CLI를 통해 시작된 실행에는 동시 실행 제어가 적용되지 않습니다.
대기열에 있는 실행은 재시도할 수 없으며, 취소 또는 삭제 시 대기열에서 제거됩니다.
설명 도해 · 하루보탬 Studio
모니터링 및 관리
로그를 확인하여 대기열에 추가되거나 해제되는 실행을 모니터링할 수 있습니다.
공식 문서에는 프로젝트 또는 워크플로우의 실행 탭 상단에서 활성 실행 수와 설정한 제한을 확인할 수 있다고 안내되어 있습니다.
다만 같은 문서에 UI 표시는 향후 제공될 예정이라는 설명도 함께 있습니다. 적용 시점이 일치하지 않으므로, 설치한 버전의 실행 탭에서 실제 표시 여부를 확인하고 표시가 없으면 로그로 대기열 추가·해제를 확인하십시오.
설명 도해 · 하루보탬 Studio
적용 조건과 확인 범위
- 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아니다.
- Cloud·자체호스팅·Enterprise의 지원 범위와 제한을 구분한다.
- 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아님.
- Cloud·자체호스팅·Enterprise의 지원 범위와 제한을 구분함.
- 동시 실행 제어는 'production' 실행(webhook, trigger)에만 적용되며, 수동/서브 워크플로우/에러/CLI 실행에는 적용되지 않음.
- 대기열에 있는 실행은 재시도할 수 없으며, 취소 또는 삭제 시 대기열에서 제거됨.
확인일: 2026-09-21T18:16:19.362778+00:00