解决ebook2audiobook在Nginx反向代理下的502错误与下载问题

问题背景

在使用Nginx反向代理部署ebook2audiobook项目时，用户可能会遇到两个典型问题：

1. 访问Web界面时出现502错误
2. 下载生成的文件时被重定向到Docker主机的本地IP地址

502错误的解决方案

当ebook2audiobook容器运行正常但通过Nginx访问时出现502错误，Nginx日志显示"upstream sent too big header while reading response header from upstream"错误，这表明响应头超出了Nginx默认的缓冲区大小限制。

解决方法是在Nginx配置中增加缓冲区大小设置：

proxy_buffer_size 128k;
proxy_buffers 4 256k;
proxy_busy_buffers_size 256k;
large_client_header_buffers 4 16k;

这些设置将：

• 增大单个代理缓冲区大小至128KB
• 设置4个256KB的代理缓冲区
• 提高繁忙缓冲区大小至256KB
• 增加大型客户端头缓冲区

下载重定向问题的解决方案

当尝试下载生成的文件时，系统可能会错误地重定向到Docker主机的内部IP地址。这是因为应用程序没有正确处理反向代理环境下的请求头。

解决方案是确保Nginx正确传递必要的头信息：

proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

这些设置将：

• 传递原始请求的协议（HTTP/HTTPS）
• 传递客户端的真实IP地址

额外优化建议

1. 增加文件大小限制：对于音频文件传输，建议增加Nginx的客户端最大请求体大小：

   client_max_body_size 100M;
   

2. 连接超时设置：适当增加代理超时时间以处理大文件传输：

   proxy_connect_timeout 300s;
   proxy_send_timeout 300s;
   proxy_read_timeout 300s;
   

3. 缓存控制：对于动态内容，建议禁用缓存：

   proxy_no_cache 1;
   proxy_cache_bypass 1;
   

总结

通过合理配置Nginx的缓冲区大小和正确设置转发头信息，可以完美解决ebook2audiobook在反向代理环境下的访问问题。这些配置不仅适用于本项目，也可作为其他类似应用在Nginx反向代理下的参考配置方案。