如何将VueJS+FastAPI应用的NGINX配置转为Apache 2.4配置

前置准备 #

CentOS 7 默认安装的Apache httpd 2.4.6需要先启用反向代理相关模块，执行以下命令检查：

httpd -M | grep -E 'proxy|proxy_http|headers'

如果返回结果中没有对应模块，编辑/etc/httpd/conf.modules.d/00-proxy.conf和/etc/httpd/conf.modules.d/00-base.conf，确保以下3行配置没有被注释：

• LoadModule proxy_module modules/mod_proxy.so
• LoadModule proxy_http_module modules/mod_proxy_http.so
• LoadModule headers_module modules/mod_headers.so

修改完成后执行systemctl restart httpd重启服务生效。

正确配置片段 #

将以下配置写入你的站点虚拟主机文件（通常路径为/etc/httpd/conf.d/你的站点名.conf）即可：

<VirtualHost *:80>
    ServerName 你的服务器公网IP/绑定的域名
    # 传递原始Host头，解决Invalid Host Header错误
    ProxyPreserveHost On
    # 附加传递客户端信息头，适配后端服务日志/逻辑需求
    RequestHeader set X-Forwarded-Proto "http"
    RequestHeader set X-Forwarded-Port "80"

    # 长路径优先配置：/api代理到FastAPI后端
    # 末尾带斜杠会自动去掉请求中的/api前缀再转发到后端，和Nginx proxy_pass带斜杠效果一致
    ProxyPass /api/ http://localhost:5301/
    ProxyPassReverse /api/ http://localhost:5301/

    # 短路径后置配置：/代理到Vue前端
    ProxyPass / http://localhost:5300/
    ProxyPassReverse / http://localhost:5300/
</VirtualHost>

配置注意事项 #

• ProxyPreserveHost On是解决Invalid Host Header错误的核心配置，默认Apache反向代理不会传递原始Host头，后端服务校验Host时就会抛出该错误。
• 路径匹配规则按配置顺序生效，必须把长路径/api/的配置放在短路径/前面，否则/规则会覆盖所有请求，导致/api路由不生效。
• 如果FastAPI本身的接口路径已经带/api前缀，将ProxyPass /api/ http://localhost:5301/改为ProxyPass /api http://localhost:5301/api即可。

配置完成后执行httpd -t校验语法，返回Syntax OK后执行systemctl reload httpd即可生效。

Nginx转Apache配置工具说明 #

目前不存在100%精准的通用转换工具，两者的配置逻辑、匹配规则、模块实现逻辑存在较多差异，复杂场景下手动转换的准确率更高。简单的反向代理、重写规则场景可以使用本地离线脚本辅助转换，但所有转换结果都需要手动校验语法和逻辑后再上线使用。

内容的提问来源于stack exchange，提问作者perfecto25