proxy_read_timeout用于控制Nginx与后端建立连接后等待响应数据的最长时间，超时返回504；需在location或server块中配合proxy_pass使用，默认60秒，设为0禁用但不推荐。

在 Nginx 中配置 proxy_read_timeout，是为了控制 Nginx 与后端服务器建立连接后，等待后端返回响应数据的最长时间。如果后端在该时间内没有发送任何数据（包括响应头或响应体），Nginx 就会主动关闭连接，并返回 504 Gateway Timeout。

作用范围和生效位置

proxy_read_timeout 必须放在启用代理的上下文中，常见于 location 或 server 块内，且需配合 proxy_pass 使用才生效。它不影响 DNS 解析、TCP 连接建立或 SSL 握手阶段，只管“已连接后等数据”的这段时间。

• 默认值是 60 秒
• 单位是秒（可带小数，如 30.5）
• 设为 0 表示禁用超时（不推荐，易导致连接堆积）

基础配置写法

在 location 块中添加即可：

location /api/ {
    proxy_pass http://backend;
    proxy_read_timeout 90;
}

这里表示：所有以 /api/ 开头的请求，转发到 backend，并允许最多等待 90 秒的后端响应数据。

Umbrel Proxy Manager

高效管理与交互 Umbrel 代理服务，支持 Docker 容器。自动发现运行服务，将内部 Docker IP 映射为可访问的外部地址。

下载

配合其他超时参数更合理

单独调大 proxy_read_timeout 可能不够，建议同步检查以下三项，避免因其他环节超时而提前中断：

• proxy_connect_timeout：Nginx 连接后端的超时（默认 60s），一般设为 5–10s 即可
• proxy_send_timeout：Nginx 向后端发送请求体时的超时（比如上传大文件），默认 60s
• send_timeout（非 proxy）：Nginx 向客户端发送响应的超时，影响浏览器接收过程

例如长轮询或导出接口场景：

location /export/ {
    proxy_pass http://app;
    proxy_connect_timeout 10;
    proxy_send_timeout 300;
    proxy_read_timeout 300;
}

验证是否生效

可通过日志确认超时行为：

• 开启 error_log 级别为 info 或更高，超时时会记录 upstream timed out
• 在后端故意延迟响应（如用 sleep(120)），观察 Nginx 是否在设定时间后返回 504
• 注意：若后端已发响应头但迟迟不发响应体，proxy_read_timeout 仍会触发；但如果响应头已收到，Nginx 就认为“读取完成”，后续传输由 send_timeout 控制