配置设置 · Cloudflare Waiting Room docs

您可以为您的 waiting room 自定义各种选项。

仪表板设置

设置		说明
仪表板设置	API 参数	是否必填？	描述	最佳实践
名称 (Name)	`name`	是	唯一的 waiting room 名称。
主机名 (Hostname)	`host`	是	将应用 waiting room 的主机名（不支持通配符）。	不要包含 `http://` 或 `https://`。
路径 (Path)	`path`	否	waiting room 的区分大小写的路径。waiting room 将对所有子路径启用。不支持通配符和查询参数。	如果您的服务器不允许大小写字母，请在您的 `path` 中使用数字。
其他主机名和路径 (Additional Hostnames and Paths)	`additional_routes`	否	将其他主机名和/或路径添加到您的 waiting room 覆盖范围内。	其他主机名必须位于同一区域 (zone) 内。每个 waiting room 的主机名和路径组合必须是唯一的。
自定义 Cookie 后缀 (Custom Cookie Suffix)	`cookie_suffix`	当使用 `additional_routes` 时必填。	自定义您的 waiting room cookie 的后缀。后缀将添加到 `_cfwaitingroom` 中。	确保您的 cookie 名称符合规范。不要频繁更改它。
活跃用户总数 (Total active users)	`total_active_users`	是	在任何给定时间，允许在 `host/path` 中存在的最大活动会话数（必须大于 200）。	设置为源站流量容量的 75%，并根据需要进行调整。调整可能会影响向最终用户显示的预计等待时间。
每分钟新用户数 (New users per minute)	`new_users_per_minute`	是	允许进入 `host/path` 的每分钟用户数的阈值，大于 200 且小于或等于活跃用户总数。	设置为峰值流量的 100%，以确保仅在必要时才让用户排队
会话持续时间 (Session duration)	`session_duration`	否	离开 `host/path` 的用户可以直接返回而无需进入 waiting room 的时间长度（以分钟为单位，在 1 到 30 之间）。默认为 5 分钟。
会话撤销 (Session Revocation)		否	当用户执行特定操作时，通过在源站的响应上使用 HTTP 标头向 waiting room 发送命令来撤销用户的会话。	在仪表板中启用此设置，并将 `Cf-Waiting-Room-Command: revoke` HTTP 标头添加到源站的响应中。
描述 (Description)	`description`	否	waiting room 的描述。
Disable session renewal（禁用会话续订）	`disable_session_renewal`	否	仅适用于已购买的 Enterprise 客户。如果为 true，则用户只有 `session duration` 分钟的时间浏览您的网站。如果为 false，则在每次请求时都会续订用户的会话 cookie。
JSON 响应 (JSON response)	`json_response_enabled`	否，默认为 false。	在收到 `Accept: application/json` 标头时发送 JSON 正文，常用于原生移动应用程序。	将 waiting room 用于非浏览器流量时设置为 `true`。按照此文档进行其他步骤。
排队状态代码 (Queueing status code)	`queueing_status_code`	否，默认为 `200` (OK)。	用户排队时返回的 HTTP 状态代码。
Turnstile 小组件模式 (Turnstile Widget Mode)	`turnstile_mode`	是，默认为 `invisible`。	要使用的 Turnstile 小组件类型 - 有关详细信息，请参阅 Turnstile 文档。有效值为 `off`、`invisible`、`visible_non_interactive` 和 `visible_managed`。将其设置为 `off` 将完全禁用 Turnstile 集成。	将其设置为 `invisible` 对于大多数 room 来说是合理的，除非您希望最终用户知道正在运行质询。
Turnstile 失败操作 (Turnstile Fail Action)	`turnstile_action`	是，默认为 `log`。	最终用户未通过 Turnstile 质询时要采取的操作。有效值为 `log` 和 `infinite_queue`。	将其设置为 `log` 对于大多数 room 来说是合理的，除非您希望使用无限队列主动阻止机器人。

其他详细信息

每分钟新用户数

当您配置 new users per minute 时，此值不是每分钟添加的用户数。

相反，它是每分钟允许的用户数阈值（小于或等于 total active users 的数量）。您应将此值设置为预期峰值流量的 100%，以确保仅在必要时才让用户排队。

会话持续时间

会话持续时间以两种方式改善用户体验。

首先，它可以防止访问者在同一交易中两次通过 waiting room。例如，访问者可能想要在 example.com 上购物。example.com 的流量很大，因此他们在进入在线商店之前在 waiting room 排队。一段时间后，他们离开 waiting room 并进入在线商店。他们购物完毕并离开在线商店。

但是，他们忘记在订单中添加注释或索要收据。只要他们的会话 cookie 仍然有效（时间长度由 session duration 指定），他们就可以重新进入您的应用程序，而无需在 waiting room 中重新排队。

其次，会话持续时间使您的 waiting room 能够创建来自应用程序的动态流出（除了动态流入之外）。用户的会话 cookie 在一段时间不活动后到期，这意味着只要有可用空间，就会有新的名额开放，并且预计等待时间会更短、更准确。