구성

n8n의 설정은 환경 변수를 사용하여 변경할 수 있습니다. 사용 가능한 전체 구성 목록은 환경 변수를 참조하세요.

명령줄로 환경 변수 설정

npm

npm의 경우, 원하는 환경 변수를 터미널에서 export 명령을 사용하여 다음과 같이 설정합니다:

export <variable>=<value>

Docker

Docker에서는 명령줄에서 -e 플래그를 사용할 수 있습니다:

docker run -it --rm \
 --name n8n \
 -p 5678:5678 \
 -e N8N_TEMPLATES_ENABLED="false" \
 docker.n8n.io/n8nio/n8n

파일을 사용하여 환경 변수 설정

구성 파일을 사용하여 n8n을 구성할 수도 있습니다.

기본값과 다른 값만 구성 파일에서 정의하세요. 여러 파일을 사용할 수 있습니다. 예를 들어, 일반 기본 설정을 가진 파일과 서로 다른 환경에 대한 특정 값을 가진 파일이 있을 수 있습니다.

npm

환경 변수 N8N_CONFIG_FILES를 사용하여 JSON 구성 파일의 경로를 설정하세요:

# Bash - 단일 파일
export N8N_CONFIG_FILES=/<path-to-config>/my-config.json
# Bash - 여러 파일은 쉼표로 구분
export N8N_CONFIG_FILES=/<path-to-config>/my-config.json,/<path-to-config>/production.json

# PowerShell - 단일 파일, 현재 사용자에 대해 지속
# 설정 범위 (Process, User, Machine)는 Unix 시스템에서는 효과가 없습니다.
[Environment]::SetEnvironmentVariable('N8N_CONFIG_FILES', '<path-to-config>\config.json', 'User')

예제 파일:

{
 "executions": {
  "saveDataOnSuccess": "none"
 },
 "generic": {
  "timezone": "Europe/Berlin"
 },
 "nodes": {
  "exclude": "[\"n8n-nodes-base.executeCommand\",\"n8n-nodes-base.writeBinaryFile\"]"
 }
}

JSON 형식으로 포맷하기

환경 변수 참조에서 올바른 JSON을 항상 확인할 수는 없습니다. 예를 들어, N8N_METRICS를 true로 설정하려면 다음과 같이 해야 합니다:

{
	"endpoints": {
		"metrics": {
			"enable": true
		}
	}
}

예상되는 설정에 대한 전체 세부정보는 소스 코드의 스키마 파일를 참조하세요.

Docker

Docker에서는 docker-compose.yaml 파일의 n8n: environment: 요소에서 환경 변수를 설정할 수 있습니다.

예를 들어:

n8n:
    environment:
      - N8N_TEMPLATES_ENABLED=false

민감한 데이터를 별도의 파일에 보관하기

개별 환경 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공함으로써 환경 변수를 통해 민감한 세부정보를 전달하는 것을 피할 수 있습니다. n8n은 주어진 이름의 파일에서 데이터를 로드하므로 Docker-Secrets 및 Kubernetes-Secrets에서 데이터를 로드할 수 있습니다.

각 변수에 대한 세부정보는 환경 변수를 참조하세요.

대부분의 환경 변수는 _FILE 접미사를 사용할 수 있지만, 자격 증명 및 데이터베이스 구성과 같은 민감한 데이터에는 더 유용합니다. 다음은 몇 가지 예입니다:

CREDENTIALS_OVERWRITE_DATA_FILE=/path/to/credentials_data
DB_TYPE_FILE=/path/to/db_type
DB_POSTGRESDB_DATABASE_FILE=/path/to/database_name
DB_POSTGRESDB_HOST_FILE=/path/to/database_host
DB_POSTGRESDB_PORT_FILE=/path/to/database_port
DB_POSTGRESDB_USER_FILE=/path/to/database_user
DB_POSTGRESDB_PASSWORD_FILE=/path/to/database_password
DB_POSTGRESDB_SCHEMA_FILE=/path/to/database_schema
DB_POSTGRESDB_SSL_CA_FILE=/path/to/ssl_ca
DB_POSTGRESDB_SSL_CERT_FILE=/path/to/ssl_cert
DB_POSTGRESDB_SSL_KEY_FILE=/path/to/ssl_key
DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED_FILE=/path/to/ssl_reject_unauth