InfoGrab DocsInfoGrab Docs

배포 환경 변수

요약

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 이 페이지는 셀프 호스팅 n8n 인스턴스의 배포 설정 옵션을 나열합니다. n8n이 프록시 환경 변수(_PROXY로 끝나는 변수)를 처리할 때 사용하는 proxy-from-env 패키지는 특정 변수 우선순위를 적용합니다.

파일 기반 구성

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 자세한 내용은 별도 파일에 민감한 데이터 보관하기를 참고하세요.

이 페이지는 셀프 호스팅 n8n 인스턴스의 배포 설정 옵션을 나열합니다. 접근 URL 설정, 템플릿 활성화, 암호화 사용자 정의, 서버 세부 정보 구성 등이 포함됩니다.

프록시 변수 우선순위

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입니다. 설정 시, n8n은 더 구체적인 변수(HTTP_PROXY 또는 HTTPS_PROXY)가 없을 때 이 값을 사용합니다.
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 false 워크플로 템플릿을 활성화(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 모든 인스턴스(메인 및 워커)에서 true로 설정하면 OAuth 2.0 자격 증명에 대한 JWE 토큰 복호화를 활성화합니다. 미리보기 기능입니다.
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_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 백엔드가 서버 전송 이벤트(sse) 또는 WebSocket(websocket)을 사용하여 UI에 변경 사항을 전송할지 선택합니다.
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이 실행되는 리버스 프록시의 수입니다.

배포 환경 변수

n8n v2.25
원문 보기
요약

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 이 페이지는 셀프 호스팅 n8n 인스턴스의 배포 설정 옵션을 나열합니다. n8n이 프록시 환경 변수(_PROXY로 끝나는 변수)를 처리할 때 사용하는 proxy-from-env 패키지는 특정 변수 우선순위를 적용합니다.

파일 기반 구성

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 자세한 내용은 별도 파일에 민감한 데이터 보관하기를 참고하세요.

이 페이지는 셀프 호스팅 n8n 인스턴스의 배포 설정 옵션을 나열합니다. 접근 URL 설정, 템플릿 활성화, 암호화 사용자 정의, 서버 세부 정보 구성 등이 포함됩니다.

프록시 변수 우선순위

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입니다. 설정 시, n8n은 더 구체적인 변수(HTTP_PROXY 또는 HTTPS_PROXY)가 없을 때 이 값을 사용합니다.
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 false 워크플로 템플릿을 활성화(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 모든 인스턴스(메인 및 워커)에서 true로 설정하면 OAuth 2.0 자격 증명에 대한 JWE 토큰 복호화를 활성화합니다. 미리보기 기능입니다.
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_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 백엔드가 서버 전송 이벤트(sse) 또는 WebSocket(websocket)을 사용하여 UI에 변경 사항을 전송할지 선택합니다.
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이 실행되는 리버스 프록시의 수입니다.