InfoGrab 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입니다. 보다 구체적인 변수(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 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_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 노드에서 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)를 사용할지 WebSockets(websocket)를 사용할지 선택합니다.
VUE_APP_URL_BASE_API String http://localhost:5678/ n8n-editor-ui 패키지를 수동으로 빌드할 때 프론트엔드가 백엔드 API에 접근하는 방법을 설정합니다. Base 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이 실행되는 리버스 프록시의 수입니다.

배포 환경 변수

원문 보기
요약

개별 변수에 _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입니다. 보다 구체적인 변수(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 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_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 노드에서 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)를 사용할지 WebSockets(websocket)를 사용할지 선택합니다.
VUE_APP_URL_BASE_API String http://localhost:5678/ n8n-editor-ui 패키지를 수동으로 빌드할 때 프론트엔드가 백엔드 API에 접근하는 방법을 설정합니다. Base 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이 실행되는 리버스 프록시의 수입니다.