외부 저장소#

기능 사용 가능성

자체 호스팅 엔터프라이즈 플랜에서 사용 가능
Cloud Enterprise에서 이 기능에 액세스하려면 n8n에 문의하세요.

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

n8n은 향후 다른 데이터 유형에 대한 외부 저장소를 도입할 예정입니다.

S3에 n8n의 이진 데이터 저장#

n8n은 워크플로 실행에서 생성된 이진 데이터의 외부 저장소로 AWS S3를 지원합니다. Cloudflare R2 및 Backblaze B2와 같은 다른 S3 호환 서비스를 사용할 수 있지만, n8n은 이러한 서비스에 대해 공식적으로 지원하지 않습니다.

엔터프라이즈 계층 기능

외부 저장소를 위해 Enterprise 라이선스 키가 필요합니다. 라이선스 키가 만료되고 S3 모드에 남아 있으면 인스턴스는 S3 버킷에서 읽을 수 있지만 쓸 수 없습니다.

설정#

도움말 문서에 따라 버킷을 생성하고 구성하세요. 다음 정책을 사용하고, <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_EXTERNAL_STORAGE_S3_BUCKET_REGION을 'auto'로 설정할 수 있습니다.

n8n에게 S3에 이진 데이터를 저장하도록 지시하세요:

export N8N_AVAILABLE_BINARY_DATA_MODES=filesystem,s3
export N8N_DEFAULT_BINARY_DATA_MODE=s3

새 구성을 로드하려면 서버를 재시작하세요.

사용법#

S3를 활성화한 후 n8n은 모든 새로운 이진 데이터를 S3 버킷에 쓰고 읽습니다. n8n은 다음 형식으로 S3 버킷에 이진 데이터를 씁니다:

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

n8n은 N8N_AVAILABLE_BINARY_DATA_MODES에 filesystem이 옵션으로 남아 있는 경우, 파일 시스템에 저장된 이전 이진 데이터를 계속해서 파일 시스템에서 읽습니다.

S3에 이진 데이터를 저장하고 나중에 파일 시스템 모드로 전환하면, n8n 인스턴스는 's3'가 N8N_AVAILABLE_BINARY_DATA_MODES에 남아 있고 S3 자격 증명이 유효한 한, S3에 저장된 모든 데이터를 계속 읽습니다.

Binary 데이터 정리

바이너리 데이터 정리는 활성화된 바이너리 데이터 모드에서 작동합니다. 예를 들어, 인스턴스가 S3에 데이터를 저장하도록 설정된 후 파일 시스템 모드로 변경한 경우, n8n은 파일 시스템에서만 바이너리 데이터를 정리합니다. 이는 향후 변경될 수 있습니다.