在 apache 中实现 webssh 终端工具的 websocket 代理,核心在于使用 mod_proxy_wstunnel 模块将特定的 url 路径升级为 websocket 连接。你需要确保 apache 启用了 proxy、proxy_http 和 proxy_wstunnel 模块,然后在虚拟主机配置中使用 proxypass 和 proxypassreverse 指令,并指定 wss:// 或 ws:// 协议前缀来代理后端的 ssh 服务端口(如 8022)。这样,浏览器发起的 websocket 请求就能被正确转发到后端应用,实现双向通信。

如何配置 Apache 虚拟主机以代理 WebSocket 连接
要配置 Apache 虚拟主机代理 WebSocket 连接,必须加载 mod_proxy_wstunnel 模块并在 块中设置 ProxyPass 规则。假设你的 WebSSH 前端部署在 Apache 上,而后端 SSH 代理服务运行在本地 8022 端口,你需要将根路径或特定路径指向该后端。关键步骤是启用 ProxyPreserveHost On 以保持原始 Host 头,并使用 ws:// 作为目标协议。

<virtualhost>
ServerName webssh.example.com
# 启用必要的代理模块
ProxyRequests Off
ProxyPreserveHost On
# 代理 WebSocket 连接到后端 SSH 服务
ProxyPass / ws://localhost:8022/
ProxyPassReverse / ws://localhost:8022/
# 静态资源直接由 Apache 提供
DocumentRoot /var/www/webssh/public
</virtualhost>
上述配置中,ProxyPass / ws://localhost:8022/ 将所有请求代理到本地 8022 端口。如果后端支持 HTTPS,应使用 wss://。同时,确保 Apache 配置文件中有 LoadModule proxy_module modules/mod_proxy.so、LoadModule proxy_http_module modules/mod_proxy_http.so 和 LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so。重启 Apache 后,访问 http://webssh.example.com 即可建立 WebSocket 连接。
如何处理 Apache 代理中的超时和缓冲问题
WebSSH 会话可能持续较长时间,Apache 默认的超时设置可能导致连接中断。需要调整 Timeout 和 KeepAlive 相关参数,并确保代理层不缓冲大量数据。在 Apache 配置中,增加 Timeout 值可以防止空闲连接被切断。此外,对于 WebSocket 代理,Apache 2.4.9 及以上版本支持 ProxyPass 的 connectiontimeout 和 disablereuse 选项,但更常见的是依赖 HTTP Keep-Alive 机制。若遇到断连,检查后端服务的超时设置是否与 Apache 匹配。
可水平扩展的 WebSocket 中心模式,支持懒加载 Redis 订阅、连接注册表和优雅关闭。适用于构建可跨多实例扩展的实时 WebSocket 服务器。

# httpd.conf 或 apache2.conf
Timeout 300
KeepAlive On
MaxKeepAliveRequests 100
KeepAliveTimeout 5
# VirtualHost 内
<location></location>
ProxyPass / ws://localhost:8022/ connectiontimeout=5 timeout=300
ProxyPassReverse / ws://localhost:8022/
在上面的代码中,Timeout 300 设置了服务器等待请求完成的秒数,KeepAlive On 启用持久连接。在 ProxyPass 指令中,timeout=300 指定了代理连接的超时时间。这些设置有助于维持长连接的稳定性。注意,connectiontimeout 仅用于新连接的建立阶段,而 timeout 影响数据传输过程中的空闲超时。根据实际网络环境调整这些值,避免过短导致断连或过长占用资源。
当后端 SSH 服务返回非 101 状态码时 Apache 如何处理
WebSocket 握手成功的关键是后端返回 HTTP 101 Switching Protocols 状态码。如果 Apache 代理的后端 SSH 服务因配置错误或认证失败返回其他状态码(如 404 或 500),WebSocket 升级将失败,浏览器控制台会显示错误。Apache 本身不会修改后端的状态码,而是原样传递给客户端。因此,排查此类问题时,需检查后端服务日志,确认其是否正确响应 WebSocket 升级请求。确保后端应用监听正确的端口并支持 WebSocket 协议。










