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 的凭据,请执行以下步骤:
-
在 DigitalOcean 控制面板中,进入 Settings(设置)。您的 endpoint(终端节点)会在此列出。在该 endpoint 前添加
https://,然后将其填入 n8n 中的 S3 Endpoint(S3 终端节点)字段。- 您的 DigitalOcean endpoint 取决于存储桶所在的区域(data center region)。
-
在 Region(区域)字段中,输入您的存储桶所在区域,例如
nyc3。- 如果您计划使用此凭据创建新的 Spaces,请改为输入
us-east-1。
- 如果您计划使用此凭据创建新的 Spaces,请改为输入
-
在 DigitalOcean 控制面板中,前往 API 页面。
-
打开 Spaces Keys(Spaces 密钥)选项卡。
-
点击 Generate New Key(生成新密钥)。
-
为密钥输入一个名称,例如
n8n integration,然后点击确认勾选框。 -
复制显示在名称旁边的 Key(密钥),并将其作为 Access Key ID(访问密钥 ID)填入 n8n。
-
复制 Secret(密钥值),并将其作为 Secret Access Key(秘密访问密钥)填入 n8n。
- 更多关于生成密钥和密钥值的信息,请参阅 使用访问密钥共享存储桶访问权限。
-
除非您希望使用子域名/虚拟调用格式(subdomain/virtual calling format),否则请保持 Force Path Style(强制路径样式)开关关闭。
-
决定 n8n 凭据如何处理 SSL:
- 若要遵守 SSL 证书验证,请保持默认设置,即关闭 Ignore SSL Issues(忽略 SSL 问题)。
- 若希望即使 SSL 证书验证失败也能连接,请开启 Ignore SSL Issues。
有关更多信息,请参考 DigitalOcean 的 Spaces API 参考文档。
使用 Wasabi#
要将凭据配置为与 Wasabi 配合使用,请执行以下操作:
- 对于 S3 Endpoint(终端节点),输入您存储桶所在区域的服务 URL。请以
https://开头。- 请参考 Wasabi 存储区域的服务 URL 来确定正确的 URL。
- 对于 Region(区域),输入服务 URL 中的区域缩写部分。例如,如果 S3 Endpoint 输入的是
https://s3.us-east-2.wasabisys.com,则区域为us-east-2。 - 使用根用户登录您的 Wasabi 控制台。
- 打开 Menu(菜单),选择 Access Keys(访问密钥)。
- 选择 CREATE NEW ACCESS KEY(创建新的访问密钥)。
- 选择该密钥是用于 Root User(根用户) 还是 Sub-User(子用户),然后选择 CREATE(创建)。
- 复制 Access Key(访问密钥),并在 n8n 中将其作为 Access Key ID(访问密钥 ID) 输入。
- 复制 Secret Key(私密密钥),并在 n8n 中将其作为 Secret Access Key(私有访问密钥) 输入。
- 更多关于生成密钥和私钥的信息,请参考 创建新的访问密钥。
- Wasabi 建议开启 Force Path Style(强制路径样式) 开关,“因为路径样式在存储桶命名方面提供了最大的灵活性,避免了域名相关问题。” 更多信息请参阅 Wasabi 的 REST API 简介。
- 决定 n8n 凭据如何处理 SSL:
- 若要遵守 SSL 证书验证,请保持默认设置,即关闭 Ignore SSL Issues(忽略 SSL 问题)。
- 若希望即使 SSL 证书验证失败也能连接,请开启 Ignore SSL Issues(忽略 SSL 问题)。