doh_timeout
以毫秒为单位设置 DNS-over-HTTPS 请求的超时时间。
NGINX module for serving DNS-over-HTTPS (DOH) requests
·
location
语法doh_timeout time;
默认值5000
上下文location
参数1
说明
NGINX 中的 doh_timeout 指令用于指定在处理 DNS-over-HTTPS (DOH) 请求时,服务器从上游 DNS 服务器等待响应的最长时间(以毫秒为单位)。该指令在定义 DOH 服务的响应性方面起着关键作用,因为它决定服务器在超时之前愿意等待 DNS 响应的时长。
通常在 location 块中设置,doh_timeout 指令接收一个参数,表示超时时间。如果来自上游 DNS 服务器的响应超过该指定时长,NGINX 将终止该请求,从而避免因缓慢的 DNS 响应而阻塞,允许处理其他请求。超时时间可根据应用的具体需要和上游 DNS 服务器的预期性能进行调整。
默认情况下,如果未指定,超时时间设为 5000 毫秒(5 秒)。这提供了一定的灵活性;管理员可以将其减小以实现更快的故障切换,或在对接较慢的 DNS 服务器时增加该值。但是,将超时时间设置得过高可能会导致请求处理效率低下,尤其是在高负载情况下。
配置示例
location /dns-query {
doh;
doh_timeout 2000;
}⚠
如果将数值设置得过低,在上游 DNS 服务器响应缓慢时可能导致频繁的超时。
⚠
确保超时值以毫秒为单位;与秒混淆可能导致意外行为。
⚠
至关重要的是在正确的 location block 中设置此指令;否则可能不会生效。