请求检查
来源与一次性验证
允许的来源用于指定哪些网站页面可以向表单提交。它由协议、主机名和端口组成,不包括页面路径。假设你配置了 https://www.example.com:
| 页面地址 | 是否匹配 | 原因 |
|---|---|---|
https://www.example.com/contact | 是 | 路径不属于来源 |
https://example.com/contact | 否 | 主机名不同 |
http://www.example.com/contact | 否 | 协议不同 |
https://preview.example.com | 否 | 预览主机名需单独添加 |
http://localhost:3000 | 否 | 本地协议与端口需单独添加 |
请求规则
- 只允许完全匹配的 Origin:协议、主机名和端口都必须一致。子域名或不同端口都是不同的来源;不会隐含通配匹配。
- FormPostbox 最多保留 7 天内的最近一次被拒绝来源及其时间,帮助已登录的网站所有者诊断不匹配。该诊断不保存被拒绝的消息正文或 IP 地址。打开表单的配置检查即可与允许的来源对比。
- 受保护的网站需在
cf-turnstile-response中携带一个有效且一次性的 Turnstile 响应。已使用或缺失的响应会被拒绝,且不占用有效提交额度。未开启防护的网站提交时完全不需要 Turnstile 响应。 - 在
_intent_id中携带表单的请求 intent。在表单实例开始时生成一次,网络重试时复用它,只有开始一条新消息时才生成新值。 - 永远不要把 Turnstile 私密密钥放进公开页面或源码包。
在哪里管理这些设置
- 允许的来源 — 网站 → 你的网站 → 设置 → 允许的来源。每行一个精确来源,最多 20 个;不支持通配符和路径。修改会立即对新提交生效。添加网站时会保留一个名额;设置页编辑完整列表。
- Turnstile widget 主机名 — 在 Cloudflare 的 widget 内部设置。它与允许来源是不同的值。Turnstile 设置指南把两者并排展示。
当一条提交因为来源被拒绝时,表单页面会显示 最近有来源不匹配 提示,其中包含被拒绝的确切值。把它与允许列表对比并修正差异——通常是协议、子域名或端口。

仍需帮助?联系 support@formpostbox.com. 请附上相关文档主题和脱敏后的错误信息,不要发送密钥或访客消息。
浏览全部主题 ↑