작업 실행기 환경 변수

파일 기반 구성

각 변수에 _FILE을 추가하면 별도의 파일에서 해당 변수를 설정할 수 있습니다. 자세한 내용은 민감한 데이터를 별도 파일에 저장하기 문서를 참고하세요.

실험적 기능

작업 실행기는 현재 공개 베타 테스트 중이며 발견되지 않은 문제가 있을 수 있습니다. 비즈니스에 중요한 워크플로우에 사용하는 것은 권장하지 않습니다.

작업 실행기는 코드 노드에서 정의된 코드를 실행합니다.

n8n 인스턴스 환경 변수

변수	유형	기본값	설명
N8N_RUNNERS_ENABLED	Boolean	false	작업 실행기가 활성화되어 있는지 여부.
N8N_RUNNERS_MODE	Enum 문자열: internal, external	internal	작업 실행기를 시작하고 실행하는 방법. internal은 n8n이 작업 실행기를 자식 프로세스로 실행함을 의미합니다. external은 외부 오케스트레이터가 작업 실행기를 시작함을 의미합니다.
N8N_RUNNERS_AUTH_TOKEN	String	랜덤 문자열	작업 실행기가 n8n에 인증하는 데 사용하는 공유 비밀. external 모드를 사용할 때 필요합니다.
N8N_RUNNERS_BROKER_PORT	Number	5679	작업 브로커가 작업 실행기 연결을 수신하는 포트.
N8N_RUNNERS_BROKER_LISTEN_ADDRESS	String	127.0.0.1	작업 브로커가 수신하는 주소.
N8N_RUNNERS_MAX_PAYLOAD	Number	1 073 741 824	작업 브로커와 작업 실행기 간의 통신을 위한 최대 페이로드 크기(바이트 단위).
N8N_RUNNERS_MAX_OLD_SPACE_SIZE	String		작업 실행기에서 사용할 --max-old-space-size 옵션(단위: MB). 기본적으로 Node.js는 사용 가능한 메모리를 기준으로 설정합니다.
N8N_RUNNERS_MAX_CONCURRENCY	Number	5	작업 실행기가 동시에 실행할 수 있는 동시 작업의 수.
N8N_RUNNERS_TASK_TIMEOUT	Number	60	작업이 완료될 때까지 걸리는 시간(초 단위)으로, 이 시간이 초과되면 작업이 중단되고 실행기가 재시작됩니다. 0보다 커야 합니다.
N8N_RUNNERS_HEARTBEAT_INTERVAL	Number	30	실행기가 브로커에 하트비트를 전송해야 하는 주기(초 단위)로, 이 시간을 초과하면 작업이 중단되고 실행기가 재시작됩니다. 0보다 커야 합니다.

작업 실행기 시작기 환경 변수

변수	유형	기본값	설명
N8N_RUNNERS_LAUNCHER_LOG_LEVEL	Enum 문자열: debug, info, warn, error	info	표시할 로그 메시지 유형.
N8N_RUNNERS_AUTH_TOKEN	String	-	n8n에 인증하는 데 사용하는 공유 비밀.
N8N_RUNNERS_AUTO_SHUTDOWN_TIMEOUT	Number	15	유휴 실행기를 종료하기 전에 대기할 초 수.
N8N_RUNNERS_TASK_BROKER_URI	String	http://127.0.0.1:5679	작업 브로커 서버(n8n 인스턴스)의 URI.
N8N_RUNNERS_LAUNCHER_HEALTH_CHECK_PORT	Number	5680	시작기의 상태 검사 서버를 위한 포트.
N8N_RUNNERS_MAX_PAYLOAD	Number	1 073 741 824	작업 브로커와 작업 실행기 간의 통신을 위한 최대 페이로드 크기(바이트 단위).
N8N_RUNNERS_MAX_CONCURRENCY	Number	5	작업 실행기가 동시에 실행할 수 있는 동시 작업의 수.
NODE_OPTIONS	String	-	옵션 for Node.js.

작업 러너 환경 변수

변수	유형	기본값	설명
N8N_RUNNERS_GRANT_TOKEN	문자열	랜덤 문자열	러너가 작업 브로커와 인증할 때 사용하는 토큰. 이는 자동으로 발급됩니다.
N8N_RUNNERS_AUTO_SHUTDOWN_TIMEOUT	숫자	15	유휴 러너가 종료되기 전에 대기하는 초 수입니다.
N8N_RUNNERS_TASK_BROKER_URI	문자열	http://127.0.0.1:5679	작업 브로커 서버(n8n 인스턴스)의 URI입니다.
N8N_RUNNERS_LAUNCHER_HEALTH_CHECK_PORT	숫자	5680	발사기의 상태 확인 서버 포트입니다.
N8N_RUNNERS_MAX_PAYLOAD	숫자	1 073 741 824	작업 브로커와 작업 러너 간의 통신을 위한 최대 페이로드 크기(바이트)입니다.
N8N_RUNNERS_MAX_CONCURRENCY	숫자	5	작업 러너가 동시에 실행할 수 있는 동시 작업 수입니다.
NODE_FUNCTION_ALLOW_BUILTIN	문자열	-	사용자에게 코드 노드에서 특정 내장 모듈을 가져오는 것을 허용합니다. 모든 모듈을 허용하려면 *를 사용하세요. n8n은 기본적으로 모듈의 가져오기를 비활성화합니다.
NODE_FUNCTION_ALLOW_EXTERNAL	문자열	-	사용자에게 코드 노드에서 특정 외부 모듈(n8n/node_modules에서)을 가져오는 것을 허용합니다. n8n은 기본적으로 모듈의 가져오기를 비활성화합니다.
GENERIC_TIMEZONE	*	America/New_York	n8n 인스턴스에 대해 구성된 동일한 기본 시간대입니다.