n8n은 워크플로 실행에 의해 생성된 바이너리 데이터를 외부에 저장할 수 있습니다. 이 기능은 대량의 바이너리 데이터를 저장하기 위해 파일시스템에 의존하는 것을 피하는 데 유용합니다.

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은 바이너리 데이터 정리를 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=...

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에 저장된 모든 데이터를 계속 읽습니다.