배포 환경 변수
n8n v2.29요약
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요. 이 페이지는 셀프 호스팅 n8n 인스턴스의 배포 구성 옵션을 나열합니다. n8n이 프록시 환경 변수(_PROXY로 끝나는 변수)를 처리하는 데 사용하는 proxy-from-env 패키지는 특정 변수 우선순위를 부여합니다.
참고
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
이 페이지는 셀프 호스팅 n8n 인스턴스의 배포 구성 옵션을 나열합니다. 액세스 URL 설정, 템플릿 활성화, 암호화 사용자 지정, 서버 세부 정보 구성 등이 포함됩니다.
Note
프록시 변수 우선순위
n8n이 프록시 환경 변수(_PROXY로 끝나는 변수)를 처리하는 데 사용하는 proxy-from-env 패키지는 특정 변수 우선순위를 부여합니다. 특히 프록시 변수의 경우, 소문자 버전(예: http_proxy)이 대문자 버전(예: HTTP_PROXY)보다 우선합니다(둘 다 존재하는 경우).
프록시 환경 변수에 대해 더 알아보려면 패키지 세부 정보의 환경 변수 섹션을 확인하세요.
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
HTTP_PROXY |
String | - | 암호화되지 않은 HTTP 요청을 프록시할 URL입니다. 설정하면 n8n은 노드에서 발생하는 모든 암호화되지 않은 HTTP 트래픽을 이 프록시 URL을 통해 전달합니다. |
HTTPS_PROXY |
String | - | TLS/SSL로 암호화된 HTTP 요청을 프록시할 URL입니다. 설정하면 n8n은 노드에서 발생하는 모든 TLS/SSL 암호화 HTTP 트래픽을 이 프록시 URL을 통해 전달합니다. |
ALL_PROXY |
String | - | 암호화되지 않은 요청과 암호화된 HTTP 요청을 모두 프록시할 URL입니다. 설정하면 더 구체적인 변수(HTTP_PROXY 또는 HTTPS_PROXY)가 없을 때 n8n이 이 값을 사용합니다. |
NO_PROXY |
String | - | 프록시를 우회해야 하는 호스트 이름 또는 URL을 쉼표로 구분한 목록입니다. HTTP_PROXY, HTTPS_PROXY, ALL_PROXY를 사용할 때 n8n은 프록시를 사용하는 대신 여기에 정의된 URL 또는 호스트 이름에 직접 연결합니다. |
N8N_ENFORCE_GLOBAL_USER_AGENT |
Boolean | false |
true로 설정하면 n8n은 모든 아웃바운드 HTTP 요청에서 기본 단순 n8n User-Agent 문자열을 RFC를 준수하는 값(Mozilla/5.0 (compatible; n8n/<version>; +https://n8n.io/))으로 대체합니다. 웹 애플리케이션 방화벽이 n8n 요청을 차단하지 못하도록 하려면 이 옵션을 활성화하세요. |
N8N_GLOBAL_USER_AGENT_VALUE |
String | - | 모든 아웃바운드 HTTP 요청에 사용할 사용자 지정 User-Agent 문자열입니다. N8N_ENFORCE_GLOBAL_USER_AGENT가 설정하는 RFC 준수 기본값을 재정의합니다. 업스트림 서버에 n8n 버전을 노출하고 싶지 않을 때 유용합니다. |
N8N_EDITOR_BASE_URL |
String | - | 사용자가 편집기에 접근할 수 있는 공개 URL입니다. n8n에서 보내는 이메일 및 SAML 기반 인증의 리디렉션 URL에도 사용됩니다. |
N8N_DISABLE_UI |
Boolean | false |
UI를 비활성화하려면 true로 설정합니다. |
N8N_PREVIEW_MODE |
Boolean | false |
미리보기 모드로 실행하려면 true로 설정합니다. |
N8N_TEMPLATES_ENABLED |
Boolean | true |
워크플로 템플릿1을 활성화(true)하거나 비활성화(false)합니다. |
N8N_TEMPLATES_HOST |
String | https://api.n8n.io |
자체 워크플로 템플릿 라이브러리를 만들 경우 이 값을 변경하세요. 자체 워크플로 템플릿 라이브러리를 사용하려면 API가 n8n과 동일한 엔드포인트 및 응답 구조를 제공해야 합니다. 자세한 내용은 워크플로 템플릿을 참고하세요. |
N8N_ENCRYPTION_KEY |
String | n8n이 생성하는 무작위 키 | n8n 데이터베이스에서 자격 증명을 암호화하는 데 사용할 사용자 지정 키를 제공합니다. 기본적으로 n8n은 최초 실행 시 무작위 키를 생성합니다. |
N8N_ENV_FEAT_ENCRYPTION_KEY_ROTATION |
Boolean | false |
암호화 키 순환을 활성화하려면 모든 인스턴스(메인 및 워커)에서 true로 설정합니다. 되돌릴 수 없는 변경 사항이므로 먼저 전체 데이터베이스 백업을 수행하세요. |
N8N_ENV_FEAT_OAUTH2_JWE |
Boolean | false |
OAuth 2.0 자격 증명용 JWE 토큰 복호화를 활성화하려면 모든 인스턴스(메인 및 워커)에서 true로 설정합니다. 프리뷰 기능입니다. |
N8N_ENV_FEAT_TOKEN_EXCHANGE |
Boolean | false |
임베딩 파트너용 토큰 교환을 활성화하려면 true로 설정합니다. 프리뷰 기능입니다. |
N8N_OAUTH_JWE_JWKS_PER_MINUTE |
Number | 60 |
OAuth 2.0 자격 증명용 JWE 토큰 복호화에 사용되는 공개 JWKS 엔드포인트(/rest/.well-known/jwks.json)의 IP당 요청 제한 수입니다. |
N8N_MCP_SERVER_RATE_LIMIT |
Number | 100 |
MCP 서버 엔드포인트(/mcp-server/http)에 대한 IP당, 5분당 최대 요청 수입니다. |
N8N_OAUTH_SERVER_REGISTER_RATE_LIMIT |
Number | 10 |
OAuth 서버 클라이언트 등록 엔드포인트(/oauth/register 및 /mcp-oauth/register)에 대한 IP당, 5분당 최대 요청 수입니다. |
N8N_OAUTH_SERVER_AUTHORIZE_RATE_LIMIT |
Number | 50 |
OAuth 서버 인가 엔드포인트(/oauth/authorize 및 /mcp-oauth/authorize)에 대한 IP당, 5분당 최대 요청 수입니다. |
N8N_OAUTH_SERVER_TOKEN_RATE_LIMIT |
Number | 20 |
OAuth 서버 토큰 엔드포인트(/oauth/token 및 /mcp-oauth/token)에 대한 IP당, 5분당 최대 요청 수입니다. |
N8N_OAUTH_SERVER_REVOKE_RATE_LIMIT |
Number | 30 |
OAuth 서버 토큰 취소 엔드포인트(/oauth/revoke 및 /mcp-oauth/revoke)에 대한 IP당, 5분당 최대 요청 수입니다. |
N8N_USER_FOLDER |
String | user-folder |
n8n이 .n8n 폴더를 생성할 경로를 제공합니다. 이 디렉터리는 데이터베이스 파일 및 암호화 키와 같은 사용자별 데이터를 저장합니다. |
N8N_PATH |
String | / |
n8n이 배포되는 경로입니다. N8N_PATH를 리버스 프록시와 함께 사용하면 폴더 탐색 문제가 발생할 수 있습니다. 서브도메인(예: n8n.example.com)을 사용하거나 리버스 프록시 없이 N8N_PATH를 사용하세요. |
N8N_HOST |
String | localhost |
n8n이 실행되는 호스트 이름입니다. |
N8N_PORT |
Number | 5678 |
n8n이 실행되는 HTTP 포트입니다. |
N8N_LISTEN_ADDRESS |
String | :: |
n8n이 리스닝해야 할 IP 주소입니다. |
N8N_PROTOCOL |
Enum string: http, https |
http |
n8n에 접근하는 데 사용되는 프로토콜입니다. |
N8N_SSL_KEY |
String | - | HTTPS 프로토콜용 SSL 키입니다. |
N8N_SSL_CERT |
String | - | HTTPS 프로토콜용 SSL 인증서입니다. |
N8N_PERSONALIZATION_ENABLED |
Boolean | true |
사용자에게 개인화 질문을 하고 그에 따라 n8n을 맞춤화할지 여부입니다. |
N8N_VERSION_NOTIFICATIONS_ENABLED |
Boolean | true |
활성화하면 n8n은 새 버전 및 보안 업데이트에 대한 알림을 보냅니다. |
N8N_VERSION_NOTIFICATIONS_ENDPOINT |
String | https://api.n8n.io/versions/ |
버전 정보를 검색할 엔드포인트입니다. |
N8N_VERSION_NOTIFICATIONS_INFO_URL |
String | https://docs.n8n.io/getting-started/installation/updating.html |
새 버전 패널에 표시되는 추가 정보용 URL입니다. |
N8N_DIAGNOSTICS_ENABLED |
Boolean | true |
선택된 익명 텔레메트리를 n8n과 공유할지 여부입니다. 이 값을 false로 설정하면 Code node의 Ask AI를 활성화할 수 없다는 점에 유의하세요. |
N8N_DIAGNOSTICS_CONFIG_FRONTEND |
String | 1zPn9bgWPzlQc0p8Gj1uiK6DOTn;https://telemetry.n8n.io |
프런트엔드용 텔레메트리 구성입니다. |
N8N_DIAGNOSTICS_CONFIG_BACKEND |
String | 1zPn7YoGC3ZXE9zLeTKLuQCB4F6;https://telemetry.n8n.io/v1/batch |
백엔드용 텔레메트리 구성입니다. |
N8N_PUSH_BACKEND |
String | websocket |
n8n 백엔드가 UI에 변경 사항을 전송할 때 서버 전송 이벤트(sse)와 WebSocket(websocket) 중 무엇을 사용할지 선택합니다. |
VUE_APP_URL_BASE_API |
String | http://localhost:5678/ |
n8n-editor-ui 패키지를 수동으로 빌드할 때 프런트엔드가 백엔드 API에 접근하는 방법을 설정하는 데 사용됩니다. 자세한 내용은 기본 URL 구성하기를 참고하세요. |
N8N_HIRING_BANNER_ENABLED |
Boolean | true |
콘솔에 n8n 채용 배너를 표시할지(true) 여부(false)입니다. |
N8N_PUBLIC_API_SWAGGERUI_DISABLED |
Boolean | false |
Swagger UI(API 플레이그라운드)를 비활성화할지(true) 여부(false)입니다. |
N8N_PUBLIC_API_DISABLED |
Boolean | false |
퍼블릭 API를 비활성화할지(true) 여부(false)입니다. |
N8N_PUBLIC_API_ENDPOINT |
String | api |
퍼블릭 API 엔드포인트의 경로입니다. |
N8N_GRACEFUL_SHUTDOWN_TIMEOUT |
Number | 30 |
프로세스를 종료하기 전에 컴포넌트가 종료될 때까지 n8n 프로세스가 대기해야 하는 시간(초)입니다. |
N8N_DEV_RELOAD |
Boolean | false |
n8n 소스 코드를 작업할 때 소스 코드 파일에 변경 사항이 발생하면 애플리케이션을 자동으로 다시 로드하거나 재시작하려면 true로 설정합니다. |
N8N_REINSTALL_MISSING_PACKAGES |
Boolean | false |
true로 설정하면 n8n은 누락된 패키지를 자동으로 재설치하려고 시도합니다. |
N8N_TUNNEL_SUBDOMAIN |
String | - | n8n 터널의 서브도메인을 지정합니다. 설정하지 않으면 n8n이 무작위 서브도메인을 생성합니다. |
N8N_PROXY_HOPS |
Number | 0 | n8n이 뒤에서 실행 중인 리버스 프록시의 수입니다. |
Footnotes
-
n8n 템플릿은 n8n 및 커뮤니티 구성원이 설계한 사전 제작 워크플로로, n8n 인스턴스로 가져올 수 있습니다. 템플릿을 사용할 때는 필요에 맞게 자격 증명을 입력하고 구성을 조정해야 할 수도 있습니다. ↩