代理超时

HTTP 代理超时（proxy timeout）定义了代理服务器在终止连接之前，等待目标服务器或客户端响应的最长时间。该机制对于防止挂起的连接占用资源、保证顺畅的使用体验至关重要。正确配置的超时是维持代理服务器稳定性和性能的关键。

理解代理超时

代理超时用于应对各种可能导致连接无响应的情况，包括：

• 目标服务器缓慢或无响应： 由于负载过高、网络问题或服务端错误，目标服务器可能需要很长时间处理请求。如果没有超时，代理会无限期等待，占用宝贵资源。
• 网络拥塞： 代理与目标服务器或客户端之间的网络拥塞会造成数据传输延迟，导致连接挂起。
• 客户端问题： 客户端在发送请求后可能失去响应，例如浏览器崩溃或网络连接中断。
• 拒绝服务（DoS）攻击： 攻击者可以用刻意设计为处理耗时很长的请求淹没代理服务器，从而耗尽服务器资源。超时有助于减轻此类攻击的影响。

与代理功能相关的超时有多种类型，最常见的是：

• Connect timeout（连接超时）： 代理等待与目标服务器建立连接的最长时间。
• Read timeout（读取超时）： 连接建立后，代理等待接收目标服务器数据的最长时间。
• Send timeout（发送超时）： 代理等待向目标服务器或客户端发送数据的最长时间。
• Idle timeout（空闲超时）： 连接在被关闭之前可以保持空闲（无数据传输）的最长时间。

配置代理超时

代理超时的配置方式取决于所使用的代理服务器软件。以下是几款常见代理服务器的示例：

Apache HTTP Server（mod_proxy）

Apache 的 mod_proxy 模块提供了多个配置超时的指令：

• ProxyTimeout： 以秒为单位同时设置连接和读取操作的超时。

  apache <Proxy *> ProxyTimeout 60 </Proxy>

• Timeout： 设置服务器接收客户端或后端服务器响应的整体超时。它会同时影响连接和读取操作。

  apache Timeout 300

• ProxyReceiveBufferSize： 设置从后端服务器接收数据所用缓冲区的大小。较小的缓冲区会强制更频繁地传输数据，有时有助于缓解超时问题。

  apache ProxyReceiveBufferSize 8192

修改配置文件后重启 Apache。

sudo systemctl restart apache2

Nginx

Nginx 通过多个指令提供更精细的超时控制：

• proxy_connect_timeout： 指定与 upstream 服务器建立连接的超时。

  nginx http { server { location / { proxy_pass http://backend_server; proxy_connect_timeout 60s; } } }

• proxy_read_timeout： 指定接收 upstream 服务器响应的超时。

  nginx http { server { location / { proxy_pass http://backend_server; proxy_read_timeout 120s; } } }

• proxy_send_timeout： 指定向 upstream 服务器发送请求的超时。

  nginx http { server { location / { proxy_pass http://backend_server; proxy_send_timeout 60s; } } }

• keepalive_timeout： 指定 keep-alive 连接的超时。

  nginx http { keepalive_timeout 75s; }

修改配置文件后重新加载 Nginx。

sudo nginx -s reload

Squid

Squid 在其配置文件（squid.conf）中使用 timeout 相关指令控制各种超时：

• request_timeout： Squid 等待客户端发来完整 HTTP 请求的最长时间。
• connect_timeout： Squid 等待与目标服务器建立连接的最长时间。
• read_timeout： Squid 等待接收目标服务器数据的最长时间。

• client_lifetime： Squid 保持空闲客户端连接开启的最长时间。

  squid request_timeout 30 seconds connect_timeout 60 seconds read_timeout 120 seconds client_lifetime 7200 seconds

修改配置文件后重启 Squid。

sudo squid -k reconfigure

超时指令对比

配置超时的最佳实践

• 从合理的默认值开始： 先使用适中的超时值，再根据观察到的性能和错误日志进行调整。一个不错的起点是连接超时 60 秒、读取超时 120 秒。
• 监控错误日志： 定期检查代理服务器的错误日志中与超时相关的错误。这些错误能有效说明超时是否过短，或是否存在其他潜在问题。
• 根据网络状况调整： 如果代理服务器运行在高延迟或经常拥塞的网络中，可考虑增大超时值。
• 考虑应用需求： 不同应用对延迟和超时的容忍度不同，应据此调整超时值。例如实时应用可能需要比批处理应用更短的超时。
• 实现熔断器： 对关键应用，可考虑将熔断器模式 Microsoft 熔断器模式{rel="nofollow"} 与超时结合使用。熔断器能自动阻止请求被发送到故障服务器，进一步提升系统韧性。
• 压力测试： 进行压力测试以模拟真实流量模式，识别高负载下可能出现的超时问题。这有助于为具体环境确定最佳超时值。
• 安全考量： 过长的超时值可能使代理服务器面临拒绝服务攻击的风险。需要在韧性需求与安全考量之间取得平衡。

排查超时问题

遇到超时错误时，可参考以下排查步骤：

1. 验证网络连通性： 确认代理服务器与客户端和目标服务器之间的网络连接稳定。使用 ping、traceroute 等工具诊断网络问题。
2. 检查服务器负载： 监控代理服务器和目标服务器的 CPU 与内存占用。高负载会造成延迟并触发超时。
3. 分析错误日志： 检查代理服务器错误日志中具体的超时错误。日志应提供超时类型、涉及的目标服务器以及出错时间等信息。
4. （临时）增大超时值： 作为诊断手段，临时增大超时值，看错误是否消失。如果消失，说明原来的超时设置过短。
5. 排查目标服务器性能： 如果目标服务器持续缓慢，需排查其性能，查找数据库瓶颈、低效代码或其他可能造成延迟的问题。
6. 复核代理服务器配置： 再次检查代理服务器配置文件，确认超时指令设置正确且没有相互冲突的配置。
7. 监控网络流量： 使用 tcpdump 或 Wireshark 等网络监控工具抓取并分析客户端、代理服务器与目标服务器之间的流量，有助于发现网络拥塞或其他问题。

结论

代理超时是配置良好的代理服务器的关键组成部分。了解不同类型的超时及其配置方法，可以避免连接挂起、提升服务器稳定性并改善用户体验。正确配置的超时，配合主动监控与排查，是维持稳健可靠的代理基础设施的必要条件。