n8n 中文文档

S3 凭证

您可以使用这些凭据来验证以下节点:

先决条件

在兼容 S3 的服务器上创建账户。使用 S3 节点处理通用或非 AWS S3,如:

支持的认证方式

  • S3端点

相关资源

参考您的兼容 S3 提供商的文档了解有关服务的更多信息。例如,参考 Wasabi 的 REST API 文档{:target="_blank" .external-link}或 DigitalOcean 的 Spaces API 参考文档{:target="_blank" .external-link}。

使用 S3 端点

要配置此凭据,您需要:

  • 一个 S3 Endpoint:输入 S3 存储后端的 URL 端点。
  • 一个 Region 区域:输入您的 S3 存储的区域。某些提供商称之为"区域标识"。
  • 一个 Access Key ID 访问密钥 ID:输入您的 S3 提供商用于访问存储桶或空间的 S3 访问密钥。某些提供商称之为 API 密钥。
  • 一个 Secret Access Key 密钥访问密钥:输入 Access Key ID 的密钥访问密钥。
  • Force Path Style 强制路径样式:开启时,连接对存储桶使用路径样式寻址。
  • Ignore SSL Issues 忽略 SSL 问题:开启时,即使 SSL 证书验证失败,n8n 也会连接。

下面提供了 DigitalOcean Spaces、Google Cloud Storage、Tigris 和 Wasabi 的更详细说明。如果你使用其他提供商,请参考其文档了解更多信息。

使用 DigitalOcean Spaces

要配置凭据以与 DigitalOcean spaces 一起使用:

  1. 在 DigitalOceans 中,转到控制面板并打开 Settings。您的端点应该在那里列出。在该端点前添加 https:// 并将其作为 S3 Endpoint 输入到 n8n 中。
    • 您的 DigitalOceans 端点取决于您的存储桶所在的数据中心区域。
  2. 对于 Region,输入您的存储桶所在的区域,例如 nyc3。
    • 如果您计划使用此凭据创建新的 Spaces,请改为输入 us-east-1。
  3. 从您的 DigitalOceans 控制面板,转到 API{:target="_blank" .external-link}。
  4. 打开 Spaces Keys 标签页。
  5. 选择 Generate New Key。
  6. 为您的密钥输入 Name,如 n8n integration 并选择复选标记。
  7. 复制名称旁边显示的 Key 并将其作为 Access Key ID 输入到 n8n 中。
  8. 复制 Secret 值并将其作为 Secret Access Key 输入到 n8n 中。
  9. 保持 Force Path Style 切换关闭,除非您要使用子域/虚拟调用格式。
  10. 决定您希望 n8n 凭据如何处理 SSL:
    • 要遵守 SSL 证书验证,保持默认的 Ignore SSL Issues 关闭。
    • 要即使 SSL 证书验证失败也连接,开启 Ignore SSL Issues。

参考 DigitalOcean 的 Spaces API 参考文档{:target="_blank" .external-link}了解更多信息。

使用底格里斯河

要配置凭据以与 Tigris 一起使用:

  1. 对于 S3 Endpoint,输入 https://t3.storage.dev。
    • Tigris 使用单一全局端点,不需要选择区域,数据会从最接近请求的区域提供。
  2. 对于 Region 区域,输入 auto。
    • SigV4 请求签名需要该值,但 Tigris 服务会忽略它。
  3. 登录 Tigris Console。
  4. 从侧边栏选择 Access Keys。
  5. 在右上角选择 Create New Access Key。
  6. 输入密钥 Name 名称,例如 n8n integration,然后选择 Create。
  7. 复制显示的 Access Key ID(以 tid_ 开头),并将其作为 Access Key ID 输入到 n8n 中。
  8. 复制显示的 Secret Access Key(以 tsec_ 开头),并将其作为 Secret Access Key 输入到 n8n 中。
    • 该密钥只显示一次。如果丢失,你需要创建新密钥。
  9. 保持 Force Path Style 强制路径样式开关关闭。Tigris 使用虚拟主机样式寻址。
  10. 决定 n8n 凭据如何处理 SSL:
    • 要遵循 SSL 证书验证,请保持默认的 Ignore SSL Issues 忽略 SSL 问题关闭。
    • 要即使 SSL 证书验证失败也连接,请开启 Ignore SSL Issues 忽略 SSL 问题。

更多信息请参阅 Tigris 的 Manage Access Keys 文档。

使用 Google Cloud Storage

n8n 也有专门的 Google Cloud Storage 节点。如果你想保留现有的 S3 工作流,或使用 HMAC 密钥而不是 Google 凭据进行身份验证,请通过 Google Cloud Storage 的 XML API 使用 S3 节点。

要配置凭据以与 Google Cloud Storage 一起使用:

  1. 对于 S3 Endpoint,输入 https://storage.googleapis.com。
  2. 对于 Region,输入 auto。
  3. 在 Google Cloud 控制台中,前往 Cloud Storage > Settings,打开 Interoperability 标签页。
  4. 选择 Create a key for a service account,选择 n8n 应使用的 service account,然后选择 Create key。
  5. 复制 Access key,并在 n8n 中作为 Access Key ID 输入。
  6. 复制 Secret,并在 n8n 中作为 Secret Access Key 输入。
  7. 打开 Force Path Style 强制路径样式开关。
  8. 决定 n8n 凭据如何处理 SSL:
    • 要遵循 SSL 证书验证,请保持默认的 Ignore SSL Issues 忽略 SSL 问题关闭。
    • 要即使 SSL 证书验证失败也连接,请开启 Ignore SSL Issues 忽略 SSL 问题。

授予该 service account 对存储桶的访问权限:

  • 对象角色,例如用于上传、下载和删除的 Storage Object Admin。
  • storage.buckets.get 权限,例如通过 Storage Legacy Bucket Reader 角色。S3 节点会在每次文件或文件夹操作之前,以及 Bucket > Search 之前查找存储桶位置。没有该权限时,这些操作会失败。

如果存储桶使用统一的存储桶级访问权限,请把 S3 节点的 ACL 选项留空。Google Cloud Storage 会拒绝在这些存储桶上设置对象 ACL 的请求。

使用芥末

要配置凭据以与 Wasabi 一起使用:

  1. 对于 S3 Endpoint,输入您的存储桶区域的服务 URL。以 https:// 开头。
  2. 对于 Region,输入服务 URL 的区域标识部分。例如,如果您输入 https://s3.us-east-2.wasabisys.com 作为 S3 Endpoint,us-east-2 就是区域。
  3. 以根用户身份登录您的 Wasabi 控制台。
  4. 打开 Menu 并选择 Access Keys。
  5. 选择 CREATE NEW ACCESS KEY。
  6. 选择密钥是用于 Root User 还是 Sub-User 并选择 CREATE。
  7. 复制 Access Key 并将其作为 Access Key ID 输入到 n8n 中。
  8. 复制 Secret Key 并将其作为 Secret Access Key 输入到 n8n 中。
  9. Wasabi 建议开启 Force Path Style 切换"因为路径样式在存储桶名称中提供最大的灵活性,避免域名问题。"参考 Wasabi REST API 介绍{:target="_blank" .external-link}了解更多信息。
  10. 决定您希望 n8n 凭据如何处理 SSL:
    • 要遵守 SSL 证书验证,保持默认的 Ignore SSL Issues 关闭。
    • 要即使 SSL 证书验证失败也连接,开启 Ignore SSL Issues。

其他兼容 S3 的提供商

其他兼容 S3 的提供商可能会发布各自配置此凭据的说明:

  • Neon Object Storage。开启 Force Path Style 强制路径样式,因为 Neon 仅支持路径样式寻址。关闭该选项时,节点会因 SSL 问题而失败,而 Ignore SSL Issues 忽略 SSL 问题无法修复此错误。
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。