宝塔面板是很多用户搭建网站和服务的常用管理工具，配置反向代理时如果出现504 Gateway Timeout错误，大多和代理超时参数设置不合理有关，我们可以从检查到配置逐步处理该问题。
前置排查步骤
在调整超时设置前，需要先确认不是后端服务本身的问题，避免做无用功。
- 检查后端服务是否正常运行，比如后端是Java项目可以查看进程是否存在，端口是否监听
- 测试宝塔面板所在服务器到后端服务的网络连通性，用
telnet 后端IP 后端端口命令验证端口是否可达 - 尝试直接访问后端服务地址，确认后端服务能正常返回响应，排除后端服务自身处理超时的问题
通过宝塔面板界面调整超时设置
宝塔面板的反向代理功能自带部分超时参数配置入口，适合不熟悉配置文件的用户操作。
操作步骤
- 登录宝塔面板，进入网站菜单，找到配置了反向代理的站点，点击设置
- 在左侧菜单选择反向代理，找到对应的反代规则，点击编辑
- 在编辑页面找到超时相关配置项，默认情况下面板可能只显示部分参数，我们可以手动补充以下参数：
- 代理连接超时：建议设置为60秒，即和后端服务建立连接的最大等待时间
- 代理读取超时：建议设置为300秒，即等待后端服务返回响应的最大时间，根据后端服务的处理耗时调整
- 代理发送超时：建议设置为60秒，即向后端服务发送请求的最大时间
- 保存配置后，面板会自动重载nginx服务，此时可以测试反代是否正常
手动修改nginx配置文件调整超时
如果面板界面的参数不够用，或者需要配置更细粒度的超时规则，可以手动修改nginx的反代配置文件。
配置文件位置
宝塔面板的站点nginx配置文件通常存放在/www/server/nginx/conf/vhost/目录下，文件名和站点域名一致，后缀为.conf。
需要添加的超时参数
在反代规则的location块中添加以下参数，所有参数都需要放在proxy_pass配置之后：
location / {
proxy_pass http://127.0.0.1:8080; # 后端服务地址
# 连接后端服务的超时时间，单位秒
proxy_connect_timeout 60;
# 从后端服务读取响应的超时时间，单位秒
proxy_read_timeout 300;
# 向后端服务发送请求的超时时间，单位秒
proxy_send_timeout 60;
# 以下为可选配置，用于传递客户端信息
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
重载nginx服务
修改完配置文件后，需要重载nginx让配置生效，可以通过宝塔面板的软件商店找到nginx，点击重载配置，也可以在服务器终端执行以下命令：
# 测试nginx配置是否有语法错误 /www/server/nginx/sbin/nginx -t # 重载nginx配置 /www/server/nginx/sbin/nginx -s reload
常见注意事项
- 超时时间不是越长越好，设置过大会占用更多服务器资源，建议根据后端服务的实际处理耗时调整，比如静态资源反代可以设置短一些，动态接口反代可以适当延长
- 如果调整超时后还是出现504错误，需要检查后端服务的日志，确认是否是后端服务本身处理请求超时，或者后端服务返回了错误的响应
- 如果反代的是HTTPS后端服务，还需要额外添加
proxy_ssl_verify off;等SSL相关配置，避免SSL握手超时导致504错误
注意：修改任何配置文件前建议先备份原文件，避免配置错误导致服务不可用，备份命令可以参考cp /www/server/nginx/conf/vhost/ippipp.com.conf /www/server/nginx/conf/vhost/ippipp.com.conf.bak，将ippipp.com替换为实际站点域名。
宝塔面板反向代理504_Gateway_Timeout代理超时设置nginx配置修改时间：2026-07-01 18:27:25