在本地开发时测试表单
使用本地 Web 服务器预览表单,然后将预览来源加入 FormPostbox 网站,再发送测试提交。
适用情况
开发或检查自己机器上的表单时使用这些步骤。本地测试与已发布的网站是两个环境;发布网站改动后,还要在已发布页面上重新测试。
通过 HTTP 提供页面
启动项目框架的开发服务器或本地静态服务器,然后在浏览器打开服务器输出的 http://localhost:端口 或 http://127.0.0.1:端口 地址。使用服务器实际显示的端口。端口属于来源的一部分,因此 http://localhost:3000 与 http://localhost:5173 是两个不同来源。
不要直接通过 file://… 打开文件。这种地址没有浏览器来源检查所需的常规网站来源。如果项目使用本地 HTTPS,请使用实际的 HTTPS 来源。
允许本地来源
在 FormPostbox 中打开网站,选择表单使用的网站,再打开设置。在允许的来源中添加完整的本地来源,包括协议和端口,不要添加页面路径,然后保存网站设置。更换端口后,请把新来源也加入列表。
如果项目部署在预览环境,请加入该预览网站准确的 HTTPS 来源。预览主机名与 localhost 及生产主机名各不相同。
提交测试消息并检查结果
在本地浏览器打开表单并提交一次,然后查看收件箱。使用 JSON 的接入应仅在响应包含 saved: true 时显示消息已保存。打开记录查看独立的通知结果。有效并被接受的测试会占用本 UTC 月额度中的一次提交。
仅在本地使用 Turnstile 测试密钥
Cloudflare 为本地开发和自动化测试提供可预测结果的 Turnstile 虚拟密钥。当前测试值和行为请查看Cloudflare 官方 Turnstile 测试指南。
使用 formpostbox.com 接收提交时,即使网站前端在本地运行,也不能向正式服务保存虚拟测试私密密钥。请为本地测试创建单独的网站与表单配置;可不启用防护,或使用允许本地主机名的真实 Cloudflare widget。虚拟密钥仅适用于单独运行并明确启用测试模式的本地 FormPostbox 服务。公开 Site Key 与私密 Secret Key 用途不同:Site Key 放在浏览器组件中,Secret Key 保存于 FormPostbox,不能写入前端代码。只有 Site Key、没有配套 Secret Key 时,防护并未开启。已发布的网站应在生产配置中保留来自同一 Cloudflare 组件的真实密钥;不要将其替换成虚拟测试密钥。
发布后在正式页面再次测试
发布网站改动后,请通过生产来源打开实际页面并提交一条新的测试消息。确认生产来源已列在网站允许列表中;如果启用了防护,还要确认 Turnstile 组件包含生产主机名。本地测试成功不能代替对已发布配置的检查。
常见问题
浏览器显示 CORS 或网络错误。请将地址栏中的完整来源与允许来源进行比较,包括端口。来源不允许时,浏览器可能隐藏服务端返回的错误内容。
本地 Turnstile 验证失败。如果接收端是 formpostbox.com,请检查真实 widget 是否允许本地主机名,且两个密钥来自同一 widget。只有接收端本身也是本地测试服务时,才按官方文档配对虚拟密钥。修改防护设置后,重新加载页面,让表单取得当前配置。
相关指南:允许的来源、Turnstile 配置、提交故障排查。
仍需帮助?联系 support@formpostbox.com. 请附上相关文档主题和脱敏后的错误信息,不要发送密钥或访客消息。
浏览全部主题 ↑