跳转至

外部存储#

功能可用性

  • 适用于自托管企业版计划
  • 如果您希望在云企业版中使用此功能，联系 n8n。

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

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

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

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

企业级功能

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

设置#

按照 AWS 文档创建和配置存储桶。您可以使用以下策略，将 <bucket-name> 替换为您创建的存储桶的名称：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
{
 "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 的环境中设置它们：

1
2
3
4
5
export N8N_EXTERNAL_STORAGE_S3_HOST=... # example: 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 中存储二进制数据：

1
2
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 只会清理文件系统中的二进制数据。这在将来可能会改变。

此页面是否
💬 微信

🚀 与作者交流

关注公众号
n8n实战笔记公众号
n8n实战笔记
📚 教程 💡 案例 🔧 技巧
添加微信
添加作者微信
1对1 专业指导
⚡ 快答 🎯 定制 🚀 支持

添加后请直说来意， 看到会回复。谢谢