노드 환경 변수
n8n v2.25요약
개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 이 페이지에서는 n8n에서 노드 관리를 위한 환경 변수 구성 옵션을 나열합니다. 환경 변수에서 설치된 커뮤니티 패키지를 미리 프로비저닝합니다.
파일 기반 구성
개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 자세한 내용은 별도 파일에 민감한 데이터 보관하기를 참고하세요.
이 페이지에서는 n8n에서 노드 관리를 위한 환경 변수 구성 옵션을 나열합니다. 로드하거나 제외할 노드 지정, Code node에서 내장 또는 외부 모듈 가져오기, 커뮤니티 노드 활성화, 노드별 제한 구성 등의 내용을 포함합니다.
노드 및 커뮤니티 노드 설정#
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
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 |
오류 트리거로 사용할 노드 유형을 지정합니다. |
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 | - | 로드할 노드를 지정합니다. |
압축 노드 설정#
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
N8N_COMPRESSION_NODE_MAX_DECOMPRESSED_SIZE_BYTES |
Number | 2147483648 |
최대 총 압축 해제 출력 크기(바이트). 기본값은 2GiB입니다. |
N8N_COMPRESSION_NODE_MAX_ZIP_ENTRIES |
Number | 5000 |
ZIP 아카이브에서 허용되는 최대 항목 수. |
설치된 커뮤니티 패키지 관리#
n8n v2.21.0부터 사용 가능
환경 변수에서 설치된 커뮤니티 패키지를 미리 프로비저닝합니다. *_MANAGED_BY_ENV 패턴은 환경 변수를 사용한 인스턴스 설정 관리를 참조하세요.
Note
이 섹션의 내용은 원문 문서를 참조하세요. (community-packages.md)