Apache 中 WebSSH 终端工具怎么配置 Apache 实现 WebSocket 代理

酷晨同学_9450

酷晨同学_9450

2026-11-20

958人浏览

原创

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

Apache 中 WebSSH 终端工具怎么配置 Apache 实现 WebSocket 代理

如何配置 Apache 虚拟主机以代理 WebSocket 连接

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

Apache 中 WebSSH 终端工具怎么配置 Apache 实现 WebSocket 代理

<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 Hub Patterns
Websocket Hub Patterns

可水平扩展的 WebSocket 中心模式,支持懒加载 Redis 订阅、连接注册表和优雅关闭。适用于构建可跨多实例扩展的实时 WebSocket 服务器。

下载

Apache 中 WebSSH 终端工具怎么配置 Apache 实现 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 协议。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

423

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

4367

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

7345

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

601

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1516

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

4018

3

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

122

12

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

617

23

Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建
Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建

本指南详解Nginx在Windows、macOS及Linux系统的安装全流程。涵盖官方包解压、Homebrew一键部署、APT/YUM源配置及Docker容器化方案。无论新手或开发者,均可快速搭建运行环境,掌握跨平台核心指令,为后续配置与调优奠定坚实基础。

2026.03.16

179

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Apache Maven 官方安装指南
Apache Maven 官方安装指南

共0课时 | 0人学习

Apache Maven 官方用户中心
Apache Maven 官方用户中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习