표현식 엔진 환경 변수
n8n v2.42요약
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요. 표현식은 노드 매개변수를 동적으로 설정하기 위해 n8n이 런타임에 평가하는 JavaScript 코드 조각입니다. legacy 표현식 엔진 사용을 피하세요 legacy 엔진은 격리 없이 표현식을 실행하므로, 샌드박스 처리된 엔진보다 악의적인 표현식에 대한 보호 수준이 낮습니다.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
표현식은 노드 매개변수를 동적으로 설정하기 위해 n8n이 런타임에 평가하는 JavaScript 코드 조각입니다. 표현식 엔진은 이 평가를 실행하는 구성 요소입니다. 이 페이지에서는 표현식 엔진을 구성하기 위한 환경 변수를 나열합니다.
legacy 표현식 엔진 사용을 피하세요
legacy 엔진은 격리 없이 표현식을 실행하므로, 샌드박스 처리된 엔진보다 악의적인 표현식에 대한 보호 수준이 낮습니다. n8n은 향후 릴리즈에서 legacy를 지원 중단(deprecated)할 계획입니다. 가장 강력한 보안 수준을 유지하려면 다음과 같이 설정하세요.
N8N_EXPRESSION_ENGINE을 백엔드 기본값인vm으로 유지합니다.N8N_EXPRESSION_ENGINE_FRONTEND를quickjs로 설정합니다. 에디터는 여전히 기본적으로legacy를 사용합니다.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
표현식 엔진 선택#
n8n은 두 곳에서 표현식을 평가하며, 각각 별도의 엔진 설정이 있습니다.
- 백엔드: 워크플로가 실행될 때 n8n 서버가 표현식을 평가합니다.
N8N_EXPRESSION_ENGINE이 이 엔진을 선택합니다. - 에디터: 워크플로를 빌드하는 동안(예: 표현식 결과를 미리 볼 때) 브라우저가 표현식을 평가합니다.
N8N_EXPRESSION_ENGINE_FRONTEND가 이 엔진을 선택합니다.
두 설정은 서로 독립적입니다.
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
N8N_EXPRESSION_ENGINE |
열거형 문자열: vm, quickjs, legacy |
vm |
백엔드가 사용하는 표현식 엔진을 지정합니다. vm은 샌드박스 처리된 V8 아이솔레이트에서 표현식을 실행합니다. quickjs는 WebAssembly로 컴파일된 QuickJS 샌드박스에서 실행합니다. legacy는 격리 없이 실행하며, n8n은 이를 지원 중단(deprecated)할 계획입니다. vm은 n8n 2.35.0부터 기본값입니다. 이전 n8n 버전의 기본값은 legacy입니다. |
N8N_EXPRESSION_ENGINE_FRONTEND |
열거형 문자열: legacy, quickjs |
legacy |
에디터가 브라우저에서 사용하는 표현식 엔진을 지정합니다. quickjs는 WebAssembly로 컴파일된 QuickJS 샌드박스에서 표현식을 실행하며, 페이지의 나머지 부분과 격리됩니다. legacy는 격리 없이 실행합니다. n8n은 quickjs를 강력히 권장합니다. n8n 2.41.0부터 사용할 수 있습니다. |
샌드박스 처리된 백엔드 엔진 구성#
다음 변수는 백엔드의 vm 및 quickjs 엔진을 구성합니다. N8N_EXPRESSION_ENGINE이 legacy이면 적용되지 않으며, 에디터의 엔진에는 영향을 주지 않습니다.
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
N8N_EXPRESSION_ENGINE_POOL_SIZE |
숫자 | 1 |
풀에서 워밍 상태로 유지되는 샌드박스 수입니다. |
N8N_EXPRESSION_ENGINE_MAX_CODE_CACHE_SIZE |
숫자 | 1024 |
캐시할 컴파일된 표현식의 최대 개수입니다. |
N8N_EXPRESSION_ENGINE_TIMEOUT |
숫자 | 5000 |
각 표현식 평가에 대한 실행 제한 시간(밀리초)입니다. |
N8N_EXPRESSION_ENGINE_MEMORY_LIMIT |
숫자 | 128 |
각 샌드박스의 메모리 한도(MiB)입니다. |
N8N_EXPRESSION_ENGINE_IDLE_TIMEOUT |
숫자 | - | 설정한 경우, 지정된 시간(초) 동안 활동이 없으면 워밍 상태의 샌드박스 풀을 0으로 축소합니다. |