태스크 러너 환경 변수

요약

메인 n8n 이미지와 달리, 태스크 러너 이미지에서는 시크릿에 파일 기반 구성을 사용할 수 없습니다. 태스크 러너는 Code node에서 정의한 코드를 실행합니다.

파일 기반 구성

메인 n8n 이미지와 달리, 태스크 러너 이미지에서는 시크릿에 파일 기반 구성을 사용할 수 없습니다. 따라서 _FILE 접미사가 붙은 변수는 인식되지 않습니다.

태스크 러너는 Code node에서 정의한 코드를 실행합니다.

n8n 인스턴스 환경 변수#

변수	유형	기본값	설명
`N8N_RUNNERS_ENABLED`	Boolean	`false`	태스크 러너 활성화 여부.
`N8N_RUNNERS_MODE`	Enum string: `internal`, `external`	`internal`	태스크 러너를 실행하는 방식. `internal`은 n8n이 자식 프로세스로 태스크 러너를 실행함을 의미합니다. `external`은 외부 오케스트레이터가 태스크 러너를 실행함을 의미합니다.
`N8N_RUNNERS_AUTH_TOKEN`	String	Random 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	`300`	태스크가 실행될 수 있는 최대 시간(초). 이 시간이 초과되면 러너가 태스크를 중지하고 재시작합니다. 이 값은 0보다 커야 합니다.
`N8N_RUNNERS_HEARTBEAT_INTERVAL`	Number	`30`	러너가 브로커에 하트비트를 전송해야 하는 간격(초). 러너가 제때 하트비트를 전송하지 않으면 태스크가 중지되고 러너가 재시작됩니다. 이 값은 0보다 커야 합니다.
`N8N_RUNNERS_INSECURE_MODE`	Boolean	`false`	불안전한 JS 기능에 의존하는 모듈과의 호환성을 위해 태스크 러너의 모든 보안 조치를 비활성화할지 여부. 프로덕션 사용은 권장하지 않습니다.
`N8N_RUNNERS_TASK_REQUEST_TIMEOUT`	Number	`60`	태스크 요청이 타임아웃 전에 러너가 사용 가능해질 때까지 대기할 수 있는 시간(초). 러너가 없을 때 워크플로가 무기한 대기 상태에 빠지는 것을 방지합니다. 0보다 커야 합니다.

태스크 러너 런처 환경 변수#

변수	유형	기본값	설명
`N8N_RUNNERS_LAUNCHER_LOG_LEVEL`	Enum string: `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`	태스크 러너가 한 번에 실행할 수 있는 동시 태스크 수.

태스크 러너 환경 변수 (전체 언어)#

변수	유형	기본값	설명
`N8N_RUNNERS_GRANT_TOKEN`	String	Random string	러너가 태스크 브로커에 인증하는 데 사용하는 토큰. 런처에 의해 자동으로 제공됩니다.
`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`	태스크 러너가 한 번에 실행할 수 있는 동시 태스크 수.

태스크 러너 환경 변수 (JavaScript)#

변수	유형	기본값	설명
`NODE_FUNCTION_ALLOW_BUILTIN`	String	-	사용자가 Code node에서 특정 내장 모듈을 가져올 수 있도록 허용합니다. `*`를 사용하면 모두 허용합니다. n8n은 기본적으로 모듈 가져오기를 비활성화합니다. 외부 모드에서는 컨테이너 환경 변수가 아닌 `env-override`로 런처 구성 파일(`/etc/n8n-task-runners.json`)에서 설정하세요.
`NODE_FUNCTION_ALLOW_EXTERNAL`	String	-	사용자가 Code node에서 특정 외부 모듈(`n8n/node_modules` 경유)을 가져올 수 있도록 허용합니다. n8n은 기본적으로 모듈 가져오기를 비활성화합니다. 외부 모드에서는 컨테이너 환경 변수가 아닌 `env-override`로 런처 구성 파일(`/etc/n8n-task-runners.json`)에서 설정하세요.
`N8N_RUNNERS_ALLOW_PROTOTYPE_MUTATION`	Boolean	`false`	외부 라이브러리의 프로토타입 변경을 허용할지 여부. 보안 완화를 감수하고 런타임 프로토타입 변경에 의존하는 모듈(예: `puppeteer`)을 허용하려면 `true`로 설정합니다.
`GENERIC_TIMEZONE`	*	`America/New_York`	n8n 인스턴스에 구성된 것과 동일한 기본 시간대.
`NODE_OPTIONS`	String	-	Node.js용 옵션.
`N8N_RUNNERS_MAX_OLD_SPACE_SIZE`	String		태스크 러너에 사용할 `--max-old-space-size` 옵션(MB 단위). 기본적으로 Node.js가 사용 가능한 메모리를 기반으로 설정합니다.

태스크 러너 환경 변수 (Python)#

변수	유형	기본값	설명
`N8N_RUNNERS_STDLIB_ALLOW`	String	-	Code node에서 사용할 수 있는 Python 표준 라이브러리 모듈(하위 모듈 포함). `*`를 사용하면 모든 stdlib 모듈을 허용합니다. n8n은 기본적으로 모든 Python 표준 라이브러리 가져오기를 비활성화합니다. 외부 모드에서는 컨테이너 환경 변수가 아닌 `env-override`로 런처 구성 파일(`/etc/n8n-task-runners.json`)에서 설정하세요.
`N8N_RUNNERS_EXTERNAL_ALLOW`	String	-	Code node에서 사용이 허용된 서드파티 Python 모듈(하위 모듈 포함). `*`를 사용하면 모든 외부 모듈을 허용합니다. n8n은 기본적으로 모든 서드파티 Python 모듈을 비활성화합니다. 서드파티 Python 모듈은 `n8nio/runners` 이미지에 포함되어야 합니다. 외부 모드에서는 컨테이너 환경 변수가 아닌 `env-override`로 런처 구성 파일(`/etc/n8n-task-runners.json`)에서 설정하세요.
`N8N_RUNNERS_BUILTINS_DENY`	String	`eval,exec,compile,open,input,breakpoint,getattr,object,type,vars,setattr,delattr,hasattr,dir,memoryview,__build_class__,globals,locals`	Code node에서 사용할 수 없는 Python 내장 함수. 모든 내장 함수를 허용하려면 빈 문자열로 설정하세요.
`N8N_BLOCK_RUNNER_ENV_ACCESS`	Boolean	`true`	Python 코드 태스크 내부에서 러너 환경에 대한 접근을 차단할지 여부. `os.environ`을 통해 모든 Python code node 사용자가 러너 환경에 접근할 수 있도록 하려면 `false`로 설정하세요. 보안상의 이유로 환경 변수 접근은 기본적으로 차단됩니다.

태스크 러너 환경 변수

n8n v2.25

원문 보기

번역일: 2026-06-11

요약

파일 기반 구성

태스크 러너는 Code node에서 정의한 코드를 실행합니다.

n8n 인스턴스 환경 변수#

변수	유형	기본값	설명
`N8N_RUNNERS_ENABLED`	Boolean	`false`	태스크 러너 활성화 여부.
`N8N_RUNNERS_MODE`	Enum string: `internal`, `external`	`internal`	태스크 러너를 실행하는 방식. `internal`은 n8n이 자식 프로세스로 태스크 러너를 실행함을 의미합니다. `external`은 외부 오케스트레이터가 태스크 러너를 실행함을 의미합니다.
`N8N_RUNNERS_AUTH_TOKEN`	String	Random 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	`300`	태스크가 실행될 수 있는 최대 시간(초). 이 시간이 초과되면 러너가 태스크를 중지하고 재시작합니다. 이 값은 0보다 커야 합니다.
`N8N_RUNNERS_HEARTBEAT_INTERVAL`	Number	`30`	러너가 브로커에 하트비트를 전송해야 하는 간격(초). 러너가 제때 하트비트를 전송하지 않으면 태스크가 중지되고 러너가 재시작됩니다. 이 값은 0보다 커야 합니다.
`N8N_RUNNERS_INSECURE_MODE`	Boolean	`false`	불안전한 JS 기능에 의존하는 모듈과의 호환성을 위해 태스크 러너의 모든 보안 조치를 비활성화할지 여부. 프로덕션 사용은 권장하지 않습니다.
`N8N_RUNNERS_TASK_REQUEST_TIMEOUT`	Number	`60`	태스크 요청이 타임아웃 전에 러너가 사용 가능해질 때까지 대기할 수 있는 시간(초). 러너가 없을 때 워크플로가 무기한 대기 상태에 빠지는 것을 방지합니다. 0보다 커야 합니다.

태스크 러너 런처 환경 변수#

변수	유형	기본값	설명
`N8N_RUNNERS_LAUNCHER_LOG_LEVEL`	Enum string: `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`	태스크 러너가 한 번에 실행할 수 있는 동시 태스크 수.

태스크 러너 환경 변수 (전체 언어)#

변수	유형	기본값	설명
`N8N_RUNNERS_GRANT_TOKEN`	String	Random string	러너가 태스크 브로커에 인증하는 데 사용하는 토큰. 런처에 의해 자동으로 제공됩니다.
`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`	태스크 러너가 한 번에 실행할 수 있는 동시 태스크 수.

태스크 러너 환경 변수 (JavaScript)#

변수	유형	기본값	설명
`NODE_FUNCTION_ALLOW_BUILTIN`	String	-	사용자가 Code node에서 특정 내장 모듈을 가져올 수 있도록 허용합니다. `*`를 사용하면 모두 허용합니다. n8n은 기본적으로 모듈 가져오기를 비활성화합니다. 외부 모드에서는 컨테이너 환경 변수가 아닌 `env-override`로 런처 구성 파일(`/etc/n8n-task-runners.json`)에서 설정하세요.
`NODE_FUNCTION_ALLOW_EXTERNAL`	String	-	사용자가 Code node에서 특정 외부 모듈(`n8n/node_modules` 경유)을 가져올 수 있도록 허용합니다. n8n은 기본적으로 모듈 가져오기를 비활성화합니다. 외부 모드에서는 컨테이너 환경 변수가 아닌 `env-override`로 런처 구성 파일(`/etc/n8n-task-runners.json`)에서 설정하세요.
`N8N_RUNNERS_ALLOW_PROTOTYPE_MUTATION`	Boolean	`false`	외부 라이브러리의 프로토타입 변경을 허용할지 여부. 보안 완화를 감수하고 런타임 프로토타입 변경에 의존하는 모듈(예: `puppeteer`)을 허용하려면 `true`로 설정합니다.
`GENERIC_TIMEZONE`	*	`America/New_York`	n8n 인스턴스에 구성된 것과 동일한 기본 시간대.
`NODE_OPTIONS`	String	-	Node.js용 옵션.
`N8N_RUNNERS_MAX_OLD_SPACE_SIZE`	String		태스크 러너에 사용할 `--max-old-space-size` 옵션(MB 단위). 기본적으로 Node.js가 사용 가능한 메모리를 기반으로 설정합니다.

태스크 러너 환경 변수 (Python)#

변수	유형	기본값	설명
`N8N_RUNNERS_STDLIB_ALLOW`	String	-	Code node에서 사용할 수 있는 Python 표준 라이브러리 모듈(하위 모듈 포함). `*`를 사용하면 모든 stdlib 모듈을 허용합니다. n8n은 기본적으로 모든 Python 표준 라이브러리 가져오기를 비활성화합니다. 외부 모드에서는 컨테이너 환경 변수가 아닌 `env-override`로 런처 구성 파일(`/etc/n8n-task-runners.json`)에서 설정하세요.
`N8N_RUNNERS_EXTERNAL_ALLOW`	String	-	Code node에서 사용이 허용된 서드파티 Python 모듈(하위 모듈 포함). `*`를 사용하면 모든 외부 모듈을 허용합니다. n8n은 기본적으로 모든 서드파티 Python 모듈을 비활성화합니다. 서드파티 Python 모듈은 `n8nio/runners` 이미지에 포함되어야 합니다. 외부 모드에서는 컨테이너 환경 변수가 아닌 `env-override`로 런처 구성 파일(`/etc/n8n-task-runners.json`)에서 설정하세요.
`N8N_RUNNERS_BUILTINS_DENY`	String	`eval,exec,compile,open,input,breakpoint,getattr,object,type,vars,setattr,delattr,hasattr,dir,memoryview,__build_class__,globals,locals`	Code node에서 사용할 수 없는 Python 내장 함수. 모든 내장 함수를 허용하려면 빈 문자열로 설정하세요.
`N8N_BLOCK_RUNNER_ENV_ACCESS`	Boolean	`true`	Python 코드 태스크 내부에서 러너 환경에 대한 접근을 차단할지 여부. `os.environ`을 통해 모든 Python code node 사용자가 러너 환경에 접근할 수 있도록 하려면 `false`로 설정하세요. 보안상의 이유로 환경 변수 접근은 기본적으로 차단됩니다.