n8n은 워크플로 실행 시 생성되는 바이너리 데이터와 실행 데이터를 외부에 저장할 수 있습니다. 이 기능은 대량의 데이터를 저장할 때 데이터베이스나 파일 시스템에 의존하지 않도록 하는 데 유용합니다.

S3에 n8n의 바이너리 데이터 저장하기#

n8n은 워크플로 실행 시 생성되는 바이너리 데이터를 위한 외부 저장소로 AWS S3를 지원합니다. Cloudflare R2, Backblaze B2와 같은 다른 S3 호환 서비스도 사용할 수 있지만, n8n은 이러한 서비스를 공식적으로 지원하지 않습니다.

설정#

AWS 문서를 참고하여 버킷을 생성하고 구성하세요. 다음 정책을 사용할 수 있으며, <bucket-name>을 생성한 버킷의 이름으로 바꾸세요.

{
 "Version": "2012-10-17",
 "Statement": [
  {
   "Sid": "VisualEditor0",
   "Effect": "Allow",
   "Action": ["s3:*"],
   "Resource": ["arn:aws:s3:::<bucket-name>", "arn:aws:s3:::<bucket-name>/*"]
  }
 ]
}

S3가 오래된 바이너리 데이터를 자동으로 삭제하도록 버킷 수준의 수명 주기 구성을 설정하세요. n8n은 바이너리 데이터의 정리(pruning)를 S3에 위임하므로, 바이너리 데이터를 무기한 보존하고 싶은 경우가 아니라면 수명 주기 구성을 설정해야 합니다.

버킷 생성을 마치면 호스트, 버킷 이름, 리전, 액세스 키 ID와 시크릿 액세스 키를 갖게 됩니다. 이 값들을 n8n의 환경에 설정해야 합니다.

export N8N_EXTERNAL_STORAGE_S3_HOST=... # 예: s3.us-east-1.amazonaws.com
export N8N_EXTERNAL_STORAGE_S3_BUCKET_NAME=...
export N8N_EXTERNAL_STORAGE_S3_BUCKET_REGION=...
export N8N_EXTERNAL_STORAGE_S3_ACCESS_KEY=...
export N8N_EXTERNAL_STORAGE_S3_ACCESS_SECRET=...

S3 버킷 리전 형식 검증 및 업데이트(v2.6.4 이상)#

n8n v2.6.4부터 환경 변수 N8N_EXTERNAL_STORAGE_S3_BUCKET_REGION의 값은 다음 조건을 충족해야 합니다.

• 영숫자 문자(a-z, A-Z, 0-9)와 하이픈(-)만 포함해야 합니다.
• 밑줄(_)이나 다른 특수 문자를 포함하면 안 됩니다.

이 조건을 충족하지 않으면, 저장소 엔드포인트에 접근할 수 있고 이전 버전에서 정상적으로 동작했더라도 n8n은 연결 오류와 함께 시작에 실패합니다.

n8n을 v2.6.4로 업그레이드한 후 S3 연결이 실패한다면, 리전 값이 위 조건을 충족하는지 확인하고 n8n을 다시 배포하세요.

n8n에게 바이너리 데이터를 S3에 저장하도록 지시합니다.

export N8N_AVAILABLE_BINARY_DATA_MODES=filesystem,s3
export N8N_DEFAULT_BINARY_DATA_MODE=s3

새 구성을 불러오려면 서버를 재시작하세요.

사용법#

S3를 활성화하면 n8n은 새로운 바이너리 데이터를 S3 버킷에 쓰고 읽습니다. n8n은 다음 형식으로 S3 버킷에 바이너리 데이터를 씁니다.

workflows/{workflowId}/executions/{executionId}/binary_data/{binaryFileId}

filesystem이 N8N_AVAILABLE_BINARY_DATA_MODES에 옵션으로 계속 나열되어 있다면, n8n은 파일 시스템에 저장된 이전 바이너리 데이터를 계속해서 파일 시스템에서 읽습니다.

바이너리 데이터를 S3에 저장한 후 파일 시스템 모드로 전환하더라도, s3가 N8N_AVAILABLE_BINARY_DATA_MODES에 계속 나열되어 있고 S3 자격 증명이 유효한 한 인스턴스는 계속해서 S3에 저장된 데이터를 읽습니다.

S3 저장소 업그레이드 모범 사례#

S3 또는 S3 호환 저장소를 사용할 때는 다음을 따르세요.

1. 프로토콜 비호환 문제를 방지하기 위해 모든 n8n 구성 요소(main, worker, runner)를 동시에 동일한 버전으로 업그레이드하세요.
2. HTTP를 통한 온프레미스 또는 S3 호환 저장소의 경우 N8N_EXTERNAL_STORAGE_S3_PROTOCOL=http을 설정하고 호스트 구성에 프로토콜을 포함하세요.
3. 지원되는 환경 변수 이름만 사용하세요. 예를 들어 액세스 키에는 N8N_EXTERNAL_STORAGE_S3_ACCESS_KEY를 사용하세요.

최신 n8n 버전은 더 엄격한 검증과 프로토콜 처리를 적용합니다. 이전 구성은 업그레이드 후 업데이트가 필요할 수 있습니다.

Azure Blob Storage에 n8n의 바이너리 데이터 저장하기#

n8n은 워크플로 실행 시 생성되는 바이너리 데이터를 위한 외부 저장소로 Azure Blob Storage를 지원합니다. 이는 외부 실행 데이터 저장소와 동일한 Azure Blob 구성을 사용하므로, 하나의 컨테이너에 바이너리 데이터와 실행 데이터를 모두 담을 수 있습니다.

Azure 설정#

Azure 문서를 참고하여 Azure 스토리지 계정에 blob 컨테이너를 생성하세요.

n8n의 환경에 컨테이너 이름을 설정하세요. N8N_EXTERNAL_STORAGE_AZURE_CONTAINER_NAME은 항상 필수입니다.

export N8N_EXTERNAL_STORAGE_AZURE_CONTAINER_NAME=...

인증의 경우 n8n은 연결 문자열, 계정 이름과 키, 또는 관리 ID(DefaultAzureCredential)를 지원합니다. 전체 인증 변수 목록과 n8n이 이를 확인하는 순서는 외부 데이터 저장소 환경 변수 | Azure Blob Storage를 참고하세요.

n8n은 바이너리 데이터의 정리(pruning)를 Azure에 위임하므로, 오래된 바이너리 데이터를 자동으로 삭제하려면 컨테이너에 수명 주기 관리 정책을 설정하세요. 바이너리 데이터를 무기한 보존하고 싶은 경우가 아니라면 수명 주기 정책을 설정해야 합니다.

n8n에게 바이너리 데이터를 Azure Blob Storage에 저장하도록 지시합니다.

export N8N_AVAILABLE_BINARY_DATA_MODES=filesystem,azure
export N8N_DEFAULT_BINARY_DATA_MODE=azure

새 구성을 불러오려면 서버를 재시작하세요.

Azure 사용법#

Azure Blob Storage를 활성화하면 n8n은 새로운 바이너리 데이터를 컨테이너에 쓰고 읽습니다. n8n은 다음 형식으로 컨테이너에 바이너리 데이터를 씁니다.

workflows/{workflowId}/executions/{executionId}/binary_data/{binaryFileId}

filesystem이 N8N_AVAILABLE_BINARY_DATA_MODES에 옵션으로 계속 나열되어 있다면, n8n은 파일 시스템에 저장된 이전 바이너리 데이터를 계속해서 파일 시스템에서 읽습니다.

바이너리 데이터를 Azure Blob Storage에 저장한 후 파일 시스템 모드로 전환하더라도, azure가 N8N_AVAILABLE_BINARY_DATA_MODES에 계속 나열되어 있고 Azure 자격 증명이 유효한 한 인스턴스는 계속해서 Azure에 저장된 데이터를 읽습니다.

S3에 n8n의 실행 데이터 저장하기#

n8n은 실행 데이터도 S3에 저장할 수 있습니다.

바이너리 데이터 설정 섹션에서 설명한 대로 S3 버킷과 자격 증명을 구성한 다음, n8n에게 실행 데이터를 S3에 저장하도록 지시합니다.

export N8N_EXECUTION_DATA_STORAGE_MODE=s3

큐 모드에서는 워커를 포함한 모든 인스턴스에 N8N_EXECUTION_DATA_STORAGE_MODE와 N8N_EXTERNAL_STORAGE_S3_* 변수를 설정하세요.

S3 실행 데이터 저장소를 활성화하면 n8n은 새로 실행되는 데이터를 다음 형식으로 S3 버킷에 씁니다.

workflows/{workflowId}/executions/{executionId}/execution_data/bundle.json

n8n은 각 실행 데이터가 저장된 위치를 기록하므로, 모드를 전환해도 데이터가 손상되지 않습니다. 이전 실행 데이터는 데이터베이스나 파일 시스템에서 계속 읽을 수 있으며, 나중에 다른 모드로 다시 전환하더라도 버킷이 계속 구성되어 있는 한 S3에 저장된 실행 데이터는 계속 읽을 수 있습니다.

n8n은 표준 실행 정리 설정(EXECUTIONS_DATA_* 변수)을 사용하여 S3의 실행 데이터를 직접 정리합니다. 바이너리 데이터와 달리 실행 데이터는 S3 수명 주기 규칙에 의존하지 않습니다. n8n이 여전히 참조 중인 데이터가 삭제될 수 있으므로 실행 데이터에는 수명 주기 규칙을 추가하지 마세요.