외부 데이터 스토리지 환경 변수
n8n v2.29요약
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요. 바이너리 데이터 및 실행 데이터에 외부 스토리지를 사용하는 방법에 대한 자세한 내용은 외부 스토리지를 참고하세요. 실행 데이터나 바이너리 데이터를 Azure Blob Storage에 저장하려면 엔터프라이즈 라이선스 키가 필요합니다.
참고
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
바이너리 데이터 및 실행 데이터에 외부 스토리지를 사용하는 방법에 대한 자세한 내용은 외부 스토리지를 참고하세요.
| Variable | Type | Default | Description |
|---|---|---|---|
N8N_EXTERNAL_STORAGE_S3_HOST |
String | - | S3 호환 외부 스토리지에서 n8n 버킷의 호스트입니다. 예: s3.us-east-1.amazonaws.com |
N8N_EXTERNAL_STORAGE_S3_BUCKET_NAME |
String | - | S3 호환 외부 스토리지에서 n8n 버킷의 이름입니다. |
N8N_EXTERNAL_STORAGE_S3_BUCKET_REGION |
String | - | S3 호환 외부 스토리지에서 n8n 버킷의 리전입니다. 예: us-east-1 |
N8N_EXTERNAL_STORAGE_S3_ACCESS_KEY |
String | - | S3 호환 외부 스토리지의 액세스 키입니다. |
N8N_EXTERNAL_STORAGE_S3_ACCESS_SECRET |
String | - | S3 호환 외부 스토리지의 액세스 시크릿입니다. |
N8N_EXTERNAL_STORAGE_S3_AUTH_AUTO_DETECT |
Boolean | - | 외부 스토리지에 대한 S3 호출을 인증할 때 자동 자격 증명 감지를 사용합니다. 이 옵션을 사용하면 액세스 키와 액세스 시크릿을 무시하고 기본 자격 증명 제공자 체인을 사용합니다. |
Azure Blob Storage#
Azure Blob Storage에 실행 데이터를 저장하려면 N8N_EXECUTION_DATA_STORAGE_MODE를 azure로 설정하세요. Azure Blob Storage에 바이너리 데이터를 저장하려면 N8N_DEFAULT_BINARY_DATA_MODE를 azure로 설정하세요(외부 스토리지 참고). 컨테이너 하나로 둘 다 저장할 수 있습니다. 아래 변수를 구성하며, N8N_EXTERNAL_STORAGE_AZURE_CONTAINER_NAME은 항상 필수입니다.
인증을 위해 다음 세 가지 옵션 중 하나를 선택하세요. n8n은 다음 순서로 확인합니다.
- 연결 문자열:
N8N_EXTERNAL_STORAGE_AZURE_CONNECTION_STRING을 설정합니다. 이 옵션은 다른 옵션보다 우선하므로, 이를 설정하면 n8n은 계정 이름, 키, 자동 감지를 무시합니다. 가장 간단한 옵션이며 Azurite를 이용한 로컬 테스트에 적합합니다. - 자동 감지:
N8N_EXTERNAL_STORAGE_AZURE_ACCOUNT_NAME을 설정하고N8N_EXTERNAL_STORAGE_AZURE_AUTH_AUTO_DETECT를true로 설정합니다. n8n은 Azure의DefaultAzureCredential체인(관리 ID, 환경, 또는 Azure CLI)을 통해 인증하므로 n8n 구성에 키가 저장되지 않습니다. Azure에서의 프로덕션 환경에 가장 적합합니다. - 계정 이름 및 키:
N8N_EXTERNAL_STORAGE_AZURE_ACCOUNT_NAME과N8N_EXTERNAL_STORAGE_AZURE_ACCOUNT_KEY를 설정합니다.
Azurite나 소버린 클라우드 같은 커스텀 엔드포인트를 사용하는 경우에만 N8N_EXTERNAL_STORAGE_AZURE_ENDPOINT를 설정하세요.
| Variable | Type | Default | Description |
|---|---|---|---|
N8N_EXTERNAL_STORAGE_AZURE_CONNECTION_STRING |
String | - | Azure Blob Storage의 연결 문자열입니다. 설정 시 계정 이름 및 키보다 우선합니다. |
N8N_EXTERNAL_STORAGE_AZURE_ACCOUNT_NAME |
String | - | 스토리지 계정 이름입니다. 계정 키 또는 관리 ID와 함께 사용합니다. |
N8N_EXTERNAL_STORAGE_AZURE_ACCOUNT_KEY |
String | - | 스토리지 계정 키입니다. 계정 이름과 함께 사용합니다. |
N8N_EXTERNAL_STORAGE_AZURE_CONTAINER_NAME |
String | - | 실행 데이터 및/또는 바이너리 데이터를 저장할 블롭 컨테이너의 이름입니다. Azure Blob Storage에 필수입니다. |
N8N_EXTERNAL_STORAGE_AZURE_ENDPOINT |
String | - | 커스텀 블롭 엔드포인트입니다. 예: Azurite 또는 소버린 클라우드. |
N8N_EXTERNAL_STORAGE_AZURE_AUTH_AUTO_DETECT |
Boolean | false |
계정 키 대신 DefaultAzureCredential(관리 ID, 환경, 또는 Azure CLI)을 통해 인증합니다. 활성화하면 계정 키를 무시합니다. |