배포 환경 변수#
파일 기반 구성
각 변수에 _FILE을 추가하면 별도의 파일에서 해당 변수를 설정할 수 있습니다. 자세한 내용은 민감한 데이터를 별도 파일에 저장하기 문서를 참고하세요.
이 페이지는 액세스 URL 설정, 템플릿 활성화, 암호화 사용자 지정 및 서버 세부 정보 구성 등을 포함하여 자가 호스팅된 n8n 인스턴스에 대한 배포 구성 옵션을 나열합니다.
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
N8N_EDITOR_BASE_URL |
문자열 | - | 사용자가 편집기에 액세스 할 수 있는 공개 URL입니다. n8n에서 전송되는 이메일과 SAML 기반 인증을 위한 리디렉션 URL에도 사용됩니다. |
N8N_CONFIG_FILES |
문자열 | - | JSON 구성 파일 경로를 제공하는 데 사용됩니다. |
N8N_DISABLE_UI |
불리언 | false |
UI를 비활성화하려면 true로 설정하십시오. |
N8N_PREVIEW_MODE |
불리언 | false |
미리보기 모드로 실행하려면 true로 설정하십시오. |
N8N_TEMPLATES_ENABLED |
불리언 | false |
워크플로 템플릿을 사용하도록 설정(true)하거나 비활성화(false)합니다. |
N8N_TEMPLATES_HOST |
문자열 | https://api.n8n.io |
자신만의 워크플로 템플릿 라이브러리를 만드는 경우 변경하세요. 자신의 워크플로 템플릿 라이브러리를 사용하려면 API가 n8n의 동일한 엔드포인트 및 응답 구조를 제공해야 합니다. 자세한 내용은 워크플로 템플릿을 참조하세요. |
N8N_ENCRYPTION_KEY |
문자열 | n8n에서 생성된 랜덤 키 | n8n 데이터베이스에서 자격 증명을 암호화하는 데 사용되는 사용자 지정 키를 제공하십시오. 기본적으로 n8n은 처음 시작할 때 랜덤 키를 생성합니다. |
N8N_USER_FOLDER |
문자열 | user-folder |
n8n이 .n8n 폴더를 생성할 경로를 제공합니다. 이 디렉토리는 데이터베이스 파일 및 암호화 키와 같은 사용자별 데이터를 저장합니다. |
N8N_PATH |
문자열 | / |
n8n이 배포되는 경로입니다. |
N8N_HOST |
문자열 | localhost |
n8n이 실행되는 호스트 이름입니다. |
N8N_PORT |
숫자 | 5678 |
n8n이 실행되는 HTTP 포트입니다. |
N8N_LISTEN_ADDRESS |
문자열 | 0.0.0.0 |
n8n이 청취해야 하는 IP 주소입니다. |
N8N_PROTOCOL |
문자열 열거형: http, https |
http |
n8n에 도달하는 데 사용되는 프로토콜입니다. |
N8N_SSL_KEY |
문자열 | - | HTTPS 프로토콜에 대한 SSL 키입니다. |
N8N_SSL_CERT |
문자열 | - | HTTPS 프로토콜에 대한 SSL 인증서입니다. |
N8N_PERSONALIZATION_ENABLED |
불리언 | true |
사용자에게 개인화 질문을 하고 그에 따라 n8n을 사용자 지정할지를 나타냅니다. |
N8N_VERSION_NOTIFICATIONS_ENABLED |
불리언 | true |
활성화되면 n8n은 새로운 버전 및 보안 업데이트에 대한 알림을 보냅니다. |
N8N_VERSION_NOTIFICATIONS_ENDPOINT |
문자열 | https://api.n8n.io/versions/ |
버전 정보를 검색할 엔드포인트입니다. |
N8N_VERSION_NOTIFICATIONS_INFO_URL |
문자열 | https://docs.n8n.io/getting-started/installation/updating.html |
새로운 버전 패널에 더 많은 정보를 위해 표시되는 URL입니다. |
N8N_DIAGNOSTICS_ENABLED |
불리언 | true |
선택된 익명 텔레메트리를 n8n과 공유할지를 나타냅니다. false로 설정하면 코드 노드에서 Ask AI를 활성화할 수 없습니다. |
N8N_DIAGNOSTICS_CONFIG_FRONTEND |
문자열 | 1zPn9bgWPzlQc0p8Gj1uiK6DOTn;https://telemetry.n8n.io |
프론트엔드에 대한 텔레메트리 구성입니다. |
N8N_DIAGNOSTICS_CONFIG_BACKEND |
문자열 | 1zPn7YoGC3ZXE9zLeTKLuQCB4F6;https://telemetry.n8n.io/v1/batch |
백엔드에 대한 텔레메트리 구성입니다. |
N8N_PUSH_BACKEND |
문자열 | websocket |
n8n 백엔드가 UI에 변경 사항을 보내는 데 서버 전송 이벤트(sse) 또는 웹소켓(websocket)을 사용하는지 선택합니다. |
VUE_APP_URL_BASE_API |
문자열 | http://localhost:5678/ |
n8n-editor-ui 패키지를 수동으로 빌드할 때 프론트엔드가 백엔드 API에 어떻게 도달할 수 있는지 설정하는 데 사용됩니다. 기본 URL 구성을 참조하세요. |
N8N_HIRING_BANNER_ENABLED |
불리언 | true |
콘솔에 n8n 채용 배너를 표시할지를 나타냅니다 (true) 아니면 표시하지 않을지를 나타냅니다 (false). |
N8N_PUBLIC_API_SWAGGERUI_DISABLED |
불리언 | false |
Swagger UI(API 놀이터)가 비활성화될지를 나타냅니다 (true) 아니면 비활성화되지 않을지를 나타냅니다 (false). |
N8N_PUBLIC_API_DISABLED |
불리언 | false |
공용 API를 비활성화할지를 나타냅니다 (true) 아니면 비활성화되지 않을지를 나타냅니다 (false). |
N8N_PUBLIC_API_ENDPOINT |
문자열 | api |
공용 API 엔드포인트의 경로입니다. |
N8N_GRACEFUL_SHUTDOWN_TIMEOUT |
숫자 | 30 |
n8n 프로세스가 종료되기 전에 컴포넌트가 종료될 때까지 기다려야 하는 시간(초)입니다. |
N8N_DEV_RELOAD |
불리언 | false |
n8n 소스 코드를 작업할 때, 소스 코드 파일에서 변경이 발생하면 자동으로 애플리케이션을 다시 로드하거나 다시 시작하려면 이 설정을 true로 설정합니다. |
N8N_REINSTALL_MISSING_PACKAGES |
불리언 | false |
true로 설정하면 n8n은 누락된 패키지를 자동으로 다시 설치하려고 합니다. |
N8N_TUNNEL_SUBDOMAIN |
문자열 | - | n8n 터널을 위한 서브도메인을 지정합니다. 설정하지 않으면 n8n이 랜덤 서브도메인을 생성합니다. |
N8N_PROXY_HOPS |
숫자 | 0 | n8n이 실행 중인 리버스 프록시의 수입니다. |