讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

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

酷晨同学_9450

酷晨同学_9450

发布时间:2026-11-20 05:06:01

|

958人浏览过

|

来源于php中文网

原创

在 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 模块并在 <virtualhost></virtualhost> 块中设置 ProxyPass 规则。假设你的 WebSSH 前端部署在 Apache 上,而后端 SSH 代理服务运行在本地 8022 端口,你需要将根路径或特定路径指向该后端。关键步骤是启用 ProxyPreserveHost On 以保持原始 Host 头,并使用 ws:// 作为目标协议。

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

<VirtualHost *:80>
    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 连接。

Websocket Hub Patterns
Websocket Hub Patterns

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

下载

如何处理 Apache 代理中的超时和缓冲问题

WebSSH 会话可能持续较长时间,Apache 默认的超时设置可能导致连接中断。需要调整 Timeout 和 KeepAlive 相关参数,并确保代理层不缓冲大量数据。在 Apache 配置中,增加 Timeout 值可以防止空闲连接被切断。此外,对于 WebSocket 代理,Apache 2.4.9 及以上版本支持 ProxyPass 的 connectiontimeout 和 disablereuse 选项,但更常见的是依赖 HTTP Keep-Alive 机制。若遇到断连,检查后端服务的超时设置是否与 Apache 匹配。

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

# httpd.conf 或 apache2.conf
Timeout 300
KeepAlive On
MaxKeepAliveRequests 100
KeepAliveTimeout 5

# VirtualHost 内
<Location />
    ProxyPass / ws://localhost:8022/ connectiontimeout=5 timeout=300
    ProxyPassReverse / ws://localhost:8022/
</Location>

在上面的代码中,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 协议。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

相关专题

更多
nginx 重启
nginx 重启

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

423

2023.07.27

nginx 配置详解
nginx 配置详解

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

4367

2023.08.04

nginx配置详解
nginx配置详解

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

7345

2023.08.04

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

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

601

2024.02.23

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

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

1516

2024.07.09

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

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

4018

2024.08.07

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

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

122

2026.01.13

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

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

617

2026.01.13

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

20

2026.11.17

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn