外部存储#

功能可用性

在自托管企业计划中可用
如果您想在云企业版中访问此功能，请联系 n8n。

n8n 可以外部存储工作流执行产生的二进制数据。此功能有助于避免依赖文件系统存储大量二进制数据。

n8n 将来会为其他数据类型引入外部存储。

在 S3 中存储 n8n 的二进制数据#

n8n 支持 AWS S3 作为工作流执行产生的二进制数据的外部存储。您可以使用其他 S3 兼容服务，如 Cloudflare R2 和 Backblaze B2，但 n8n 不正式支持这些。

企业级功能

您需要企业许可证密钥才能使用外部存储。如果您的许可证密钥过期并且您仍在 S3 模式下，实例将能够从 S3 存储桶读取，但不能写入。

设置#

按照 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_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_EXTERNAL_STORAGE_S3_AUTH_AUTO_DETECT 设置为 true。这将使用默认的凭据提供程序链。

重启服务器以加载新配置。

使用#

启用 S3 后，n8n 将任何新的二进制数据写入和读取到 S3 存储桶。n8n 以此格式将二进制数据写入您的 S3 存储桶：

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

如果 filesystem 仍在 N8N_AVAILABLE_BINARY_DATA_MODES 中列为选项，n8n 继续从文件系统读取存储在文件系统中的较旧二进制数据。

如果您在 S3 中存储二进制数据，然后切换到文件系统模式，只要 s3 仍在 N8N_AVAILABLE_BINARY_DATA_MODES 中列出且您的 S3 凭据仍然有效，实例就会继续读取存储在 S3 中的任何数据。

二进制数据清理

二进制数据清理在活动的二进制数据模式上运行。例如，如果您的实例在 S3 中存储数据，然后您切换到文件系统模式，n8n 只会清理文件系统中的二进制数据。这在将来可能会改变。