解决 nginx 代理 1Panel 后远程无法 ssh

解决 nginx 代理 1Panel 后远程无法 ssh

同步发布在个人笔记解决 nginx 代理 1Panel 后远程无法 ssh

问题描述

管理面板 1Panel 有 ssh 连接服务器终端的功能,在服务器本地设置好这一功能,之后我们通过 nginx 的端口转发代理 1Panel 的服务。此时我们发现通过 nginx 代理的 1Panel 日志里显示 ssh 成功了,但是终端界面一直提示 disconnected。

解决方法

官方文档里对这个问题有解决方案:使用自建 Nginx 反向代理 1Panel,导致主机和容器终端均不能正常使用。

在这里记录一下。

只需在代理 1Panel 的 nginx 配置文件里增加下面的配置:

bash 复制代码
location / {
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

即可解决。

方法解析

由于添加的是上面这三句,我怀疑 1Panel 的 ssh 功能是走的 websocket 协议, nginx 反向代理 websocket 协议时,就需要添加这三句。

那么为什么是这三句呢?每一句又分别作用于什么?

第一句proxy_http_version 1.1;是声明协议,使得下面的配置可用。

下面两句都是为了设置两个请求头 ,分别是Upgrade 和Connection。设置好这两个,后端的 1Panel 程序才知道要建立 websocket 连接来传输数据了。

  • Upgrade
    标识传输协议要升级/转换 ,如果是要转换为 websocket协议的话,此处的值就应该是 websocket。这个请求头代表客户端希望建立 websocket 协议进行通信, 后端的程序取到头信息后会返回101状态码(协议转换),然后就会建立 websocket 通信了。
  • Connection
    此处 Connection 头信息取值upgrade,这表明这次客户端请求是要求进行协议升级/转换 的请求。升级成什么协议呢?配合上一个配置句,是升级成websocket协议,这样请求就完全了。

最后一个疑问:为什么一旦用 nginx 代理了,就需要设置这些了呢?不代理的时候不是好好的么?

答:这是因为这些请求头都是逐跳标头 。意思就是这些标头都只能传递一层,不能透传,是逐级传递的。

当客户端直接于 1Panel 通信时,请求头能被后端接收到,所以一切正常;但是使用了 nginx 代理后,请求头就只能到 nginx 这一层,传递不到后端,我们就需要让 nginx 把请求头传递下去,形成逐层跳传,这样后端才能成功收到客户端的请求,实现协议的升级/转换。

参考Nginx反向代理websocket。

相关推荐
Decay__17 分钟前
SQLServer 索引与 SQL 优化 —— 聚集索引、非聚集索引、覆盖索引、碎片维护与执行计划
运维·数据库·sql·mysql·架构
java_logo1 小时前
Docker 部署 DeepSeek Harness(moelin):轻松搭建带登录的本地 AI Agent 平台
运维·docker·容器·ai agent·deepseek·harness·轩辕镜像
打工仔折腾 AI6 小时前
Changedetection.io 网页变动监控:Docker 部署、通知配置与公网暴露实践
运维·人工智能·后端·python·docker·容器·性能优化
无奈笑天下6 小时前
银河麒麟上lsblk命令教程详解
linux·运维·服务器·数据库
fengkai45456 小时前
Prometheus+K8s弹性伸缩综合项目
运维·kubernetes·k8s·prometheus·hpa·vpa
分布式存储与RustFS8 小时前
镜像仓库的层别只堆本地盘:用 RustFS 给 Harbor 当 S3 后端
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
雪落漂泊10 小时前
Liunux进程(七):程序控制篇(中)
linux·运维·windows
分布式存储与RustFS11 小时前
工作流脚本和依赖 JAR 散在各节点本地盘:用 DolphinScheduler 资源中心接到 RustFS
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
程序开发阿元1 天前
密码不进工具:一个独立开发者的服务器凭据管理办法
linux·ssh
分布式存储与RustFS1 天前
群晖 NAS 被 C3RB3R 锁了:本地备份一起被加密,RustFS 对象锁为什么删不掉
运维·云原生·开源·对象存储·分布式存储·s3·性能基准