엔드포인트 환경 변수
n8n v2.42요약
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요. 이 페이지에서는 n8n의 엔드포인트를 사용자 지정하기 위한 환경 변수를 설명합니다.
참고
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
이 페이지에서는 n8n의 엔드포인트를 사용자 지정하기 위한 환경 변수를 설명합니다.
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
N8N_PAYLOAD_SIZE_MAX |
Number | 16 |
최대 페이로드 크기(MiB)입니다. 기본값은 16MiB이며, 변수 값을 더 높게 조정하여 늘릴 수 있습니다. 새 설정을 적용하려면 n8n 인스턴스를 다시 시작해야 합니다. 참고: 페이로드 크기를 늘리면 더 많은 메모리와 CPU 리소스가 필요하며 성능에 영향을 줄 수 있습니다. 인프라가 더 큰 페이로드를 처리할 수 있는지 확인하세요. |
N8N_FORMDATA_FILE_SIZE_MAX |
Number | 200 |
form-data 웹훅 페이로드에 포함된 파일의 최대 페이로드 크기(MiB)입니다. |
N8N_METRICS |
Boolean | false |
/metrics 엔드포인트를 활성화할지 여부입니다. |
N8N_METRICS_PREFIX |
String | n8n_ |
n8n 관련 메트릭 이름에 사용할 선택적 접두사입니다. |
N8N_METRICS_INCLUDE_DEFAULT_METRICS |
Boolean | true |
기본 시스템 및 node.js 메트릭을 노출할지 여부입니다. |
N8N_METRICS_INCLUDE_CACHE_METRICS |
Boolean | false | 캐시 히트 및 미스에 대한 메트릭을 포함할지(true) 포함하지 않을지(false) 여부입니다. |
N8N_METRICS_INCLUDE_MESSAGE_EVENT_BUS_METRICS |
Boolean | false |
이벤트에 대한 메트릭을 포함할지(true) 포함하지 않을지(false) 여부입니다. |
N8N_METRICS_INCLUDE_WORKFLOW_ID_LABEL |
Boolean | false |
워크플로 메트릭에 워크플로 ID 라벨을 포함할지 여부입니다. |
N8N_METRICS_INCLUDE_NODE_TYPE_LABEL |
Boolean | false |
노드 메트릭에 노드 유형 라벨을 포함할지 여부입니다. |
N8N_METRICS_INCLUDE_CREDENTIAL_TYPE_LABEL |
Boolean | false |
자격 증명 메트릭에 자격 증명 유형 라벨을 포함할지 여부입니다. |
N8N_METRICS_INCLUDE_API_ENDPOINTS |
Boolean | false |
API 엔드포인트에 대한 메트릭을 노출할지 여부입니다. |
N8N_METRICS_INCLUDE_API_PATH_LABEL |
Boolean | false |
API 호출 경로에 대한 라벨을 포함할지 여부입니다. |
N8N_METRICS_INCLUDE_API_METHOD_LABEL |
Boolean | false |
API 호출의 HTTP 메서드(GET, POST 등)에 대한 라벨을 포함할지 여부입니다. |
N8N_METRICS_INCLUDE_API_STATUS_CODE_LABEL |
Boolean | false |
API 호출의 HTTP 상태 코드(200, 404 등)에 대한 라벨을 포함할지 여부입니다. |
N8N_METRICS_INCLUDE_QUEUE_METRICS |
Boolean | false |
큐 모드에서 작업에 대한 메트릭을 포함할지 여부입니다. |
N8N_METRICS_QUEUE_METRICS_INTERVAL |
Integer | 20 |
큐 메트릭을 업데이트하는 주기(초)입니다. |
N8N_METRICS_INCLUDE_SCHEDULER_METRICS |
Boolean | false |
내구성 스케줄러에 대한 메트릭(큐 깊이, 스케줄링 지연, 디스패치 처리량, 재시도, 데드 레터 등)을 포함할지 여부입니다. 메인 인스턴스에만 적용됩니다. 각 메트릭의 의미는 내구성 스케줄러 관측성을 참조하세요. |
N8N_METRICS_SCHEDULER_INTERVAL |
Integer | 20 |
내구성 스케줄러의 큐 상태 게이지를 갱신하는 주기(초)입니다. 내구성 스케줄러 관측성을 참조하세요. |
N8N_METRICS_INCLUDE_POLL_TRIGGER_METRICS |
Boolean | false |
폴링 방식 트리거 노드에 대한 메트릭(폴링 소요 시간, 폴링 오류, 중복 폴링, 커서 커밋 등)을 포함할지 여부입니다. 메인 인스턴스에만 적용됩니다. 각 메트릭의 의미는 폴링 트리거 메트릭을 참조하세요. |
N8N_METRICS_INCLUDE_SYSTEM_TASK_METRICS |
Boolean | false |
n8n 내부 유지 관리 작업에 대한 메트릭(실행 소요 시간, 마지막 성공 시각, 건너뛴 실행, 타이머 지연 등)을 포함할지 여부입니다. 메인 인스턴스에만 적용됩니다. 각 메트릭의 의미는 시스템 작업 관측성을 참조하세요. |
N8N_METRICS_INCLUDE_SSRF_METRICS |
Boolean | false |
SSRF 보호 검사에 대한 메트릭을 포함할지 여부입니다. |
N8N_METRICS_INCLUDE_DNS_CACHE_METRICS |
Boolean | false |
DNS 캐시(현재 SSRF 보호에서만 사용)에 대한 메트릭을 포함할지 여부입니다. |
N8N_ENDPOINT_REST |
String | rest |
REST 엔드포인트에 사용되는 경로입니다. |
N8N_ENDPOINT_WEBHOOK |
String | webhook |
웹훅 엔드포인트에 사용되는 경로입니다. |
N8N_ENDPOINT_WEBHOOK_TEST |
String | webhook-test |
테스트 웹훅 엔드포인트에 사용되는 경로입니다. |
N8N_ENDPOINT_WEBHOOK_WAIT |
String | webhook-waiting |
대기 중 웹훅 엔드포인트에 사용되는 경로입니다. |
N8N_ENDPOINT_HEALTH |
String | healthz |
상태 확인(health check) 엔드포인트에 사용되는 경로입니다. |
N8N_WEBHOOK_URL |
String | - | 리버스 프록시 뒤에서 n8n을 실행할 때 테스트 및 프로덕션 웹훅 모두에 대한 기본 URL을 설정합니다. URL이 아닌 엔드포인트 _경로_만 설정하는 위의 N8N_ENDPOINT_* 변수 대신 이 변수를 사용하세요. 리버스 프록시로 웹훅 URL 구성하기를 참조하세요. |
WEBHOOK_URL |
String | - | n8n 2.35.0부터 지원 중단된 N8N_WEBHOOK_URL의 별칭입니다. 계속 작동하지만, n8n이 시작 시 지원 중단 경고를 기록합니다. |
N8N_DISABLE_PRODUCTION_MAIN_PROCESS |
Boolean | false |
메인 프로세스에서 프로덕션 웹훅을 비활성화합니다. 이는 웹훅 전용 프로세스를 사용할 때 메인 프로세스에 HTTP 트래픽 부하가 발생하지 않도록 합니다. |
참고
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.