노드 환경 변수
요약
개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 이 페이지에서는 n8n의 노드 관리를 위한 환경 변수 구성 옵션 목록을 제공합니다. 환경 변수로 설치된 커뮤니티 패키지를 사전 프로비저닝합니다.
파일 기반 구성
개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 자세한 내용은 별도 파일에 민감한 데이터 보관하기를 참고하세요.
이 페이지에서는 n8n의 노드 관리를 위한 환경 변수 구성 옵션 목록을 제공합니다. 로드하거나 제외할 노드 지정, Code 노드에서 내장 또는 외부 모듈 가져오기, 커뮤니티 노드 활성화 등을 설정할 수 있습니다.
노드 및 커뮤니티 노드 설정#
| 변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
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 노드에서 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 노드에서 특정 내장 모듈을 가져올 수 있도록 허용합니다. *를 사용하면 모두 허용됩니다. n8n은 기본적으로 모듈 가져오기를 비활성화합니다. |
NODE_FUNCTION_ALLOW_EXTERNAL |
String | - | 사용자가 Code 노드에서 특정 외부 모듈(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 | - | 로드할 노드를 지정합니다. |
설치된 커뮤니티 패키지 관리#
n8n v2.21.0부터 사용 가능
환경 변수로 설치된 커뮤니티 패키지를 사전 프로비저닝합니다. *_MANAGED_BY_ENV 패턴에 대한 자세한 내용은 환경 변수를 사용한 인스턴스 설정 관리를 참조하세요.
Note
이 섹션의 내용은 원문 문서를 참조하세요. (community-packages.md)