노드 환경 변수
n8n v2.29요약
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요. 이 페이지에서는 n8n에서 노드1를 관리하기 위한 환경 변수 구성 옵션을 설명합니다. 환경 변수를 통해 설치된 커뮤니티 패키지를 사전 프로비저닝합니다. n8n에서 노드는 워크플로를 구성하기 위해 조합하는 개별 구성 요소입니다.
참고
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
이 페이지에서는 n8n에서 노드1를 관리하기 위한 환경 변수 구성 옵션을 설명합니다. 여기에는 로드하거나 제외할 노드 지정, Code node에서 내장 또는 외부 모듈 가져오기(import), 커뮤니티 노드 활성화, 노드별 제한 구성이 포함됩니다.
노드 및 커뮤니티 노드 설정#
| Variable | Type | Default | Description |
|---|---|---|---|
N8N_COMMUNITY_PACKAGES_AUTH_TOKEN |
String | - | 프라이빗 npm 레지스트리용 인증 토큰입니다. 프라이빗 레지스트리에서 커뮤니티 노드를 설치할 때 요청을 인증하려면 N8N_COMMUNITY_PACKAGES_REGISTRY와 함께 사용하세요. |
N8N_COMMUNITY_PACKAGES_ENABLED |
Boolean | true |
커뮤니티 노드를 설치하고 로드하는 기능을 활성화(true)하거나 비활성화(false)합니다. false로 설정하면 개별 설정과 관계없이 검증된 패키지와 검증되지 않은 커뮤니티 패키지 모두 사용할 수 없습니다. |
N8N_COMMUNITY_PACKAGES_PREVENT_LOADING |
Boolean | false |
인스턴스 시작 시 설치된 커뮤니티 노드의 로드를 방지(true)하거나 허용(false)합니다. 결함이 있는 노드로 인해 인스턴스가 시작되지 않을 때 이 옵션을 사용하세요. |
N8N_COMMUNITY_PACKAGES_REGISTRY |
String | https://registry.npmjs.org |
커뮤니티 패키지를 가져올 NPM 레지스트리 URL입니다(라이선스 필요). |
N8N_CUSTOM_EXTENSIONS |
String | - | 사용자 지정 노드가 포함된 디렉터리의 경로를 지정합니다. |
N8N_PYTHON_ENABLED |
Boolean | true |
Code node에서 Python 실행을 활성화할지 여부입니다. |
N8N_UNVERIFIED_PACKAGES_ENABLED |
Boolean | true |
N8N_COMMUNITY_PACKAGES_ENABLED가 true일 때, 이 변수는 NPM 레지스트리에서 검증되지 않은 커뮤니티 노드의 설치 및 사용을 활성화(true)할지 비활성화(false)할지 제어합니다. |
N8N_VERIFIED_PACKAGES_ENABLED |
Boolean | true |
N8N_COMMUNITY_PACKAGES_ENABLED가 true일 때, 이 변수는 노드 패널에 설치 및 사용을 위한 검증된 커뮤니티 노드를 표시(true)할지 숨길지(false) 제어합니다. |
NODE_FUNCTION_ALLOW_BUILTIN |
String | - | 사용자가 Code node에서 특정 내장 모듈을 가져올 수 있도록 허용합니다. 모두 허용하려면 *를 사용하세요. n8n은 기본적으로 모듈 가져오기를 비활성화합니다. |
NODE_FUNCTION_ALLOW_EXTERNAL |
String | - | 사용자가 Code node에서 (n8n/node_modules에서) 특정 외부 모듈을 가져올 수 있도록 허용합니다. n8n은 기본적으로 모듈 가져오기를 비활성화합니다. |
NODES_ERROR_TRIGGER_TYPE |
String | n8n-nodes-base.errorTrigger |
Error Trigger로 사용할 노드 유형을 지정합니다. |
NODES_EXCLUDE |
Array of strings | [\"n8n-nodes-base.executeCommand\", \"n8n-nodes-base.localFileTrigger\"] |
로드하지 않을 노드를 지정합니다. 예를 들어 사용자가 신뢰할 수 없는 경우 보안 위험이 될 수 있는 노드를 차단하려면 다음과 같이 지정합니다: NODES_EXCLUDE: "[\"n8n-nodes-base.executeCommand\", \"@n8n/n8n-nodes-langchain.lmChatDeepSeek\"]". 모든 노드를 활성화하려면 NODES_EXCLUDE: "[]"를 지정하세요. |
NODES_INCLUDE |
Array of strings | - | 로드할 노드를 지정합니다. |
압축 노드 설정#
| Variable | Type | Default | Description |
|---|---|---|---|
N8N_COMPRESSION_NODE_MAX_DECOMPRESSED_SIZE_BYTES |
Number | 2147483648 |
압축 해제된 출력의 최대 총 크기(바이트)입니다. 기본값은 2GiB입니다. |
N8N_COMPRESSION_NODE_MAX_ZIP_ENTRIES |
Number | 5000 |
ZIP 아카이브에서 허용되는 최대 항목 수입니다. |
설치된 커뮤니티 패키지 관리#
Note
n8n v2.21.0부터 사용 가능
환경 변수를 통해 설치된 커뮤니티 패키지를 사전 프로비저닝합니다. *_MANAGED_BY_ENV 패턴에 대해서는 환경 변수를 사용하여 인스턴스 설정 관리를 참조하세요.
참고
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
Footnotes
-
n8n에서 노드는 워크플로를 구성하기 위해 조합하는 개별 구성 요소입니다. 노드는 워크플로가 실행되어야 하는 시점을 정의하고, 데이터를 가져오고 전송하고 처리할 수 있게 하며, 흐름 제어 로직을 정의하고, 외부 서비스와 연결할 수 있습니다. ↩