n8n 자체 호스팅 시 메모리 부족(Out of Memory) 해결을 위한 설정 방법

하루보탬 편집팀

메모리 부족 해결 핵심 요약: 자체 호스팅 시 V8 엔진의 --max-old-space-size 옵션을 통해 메모리 할당량을 늘릴 수 있습니다. 또는 워크플로우의 데이터 처리량을 줄여 메모리 소비를 낮추는 방식을 선택할 수 있습니다.

n8n 자체 호스팅의 메모리 부족 상황에서는 n8n에 사용 가능한 메모리를 늘리거나 메모리 소비를 줄이는 방안을 검토할 수 있습니다. 특히 JavaScript heap out of memory 오류에는 V8 엔진의 old memory 할당량을 늘리는 방법이 도움이 될 수 있습니다.

메모리 부족 문제의 원인과 유형

n8n은 각 노드가 가져오고 처리할 수 있는 데이터의 양에 제한을 두지 않습니다.

이러한 유연성으로 인해 워크플로우 실행 시 사용 가능한 메모리보다 더 많은 양을 요구하게 될 경우 오류가 발생할 수 있습니다.

해결 방식 비교: 메모리 증설 vs 데이터량 축소: 메모리 증설: V8 엔진의 old memory 섹션에 추가 메모리를 할당하여 처리 용량을 확보합니다. 데이터량 축소: 노드별 데이터 처리량을 줄여 시스템의 메모리 소비를 직접적으로 제한합니다.
해결 방식 비교: 메모리 증설 vs 데이터량 축소 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio

근거: Fix memory issues

해결을 위한 두 가지 접근 방식

메모리 부족 상황에 직면했을 때 n8n에 할당되는 메모리 양을 늘리거나, 데이터 소비량을 줄이는 두 가지 옵션이 있습니다.

자체 호스팅 환경에서는 특히 V8 JavaScript 엔진의 old memory 섹션에 추가 메모리를 할당하는 방식이 유용합니다.

메모리 증설 설정 단계: 1. 현재 발생 중인 오류가 'JavaScript heap out of memory'인지 확인합니다. 2. CLI 또는 NODE_OPTIONS 환경 변수를 통해 --max-old-space-size=SIZE 설정을 적용합니다.
메모리 증설 설정 단계 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio

근거: Fix memory issues

V8 엔진 메모리 할당량 증설 방법

자체 호스팅 n8n을 사용하는 경우, CLI 또는 NODE_OPTIONS 환경 변수를 통해 설정을 변경할 수 있습니다.

V8 옵션인 –max-old-space-size=SIZE를 사용하여 할당량을 늘리면 JavaScript heap out of memory 오류를 해결하는 데 도움이 됩니다.

서비스 환경별 제약 사항: 메모리 증량 설정은 자체 호스팅(self-hosted) 환경에만 해당됩니다. n8n Cloud 사용 시의 메모리 제한은 별도의 Cloud 데이터 관리 정책을 따릅니다.
서비스 환경별 제약 사항 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio

근거: Fix memory issues

서비스 유형별 지원 범위 차이

자체 호스팅과 n8n Cloud의 지원 범위와 제한을 구분해야 합니다.

n8n Cloud의 메모리 제한에 관한 내용은 별도의 'Cloud data management'에서 확인해야 합니다.

자체 호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아닙니다.

다음 단계: 환경에 맞는 설정 선택: 자체 호스팅 환경이라면 NODE_OPTIONS 환경 변수 설정을 먼저 검토하십시오. Cloud 환경이라면 해당 서비스의 데이터 관리 문서를 확인하십시오.
다음 단계: 환경에 맞는 설정 선택 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio

근거: Fix memory issues

적용 조건과 확인 범위
  • 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아니다.
  • Cloud·자체호스팅·Enterprise의 지원 범위와 제한을 구분한다.
  • 자체호스팅 인프라와 운영 비용은 구독료와 별개이며 실제 비용을 측정한 것은 아님.
  • Cloud, 자체호스팅, Enterprise의 지원 범위와 제한을 구분함.
  • n8n Cloud의 메모리 제한은 별도의 'Cloud data management'를 확인해야 함.

확인일: 2026-09-21T21:23:27.089553+00:00