본문 바로가기
카테고리 없음

n8n 기본 설정 및 환경 변수 구성하기

by bloghi 2025. 2. 18.

n8n을 셀프호스팅할 때는 올바른 기본 설정과 환경 변수 구성이 매우 중요합니다. 이러한 설정을 통해 데이터베이스, 인증, Redis, 파일 저장소 등 다양한 기능을 안정적이고 유연하게 운영할 수 있습니다. 이번 글에서는 n8n 기본 설정과 주요 환경 변수 구성 방법을 단계별로 소개합니다.

n8n 기본 설정

1. 설정 파일 위치

기본적으로 n8n의 설정 파일은 ~/.n8n 디렉터리에 위치합니다. 이 디렉터리에는 환경설정 및 워크플로우 관련 데이터가 저장됩니다.

2. 웹 UI 기본 포트 설정

기본적으로 n8n은 5678 포트를 사용합니다. 이를 변경하려면 환경 변수 N8N_PORT를 설정할 수 있습니다.

export N8N_PORT=8080

이 명령어는 n8n의 웹 UI를 http://localhost:8080으로 변경합니다.

n8n 환경 변수 구성

환경 변수는 n8n의 실행 설정을 외부에서 손쉽게 조정할 수 있는 방법입니다. 아래는 실무에서 자주 사용하는 핵심 환경 변수들입니다.

1. 데이터베이스 설정

기본적으로 SQLite를 사용하지만, PostgreSQL 또는 MySQL을 사용하는 것이 확장성과 성능 측면에서 더 유리합니다.

export DB_TYPE=postgresdb
export DB_POSTGRESDB_HOST=localhost
export DB_POSTGRESDB_PORT=5432
export DB_POSTGRESDB_USER=n8n_user
export DB_POSTGRESDB_PASSWORD=your_password

MySQL을 사용할 경우 DB_MYSQL_HOST 등의 변수로 설정합니다.

2. Redis 설정

n8n은 Redis 기반의 작업 큐를 지원합니다. 대규모 워크플로우를 처리할 때 유용합니다.

export REDIS_HOST=localhost
export REDIS_PORT=6379
export REDIS_PASSWORD=your_password

3. 인증 및 보안 설정

n8n은 기본적으로 인증 기능을 제공합니다. API 보호 또는 관리자 접근 제한을 위해 아래 환경 변수를 설정합니다.

export N8N_BASIC_AUTH_ACTIVE=true
export N8N_BASIC_AUTH_USER=admin
export N8N_BASIC_AUTH_PASSWORD=your_password

추가로 ADMIN_API_KEY나 JWT_SECRET 등도 설정할 수 있습니다.

4. 파일 저장소 설정

n8n은 생성된 파일을 클라우드 스토리지에 저장할 수 있습니다. AWS S3, Google Cloud Storage 등을 지원합니다.

export N8N_FILE_STORAGE=S3
export S3_ACCESS_KEY=your_access_key
export S3_SECRET_KEY=your_secret_key
export S3_BUCKET=your_bucket_name
export S3_REGION=your_region

환경 변수 적용 방법

일반 서버에서 적용

환경 변수는 쉘에서 직접 export하거나, .env 파일로 관리할 수 있습니다.

Docker에서 적용

Docker 환경에서는 -e 옵션을 사용해 쉽게 설정할 수 있습니다:

docker run -d --name n8n -p 5678:5678 \
  -e DB_TYPE=postgresdb \
  -e DB_POSTGRESDB_HOST=localhost \
  -e DB_POSTGRESDB_PORT=5432 \
  -e DB_POSTGRESDB_USER=n8n_user \
  -e DB_POSTGRESDB_PASSWORD=your_password \
  -e N8N_BASIC_AUTH_ACTIVE=true \
  -e N8N_BASIC_AUTH_USER=admin \
  -e N8N_BASIC_AUTH_PASSWORD=your_password \
  n8nio/n8n

결론

n8n 셀프호스팅 환경에서 기본 설정과 환경 변수 구성은 성능과 보안을 좌우하는 중요한 요소입니다. 이 가이드를 따라 데이터베이스, 인증, 큐 시스템, 파일 저장 등을 안정적으로 구성해 보세요. 특히 Docker 환경에서는 환경 변수로 손쉽게 설정을 관리할 수 있으므로, 효율적인 자동화 인프라 구축에 큰 도움이 됩니다.

다음 글에서는 n8n의 실행 모드와 고급 구성 옵션에 대해 자세히 다뤄보겠습니다.

티스토리툴바