外部数据存储环境变量
提示
File-based configuration 基于文件的配置
您可以将 _FILE 添加到各个变量,以在单独的文件中提供其配置。有关更多详细信息,请参阅将敏感数据保存在单独的文件中。
有关使用外部存储存储二进制数据的更多信息,请参阅外部存储。
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
N8N_EXTERNAL_STORAGE_S3_HOST |
字符串 | - | S3 兼容外部存储中 n8n 存储桶的主机。例如 s3.us-east-1.amazonaws.com。 |
N8N_EXTERNAL_STORAGE_S3_BUCKET_NAME |
字符串 | - | S3 兼容外部存储中 n8n 存储桶的名称。 |
N8N_EXTERNAL_STORAGE_S3_BUCKET_REGION |
字符串 | - | S3 兼容外部存储中 n8n 存储桶的区域。例如 us-east-1。 |
N8N_EXTERNAL_STORAGE_S3_ACCESS_KEY |
字符串 | - | S3 兼容外部存储中的访问密钥。 |
N8N_EXTERNAL_STORAGE_S3_ACCESS_SECRET |
字符串 | - | S3 兼容外部存储中的访问密钥 secret。 |
N8N_EXTERNAL_STORAGE_S3_AUTH_AUTO_DETECT |
布尔值 | - | 使用自动凭据检测对外部存储的 S3 调用进行身份验证。这会忽略访问密钥及其 secret,改用默认凭据提供程序链。 |
Azure Blob 存储
提示
功能可用性
在 Azure Blob Storage 中存储执行数据或二进制数据的功能适用于:
- Self-hosted: Business、Enterprise
n8n Cloud 不支持此功能。添加许可证密钥即可解锁。
要将执行数据存储在 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 按以下顺序检查:
- Connection string 连接字符串:设置
N8N_EXTERNAL_STORAGE_AZURE_CONNECTION_STRING。此方式优先于其他方式,因此设置后 n8n 会忽略账户名称、密钥和自动检测。它最简单,适合使用 Azurite 进行本地测试。 - Auto-detect 自动检测:设置
N8N_EXTERNAL_STORAGE_AZURE_ACCOUNT_NAME,并将N8N_EXTERNAL_STORAGE_AZURE_AUTH_AUTO_DETECT设为true。n8n 通过 Azure 的DefaultAzureCredential链(托管身份、环境或 Azure CLI)进行身份验证,因此 n8n 配置中不必保存密钥。最适合 Azure 上的生产环境。 - Account name and key 账户名称和密钥:设置
N8N_EXTERNAL_STORAGE_AZURE_ACCOUNT_NAME和N8N_EXTERNAL_STORAGE_AZURE_ACCOUNT_KEY。
仅当使用 Azurite 或主权云等自定义端点时,才设置 N8N_EXTERNAL_STORAGE_AZURE_ENDPOINT。
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
N8N_EXTERNAL_STORAGE_AZURE_CONNECTION_STRING |
字符串 | - | Azure Blob Storage 的连接字符串。设置后优先于账户名称和密钥。 |
N8N_EXTERNAL_STORAGE_AZURE_ACCOUNT_NAME |
字符串 | - | 存储账户名称。与账户密钥或托管身份配合使用。 |
N8N_EXTERNAL_STORAGE_AZURE_ACCOUNT_KEY |
字符串 | - | 存储账户密钥。与账户名称配合使用。 |
N8N_EXTERNAL_STORAGE_AZURE_CONTAINER_NAME |
字符串 | - | 用于存储执行数据的 blob 容器名称。Azure Blob Storage 必填。 |
N8N_EXTERNAL_STORAGE_AZURE_ENDPOINT |
字符串 | - | 自定义 blob 端点,例如 Azurite 或主权云的端点。 |
N8N_EXTERNAL_STORAGE_AZURE_AUTH_AUTO_DETECT |
布尔值 | false |
通过 DefaultAzureCredential(托管身份、环境或 Azure CLI)进行身份验证,而不是使用账户密钥。启用后会忽略账户密钥。 |
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。