n8n 中文文档

创建和编辑凭据

凭证是安全存储的身份验证信息,用于将 n8n 工作流程连接到 API 或数据库等外部服务。

提示

在 n8n Cloud 中,受支持的 AI 模型和服务完全不需要凭据:在节点上选择 Use Gateway credits 使用 Gateway credits,即可使用 Gateway credits 运行,而无需使用您自己的 API key。

创建凭证

  1. 选择侧面菜单左上角的 universal create resource icon Create 创建 按钮。选择凭证。
  2. 如果您的 n8n 实例支持项目[^1],您还需要选择是否在您的个人空间或您有权访问的特定项目中创建凭证。如果您使用的是社区版本,您将在您的个人空间中创建凭据。
  3. 选择您想要连接的应用程序或服务。

Or:

  1. 使用 Overview 概述 页面或特定项目右上角的 universal create resource icon Create 创建 按钮。选择凭据。
  2. 如果您从 Overview 概述 页面执行此操作,您将在您的个人空间内创建凭据。如果您在项目内部执行此操作,则将在该特定项目内创建凭证。
  3. 选择您想要连接的应用程序或服务。

在工作流编辑器上编辑节点时,您还可以在凭据下拉列表中创建新凭据。

进入凭证模式后,输入您的服务所需的详细信息。请参阅凭据库 中您的服务页面以获取指导。

当您保存凭据时,n8n 会对其进行测试以确认其有效。

提示

Credentials naming 凭证命名

默认情况下,n8n 将新凭据命名为“_节点名称_帐户”。您可以通过单击名称来重命名凭据,类似于重命名节点。最好为他们提供可识别应用程序或服务、凭证类型和用途的名称。命名约定可以让您更轻松地跟踪和识别您的凭据。

选择凭证类型

创建或编辑 OAuth 凭证时,你需要选择 Credential type 凭证类型:

  • Fixed credential 固定凭证:无论谁运行工作流,都使用同一个凭证。这是默认凭证行为。
  • End-user credential 最终用户凭证:在运行时使用每个用户自己的凭证,并且只有该用户可以查看和使用该凭证。

最终用户凭证让工作流使用触发它的人的凭证运行,并让每个用户的数据对其本人保持私有。Fixed credential 固定凭证和 End-user credential 最终用户凭证类型选项适用于 n8n Cloud Enterprise 和自托管 Enterprise 上的 OAuth 凭证。要了解如何设置,请参阅最终用户凭证。

允许的 HTTP 请求域

Allowed HTTP Request Domains 允许的 HTTP 请求域 字段出现在许多基于 Web 的 API 和服务的 n8n 凭证上。它控制在 HTTP Request HTTP请求 节点中选择凭证时允许在哪些域中使用该凭证。当凭证在其自己的专用节点中使用时,它不起作用。

该字段有三个选项:

  • All 全部:该凭证可用于任何 URL。
  • Specific Domains 特定领域:限制到特定域(提供逗号分隔的列表,如 httpbin.org, api.github.com)
  • None 无:该凭证被完全阻止在 HTTP Request HTTP请求 节点中使用。

此字段可防止凭证滥用,例如将凭证发送到预期域之外的 URL。

凭证中的表达式

您可以使用表达式[^2] 在工作流程运行时动态设置凭据:

  1. 在您的工作流程中,找到包含凭据的数据路径。这取决于数据中的确切参数名称。确保当您到达需要它的节点时,包含凭证的数据在工作流中可用。
  2. 创建凭据时,将鼠标悬停在要使用表达式的字段上。
  3. 打开 Expression 表达。
  4. 输入您的表情。

示例工作流程

工作流示例 https://raw.githubusercontent.com/n8n-io/n8n-docs/refs/heads/main/docs/_workflows/credentials/dynamic_credentials_using_expressions.json

使用示例

要将模板加载到您的 n8n 实例中:

  1. 下载工作流程 JSON 文件。
  2. 在您的 n8n 实例中打开一个新工作流程。
  3. 复制 JSON,或选择 Workflow menu 工作流程菜单 Workflow menu icon > Import from file... 从文件导入...。

示例工作流使用便签来指导您:

  • 黄色:注释和信息。
  • 绿色:运行工作流的说明。
  • 橙色:您需要更改某些内容以使工作流正常工作。
  • 蓝色:突出显示示例的关键功能。

[^1]: n8n 项目允许您将工作流、变量和凭据划分到不同组中,以便管理。项目可通过共享和隔离相关资源,帮助团队更轻松地协作。 [^2]: 在 n8n 中,表达式可以通过执行 JavaScript 代码动态填充节点参数。您无需提供静态值,而是可以使用 n8n 表达式语法,利用来自先前节点、其他工作流或 n8n 环境的数据定义值。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。