FreshRSS在Nginx反向代理下POST请求404问题的解决方案

问题背景

在使用Docker部署FreshRSS时，许多用户选择通过Nginx作为反向代理来提供服务。一个常见的问题是在安装向导的第二步（选择语言后提交表单）出现404错误，而直接通过IP和端口访问则正常。这种情况通常发生在使用Plesk控制面板管理Nginx的环境中。

问题分析

当FreshRSS通过Docker容器运行（例如使用Portainer部署），并通过Nginx反向代理暴露服务时，POST请求可能会被Nginx错误处理。具体表现为：

1. 通过IP:端口直接访问安装向导工作正常
2. 通过域名访问时，GET请求正常，但POST请求返回404
3. Nginx错误日志中没有相关记录
4. FreshRSS容器日志中也没有收到POST请求

这种情况的根本原因是Nginx反向代理配置不完整，特别是对于POST请求的处理。

解决方案

对于使用Plesk控制面板的用户，正确的解决方法是：

1. 登录Plesk控制面板
2. 导航到"网站与域名"部分
3. 找到对应的子域名设置
4. 使用"Docker代理规则"功能而非"额外的Nginx指令"

这种方法比手动配置Nginx更可靠，因为：

• 自动处理所有必要的代理设置
• 确保GET和POST请求都能正确转发
• 与Plesk的SSL/TLS配置无缝集成
• 避免与其他Plesk自动生成的配置冲突

技术原理

当使用反向代理时，Nginx需要正确配置以下几项才能处理POST请求：

1. 请求头转发：确保Host、X-Forwarded-For等头部正确传递
2. 请求体处理：特别是对于较大的POST请求体
3. Cookie路径处理：保持会话一致性
4. 超时设置：避免长时间请求被中断

Plesk的"Docker代理规则"功能会自动设置这些参数，而手动配置容易遗漏关键项。

最佳实践建议

1. 对于生产环境，建议使用官方的Docker Compose示例配置
2. 保持Nginx和FreshRSS容器版本更新
3. 定期检查代理日志以发现潜在问题
4. 考虑启用HTTP/2以提升性能
5. 对于高流量站点，适当调整Nginx的缓冲和超时设置

通过遵循这些建议，可以确保FreshRSS在反向代理环境下稳定运行，避免常见的404问题。