n8n 表单触发节点
当用户提交表单时,使用 n8n 表单触发器启动工作流程,从表单中获取输入数据。该节点生成表单网页供您使用。
您可以添加更多页面以继续使用 n8n表格 节点的表单。
构建和测试工作流程
构建或测试工作流程时,请使用 测试 URL。使用测试 URL 可确保您可以在编辑器 UI 中查看传入的数据,这对于调试非常有用。
有两种方法可以测试:
- 选择执行步骤。 n8n 打开表单。当您提交表单时,n8n 运行节点,但不运行工作流程的其余部分。
- 选择执行工作流程。 n8n 打开表单。当您提交表单时,n8n 运行工作流程。
生产工作流程
当您的工作流程准备就绪后,切换到使用 Production URL。然后,您可以发布工作流程,当用户提交表单时,n8n 会自动运行它。
使用生产 URL 时,请确保您已保存并发布工作流程。流经表单触发器的数据在生产 URL 的编辑器 UI 中不可见。
使用查询参数 设置默认选择
您可以通过使用 查询参数 和 n8n 表单触发器提供的初始 URL 来设置字段的初始值。每个 表单中的页面 都会收到发送到 n8n 表单触发器 URL 的相同查询参数。
提示
仅用于生产
查询参数仅在生产模式下使用表单时可用。 n8n 在测试模式下不会填充查询参数中的字段值。
使用查询参数时,百分比编码 使用特殊字符的任何字段名称或值。这可确保 n8n 使用给定字段的初始值。您可以使用 URL 编码/解码 等工具使用百分比编码来格式化查询参数。
例如,假设您有一个具有以下属性的表单:
- 生产 URL:
https://my-account.n8n.cloud/form/my-form - 领域:
name:Jane Doeemail:[email protected]
通过查询参数和百分比编码,您可以使用以下 URL 将初始字段值设置为上述数据:
https://my-account.n8n.cloud/form/my-form?email=jane.doe%40example.com&name=Jane%20Doe
此处,百分比编码将 at 符号 (@) 替换为字符串 %40,将空格字符 () 替换为字符串 %20。这将为这些字段设置初始值,无论它们出现在表单的哪一页上。
节点参数
这些是主要的节点配置字段:
认证
- 基本授权
- n8n 用户验证
- 无
使用基本身份验证
要配置此凭据,您需要:
- 您用于访问 HTTP 请求所针对的应用程序或服务的 用户名。
- 与该用户名一起使用的 密码。
使用 n8n 用户验证
只有登录到此 n8n 实例的用户才能查看或提交表单。
- 加载表单的未经身份验证的访问者将被重定向到 n8n 登录页面。
- 未经身份验证的表单提交会收到 401 响应。
- 默认情况下,n8n 将提交用户的 ID、电子邮件、名字和姓氏添加到输出数据中。关闭 节点选项 中的 在输出中包含用户 以排除此问题。
选择 n8n User Auth n8n 用户验证 时,会显示 Require Workflow Execute Permission 需要工作流执行权限 切换开关。启用后,触发用户还必须拥有在工作流所属项目中执行该工作流的权限。已登录但没有该工作流执行权限的用户无法提交表单。此功能适合与最终用户凭证配合使用,让每位用户通过自己连接的账户运行工作流。
表单 URL
表单触发器节点有两个 URL:测试 URL 和 生产 URL。 n8n 在节点面板顶部显示 URL。选择 测试 URL 或 生产 URL 以切换显示哪个 URL n8n。

- 测试 URL:如果工作流未处于活动状态,当您选择 执行步骤 或 执行工作流 时,n8n 会注册测试 Webhook。当调用URL时,n8n显示工作流中的数据。
- 生产 URL:n8n 在您发布工作流程时注册生产 Webhook。使用生产URL时,n8n不显示工作流程中的数据。您仍然可以查看生产执行的工作流程数据。选择工作流中的 执行 选项卡,然后选择要查看的工作流执行。
表单路径
为表单设置自定义别名。
提示
Feature availability 功能可用性
在节点版本 2.1 及更早版本中,Form Path 表单路径是主要参数。从节点版本 2.2 开始,该参数为可选项,可在节点选项中设置。
如果使用 API 或通过编辑 JSON 创建或更新工作流,请在 parameters.options.path 中设置别名。在节点版本 2.2 及更高版本中,n8n 加载工作流时会忽略顶层的 parameters.path。此时,表单 URL 会以 Webhook ID 结尾。
表格标题
输入表单的标题。 n8n 在表单上显示 表单标题 作为网页标题和主 h1 标题。
表格 描述
输入表单的说明。 n8n 将表单描述显示为表单上 h1 主标题下方的副标题。使用 \n 或 <br> 添加换行符。
有关允许和限制的 HTML 标签的信息,请参阅 HTML 安全和允许的标签。
表单元素
为您的表单创建问题字段。选择 添加表单元素 以添加新字段。
每个字段都有以下设置:
- 字段标签:输入显示在呈现表单上的输入字段上方的标签。
- 字段名称:此名称用于表单触发器节点的输出。使用它来引用下游节点中的表单字段。
- 元素类型:从复选框、自定义 HTML、日期、下拉菜单、电子邮件、文件、隐藏字段、数字、密码、单选按钮、文本或文本区域进行选择。
- 选择 复选框 以在表单中包含复选框元素。默认情况下,表单用户可以选择的复选框数量没有限制。您可以通过将“限制选择”选项的值指定为“精确数字”、“范围”或“无限制”来设置限制。
- 选择自定义 HTML 以插入任意 HTML。
- 您可以包含链接、图像、视频等元素。不能包含
<script>、<style>或<input>元素。有关详细信息,请参阅 HTML 安全和允许的标签。 - 默认情况下,自定义 HTML 字段不包含在节点输出中。要在输出中包含自定义 HTML 内容,请填写关联的 元素名称 字段。
- 您可以包含链接、图像、视频等元素。不能包含
- 选择 日期 以在表单中包含日期选择器。有关格式化日期的更多信息,请参阅 Luxon 的日期和时间。
- 选择 下拉列表 > 添加字段选项 以添加多个选项。默认情况下,下拉菜单是单选的。要使其成为多项选择,请打开多项选择。
- 选择单选按钮以在表单中包含单选按钮元素。
- 选择 隐藏字段 以包含表单元素而不将其显示在表单上。您可以使用 Field Value 参数设置默认值,或使用 查询参数 传递字段值。
- 占位符:定义要在兼容表单元素内显示的示例文本。 电子邮件、数字、密码、文本 和 文本区域 支持占位符。
- 默认值:定义将在兼容的表单元素中预填充或预选择的默认值。除了自定义 HTML、文件、隐藏字段和 密码之外,所有表单元素均支持默认值。
- 必填字段:打开以要求用户填写表单上的此字段。
当 时响应
选择 n8n 何时发送对表单提交的响应。您可以在以下情况下回复:
- 表单已提交:用户提交表单后立即向其发送响应。
- 工作流程完成:如果您希望工作流程在向用户发送响应之前完成其执行,请使用此选项。如果工作流程出错,它会向用户发送响应,告诉他们提交表单时出现问题。
节点选项
选择 添加选项 以查看更多配置选项:
- 附加 n8n 属性:关闭以隐藏表单底部的 使用 n8n 属性自动生成的表单。
- 按钮标签:用于表单提交按钮的标签。 n8n 显示 按钮标签 作为提交按钮的名称。
- Form Path 表单路径:表单 URL 的最后一段,用于测试和生产。它会替换自动生成的 UUID,成为 URL 的最后一部分。从节点版本 2.2 开始可用。在更早版本中,Form Path 表单路径是主要参数(请参阅表单路径)。
- 忽略机器人:打开以忽略来自链接预览器和网络爬虫等机器人的请求。
- 在输出中包含用户:仅当身份验证设置为 n8n 用户身份验证时相关。关闭以从节点的输出中排除提交用户的 ID、电子邮件、名字和姓氏(默认情况下打开)。
- 使用工作流程时区:启用以使用 工作流程设置 中的时区而不是 UTC(默认)。这会影响节点输出中
submittedAt时间戳的值。 - 自定义表单样式:使用 CSS 覆盖公共表单界面的默认样式。该字段预先填充了默认样式,因此您可以仅更改您需要的内容。
自定义表单触发器节点行为
使用换行符格式化响应文本
您可以使用以下方法之一添加换行符以形成响应文本:
• 在formSubscribedText 字段中使用HTML 格式而不是纯文本
• 在发送响应之前,将换行符 (\n) 替换为 HTML 中断标记 (<br>)
• 如果您需要更多格式控制,请考虑使用自定义 HTML 响应页面
通过身份验证限制表单访问
您可以使用以下选项之一将身份验证添加到表单中:
• 使用 OTP(一次性密码)字段和 TOTP 节点验证进行基于令牌的身份验证 • 添加具有表单身份验证的等待节点作为辅助表单页面 • 将散列密码存储在数据库中并与表单提交进行比较以进行验证 • 如果您需要高级身份验证,请使用 Google Forms 等外部身份验证提供商
HTML 安全和允许的标签
n8n 表单触发器会自动清理 表单描述 字段和 自定义 HTML 表单元素中的 HTML 内容,以防止安全漏洞。虽然支持 HTML 进行格式化,但某些标签和属性受到限制。
n8n 还会在浏览器沙箱中提供表单页面,因此有人提交表单时浏览器不会发送 cookie。如果你自托管 n8n,并将表单放在使用会话 cookie 的身份验证代理之后,请参阅在身份验证代理后通过单独的主机名提供表单。
允许的 HTML 标签
您可以使用以下标签进行格式化:<a>、<b>、<br>、<code>、<div>、<em>、<h1> 到 <h6>、<i>、 <iframe>、<img>、<li>、<ol>、<p>、<pre>、<span>、<strong>、<sub>、 <sup>、<table>、<tbody>、<td>、<tfoot>、<th>、<thead>、<tr>、<u>、 <ul>、<video> 和 <source>。
受限标签
为了安全起见,将自动删除以下标签:<script>、<style>、<input>、<form>、<button> 以及可能启用 XSS 攻击或干扰表单功能的其他潜在危险元素。
属性限制
某些标签上只允许使用特定属性:
- 链接(
<a>):href、target、rel - 图片 (
<img>):src、alt、width、height - 视频 (
<video>):controls、autoplay、loop、muted、poster、width、height - iframe (
<iframe>):src、width、height、frameborder、allow、allowfullscreen、referrerpolicy(自动沙盒) - 表格单元格(
<td>、<th>):colspan、rowspan、scope、headers
所有其他属性在清理过程中都会被删除。仅允许 http:// 和 https:// URL 方案。
模板和示例
浏览 n8n Form Trigger 节点文档集成模板 或 搜索所有模板