N8N中文教程
集成节点/Built in_nodes/Credentials

S3 凭据#

你可以使用这些凭据来认证以下节点:

  • S3

前提条件#

在支持 S3 协议的服务器上创建一个账户。可以使用 S3 节点连接通用或非 AWS 的 S3 服务,例如:

  • DigitalOcean Spaces
  • MinIO
  • Wasabi

支持的认证方式#

  • S3 endpoint(S3 端点)

相关资源#

请参考你所使用的 S3 兼容服务提供商的文档以获取更多服务信息。例如,参阅 Wasabi 的 REST API 文档 或 DigitalOcean 的 Spaces API 参考文档。

使用 S3 端点#

要配置此凭据,你需要提供以下信息:

  • S3 端点 (S3 Endpoint) :输入 S3 存储后端的 URL 端点。
  • 区域 (Region) :输入你的 S3 存储所在区域。某些服务商将其称为“区域别名(region slug)”。
  • 访问密钥 ID (Access Key ID) :输入你的 S3 服务商提供的用于访问存储桶(bucket)或空间(space)的访问密钥。某些服务商称之为 API 密钥。
  • 秘密访问密钥 (Secret Access Key) :输入与上述 访问密钥 ID 对应的秘密访问密钥。
  • 强制路径风格 (Force Path Style) :启用后,连接将对存储桶使用路径风格(path-style)寻址。
  • 忽略 SSL 问题 (Ignore SSL Issues) :启用后,即使 SSL 证书验证失败,n8n 仍会建立连接。

以下是 DigitalOcean Spaces 和 Wasabi 的详细使用说明。如果您使用的是其他提供商,请参考其官方文档以获取更多信息。

使用 DigitalOcean Spaces#

要配置适用于 DigitalOcean Spaces 的凭据,请执行以下步骤:

  1. 在 DigitalOcean 控制面板中,进入 Settings(设置)。您的 endpoint(终端节点)会在此列出。在该 endpoint 前添加 https://,然后将其填入 n8n 中的 S3 Endpoint(S3 终端节点)字段。

    • 您的 DigitalOcean endpoint 取决于存储桶所在的区域(data center region)。
  2. Region(区域)字段中,输入您的存储桶所在区域,例如 nyc3

    • 如果您计划使用此凭据创建新的 Spaces,请改为输入 us-east-1
  3. 在 DigitalOcean 控制面板中,前往 API 页面。

  4. 打开 Spaces Keys(Spaces 密钥)选项卡。

  5. 点击 Generate New Key(生成新密钥)。

  6. 为密钥输入一个名称,例如 n8n integration,然后点击确认勾选框。

  7. 复制显示在名称旁边的 Key(密钥),并将其作为 Access Key ID(访问密钥 ID)填入 n8n。

  8. 复制 Secret(密钥值),并将其作为 Secret Access Key(秘密访问密钥)填入 n8n。

    • 更多关于生成密钥和密钥值的信息,请参阅 使用访问密钥共享存储桶访问权限。
  9. 除非您希望使用子域名/虚拟调用格式(subdomain/virtual calling format),否则请保持 Force Path Style(强制路径样式)开关关闭。

  10. 决定 n8n 凭据如何处理 SSL:

    • 若要遵守 SSL 证书验证,请保持默认设置,即关闭 Ignore SSL Issues(忽略 SSL 问题)。
    • 若希望即使 SSL 证书验证失败也能连接,请开启 Ignore SSL Issues

有关更多信息,请参考 DigitalOcean 的 Spaces API 参考文档。

使用 Wasabi#

要将凭据配置为与 Wasabi 配合使用,请执行以下操作:

  1. 对于 S3 Endpoint(终端节点),输入您存储桶所在区域的服务 URL。请以 https:// 开头。
    • 请参考 Wasabi 存储区域的服务 URL 来确定正确的 URL。
  2. 对于 Region(区域),输入服务 URL 中的区域缩写部分。例如,如果 S3 Endpoint 输入的是 https://s3.us-east-2.wasabisys.com,则区域为 us-east-2
  3. 使用根用户登录您的 Wasabi 控制台。
  4. 打开 Menu(菜单),选择 Access Keys(访问密钥)
  5. 选择 CREATE NEW ACCESS KEY(创建新的访问密钥)
  6. 选择该密钥是用于 Root User(根用户) 还是 Sub-User(子用户),然后选择 CREATE(创建)
  7. 复制 Access Key(访问密钥),并在 n8n 中将其作为 Access Key ID(访问密钥 ID) 输入。
  8. 复制 Secret Key(私密密钥),并在 n8n 中将其作为 Secret Access Key(私有访问密钥) 输入。
    • 更多关于生成密钥和私钥的信息,请参考 创建新的访问密钥。
  9. Wasabi 建议开启 Force Path Style(强制路径样式) 开关,“因为路径样式在存储桶命名方面提供了最大的灵活性,避免了域名相关问题。” 更多信息请参阅 Wasabi 的 REST API 简介。
  10. 决定 n8n 凭据如何处理 SSL:
    • 若要遵守 SSL 证书验证,请保持默认设置,即关闭 Ignore SSL Issues(忽略 SSL 问题)
    • 若希望即使 SSL 证书验证失败也能连接,请开启 Ignore SSL Issues(忽略 SSL 问题)