apache代理websocket需启用mod_proxy_wstunnel模块，用proxypass指向ws://后端，设置proxytimeout和timeout为3600，并确保容器网络互通及upgrade头透传。

apache 在容器化环境中代理 websocket 请求，核心在于启用 mod_proxy_wstunnel 模块，并正确配置 proxypass 指令以识别并升级 http upgrade 请求。它本身不处理 websocket 逻辑，只负责将客户端发起的 upgrade: websocket 请求透传给后端 java（如 spring boot）或 node.js 等服务。

启用必要模块与基础代理设置

确保 Apache 容器中已加载以下模块：

• mod_proxy（必须）
• mod_proxy_http（用于普通 HTTP 代理）
• mod_proxy_wstunnel（WebSocket 专用隧道模块，关键）

在配置文件（如 /etc/apache2/sites-enabled/000-default.conf 或容器内自定义 vhost 文件）中添加：

ProxyRequests Off
ProxyPreserveHost On
# 允许 WebSocket 协议升级
RewriteEngine On
RewriteCond %{HTTP:Upgrade} =websocket [NC]
RewriteRule /(.*) ws://localhost:8080/$1 [P,L]
# 普通 HTTP 请求走常规代理
ProxyPass / http://localhost:8080/
ProxyPassReverse / http://localhost:8080/

避免连接中断的关键参数

WebSocket 是长连接，Apache 默认超时机制会主动断开空闲连接，需显式延长：

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

• ProxyTimeout 3600：设置代理层整体超时为 1 小时
• Timeout 3600：防止主连接被底层 socket 超时关闭
• 禁用 KeepAlive 超时干扰（可选）：KeepAlive Off 或调高 KeepAliveTimeout

这些值应与后端服务（如 Tomcat 的 connectionTimeout、Spring Boot 的 server.tomcat.connection-timeout）对齐，否则任一环节先断都会导致连接重置。

容器环境下的路径与地址适配

在 Docker/K8s 中，后端服务通常不在 localhost:8080，而是通过服务名通信：

• 若后端容器名为 app-backend，端口为 8080，则改写为：
  ws://app-backend:8080/ 和 http://app-backend:8080/
• 确保 Apache 容器与后端容器处于同一 Docker 网络，或 K8s Service DNS 可解析
• 若使用 Nextcloud AIO 等封装方案，注意其内置 Apache 已预设代理规则，需修改 Containers/apache/nextcloud.conf 而非顶层配置

验证与常见问题定位

部署后可通过浏览器控制台检查 WebSocket 连接状态：

• 成功：Network 面板中 WebSocket 请求状态码为 101 Switching Protocols
• 失败为 502 Bad Gateway：检查后端是否启动、地址是否可达、mod_proxy_wstunnel 是否启用
• 失败为 400 Bad Request 或连接立即关闭：大概率是 Upgrade 头未被正确转发，确认 ProxyPreserveHost On 和 Rewrite 规则生效
• 连接建立后频繁断开：优先排查 ProxyTimeout 和后端心跳配置是否匹配