Apache代理后端自定义端口需启用mod_proxy、mod_proxy_http和mod_proxy_wstunnel模块，配置ProxyPass指向如http://127.0.0.1:3000/，并设置ProxyPreserveHost On和ProxyPassReverse，WebSocket需额外配置ws://协议代理规则。
Apache 代理后端服务时，若后端运行在自定义端口（比如 3000、8081 或 5000），关键不是改 Apache 自身监听端口，而是确保反向代理能正确把请求转发到那个端口，并处理好协议头、重定向和 WebSocket 等细节。
启用必要代理模块
Apache 默认不启用代理功能，必须手动加载以下模块，否则 ProxyPass 会失效或返回 500 错误：
-
mod_proxy：代理基础支持 -
mod_proxy_http：转发 HTTP/HTTPS 请求必需 -
mod_proxy_wstunnel：如果后端用 WebSocket（如 Vue DevServer、Socket.IO）
Linux（Debian/Ubuntu）执行：sudo a2enmod proxy proxy_http proxy_wstunnel
CentOS/RHEL 执行：sudo sed -i '/^#LoadModule proxy_module/s/^#//; /^#LoadModule proxy_http_module/s/^#//; /^#LoadModule proxy_wstunnel_module/s/^#//' /etc/httpd/conf.modules.d/00-proxy.conf
然后重启：sudo systemctl restart apache2（或 httpd）
配置 ProxyPass 指向后端自定义端口
在虚拟主机配置中（如 /etc/apache2/sites-available/your-site.conf），写明后端服务的完整地址，包括端口号：
<VirtualHost *:80>
ServerName api.example.com
ProxyPreserveHost On
ProxyPass / http://127.0.0.1:3000/
ProxyPassReverse / http://127.0.0.1:3000/
</VirtualHost>
说明：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
-
http://127.0.0.1:3000/中的:3000就是后端实际监听的自定义端口 -
ProxyPreserveHost On让后端收到原始 Host 头，避免因域名错乱导致重定向失败 -
ProxyPassReverse重写后端返回的Location、Set-Cookie等响应头中的 URL，防止跳转回http://127.0.0.1:3000
处理 WebSocket 和跨域常见问题
如果后端启用了 WebSocket（如前端用 ws:// 连接），需额外加一条代理规则：
ProxyPass /ws/ ws://127.0.0.1:3000/ws/ ProxyPassReverse /ws/ ws://127.0.0.1:3000/ws/
同时确保 Apache 配置中已启用 mod_proxy_wstunnel。另外注意：
- 后端服务本身要允许来自代理的 Origin（如 Express 设置
cors({ origin: 'https://api.example.com' })） - 不要在 Apache 层面硬加
Access-Control-Allow-Origin: *，这不能解决 Cookie 跨域问题，且可能掩盖真实权限逻辑
验证与排错要点
完成配置后，按顺序检查：
- 运行
sudo apachectl configtest确认语法无误 - 用
curl -I http://localhost/测试 Apache 是否正常响应（返回 200 或 502） - 单独访问后端：
curl -I http://127.0.0.1:3000/，确认它本身可通 - 查看 Apache 错误日志：
tail -f /var/log/apache2/error.log，常见报错如 “Connection refused” 表示后端没起来或端口不对，“Invalid URL” 多因 ProxyPass 缺少末尾斜杠
