Xshell 警告"WARNING! The remote SSH server rejected X11 forwarding request."的解决办法

使用 Xshell 连接搬瓦工 VPS或其他 Linux 服务器时，有时会在登录后看到“WARNING! The remote SSH server rejected X11 forwarding request.”警告。这不是密码错误、端口错误或网络连接失败，而是 Xshell 发出的 X11 转发请求被远程 SSH 服务器拒绝。本文介绍这条警告的含义，以及关闭客户端转发和启用服务器端转发的操作方法。

一、Xshell 出现 X11 forwarding request 警告的原因

X11 转发用于将 Linux 服务器上的图形程序界面，通过 SSH 隧道显示在本地 Windows 电脑上。Xshell 会话开启这项功能后，连接服务器时会向 SSH 服务端申请建立 X11 转发。

如果服务器没有开启 X11 转发、缺少 X11 身份验证组件，或者管理员禁止了转发功能，就会返回下面的警告：

WARNING! The remote SSH server rejected X11 forwarding request.

只要 Xshell 已经进入服务器命令行，就说明 SSH 登录成功。这条警告只表示 X11 图形界面转发没有建立，并不是服务器无法连接。

二、在 Xshell 中关闭 X11 转发功能

如果只是使用 Xshell 执行 Linux 命令、管理网站、安装面板、部署 Docker 或传输文件，不需要使用 X11 图形界面转发。关闭这项功能不会影响 SSH 登录、命令执行和 SFTP 文件传输。

在 Xshell 窗口左上角点击“文件”，然后选择“当前会话属性”。

在会话属性左侧依次进入“连接”、“SSH”和“隧道”，找到“转发 X11 连接到”选项，取消前面的勾选，然后点击“确定”。

断开当前 SSH 连接，再重新连接服务器。Xshell 不再发送 X11 转发请求，登录时也不会继续出现这条警告。

三、在 SSH 服务器中启用 X11 转发功能

如果需要在 Windows 电脑上显示服务器中的 Linux 图形程序，应保留 Xshell 会话中的 X11 转发选项，并在 SSH 服务器中开启相应功能。

修改前先备份 SSH 配置文件：

cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak

打开 SSH 配置文件：

vi /etc/ssh/sshd_config

找到 X11Forwarding 参数，将它设置为：

X11Forwarding yes

如果该参数前面带有 #，需要删除注释符号；如果配置文件中没有这一项，可以在文件末尾添加。

服务器还需要安装 X11 身份验证组件。

Debian、Ubuntu 可以执行：

apt update
apt install xauth -y

AlmaLinux、Rocky Linux、RHEL 等系统可以执行：

dnf install xorg-x11-xauth -y

CentOS 7 等仍使用 Yum 的旧系统可以执行：

yum install xorg-x11-xauth -y

保存配置后，先检查 SSH 配置是否存在语法错误：

sshd -t

如果命令没有输出内容，说明配置语法检查通过。

Debian、Ubuntu 可以执行下面的命令重启 SSH 服务：

systemctl restart ssh

AlmaLinux、Rocky Linux、CentOS、RHEL 可以执行：

systemctl restart sshd

修改 SSH 配置期间不要关闭当前 Xshell 窗口。

重启 SSH 服务后，新建一个会话测试能否正常登录；确认新会话连接成功后，再退出原来的会话，避免配置错误后无法进入服务器。

服务器端启用 X11 转发后，Windows 电脑还需要安装并运行 Xmanager、Xming 或其他 X Server，才能显示远程 Linux 图形程序。

以上操作只需要重启 SSH 服务，不需要重启整台 VPS。