如何配置SSH PuTTY使其正常显示Python Tkinter GUI界面

报错_tkinter.TclError: no display name and no $DISPLAY environment variable是因为SSH会话默认未开启X11图形转发，远程运行的Tkinter程序找不到可输出图形的显示端点。本地控制台运行正常是因为程序直接调用了服务器直连的物理显示输出，SSH纯文本会话默认不携带图形通道。

1. Debian 11 服务端配置 #

• 安装X11转发所需依赖：
  执行命令apt update && apt install -y xauth x11-apps，其中xauth负责X11转发的鉴权，x11-apps自带的小工具可以用来快速验证转发是否正常。
• 修改SSH服务配置文件/etc/ssh/sshd_config，确保存在以下配置项且值正确：

  X11Forwarding yes
  X11DisplayOffset 10
  X11UseLocalhost yes
  

• 执行systemctl restart sshd重启SSH服务，让配置生效。

2. Windows 10 客户端配置 #

PuTTY本身不提供X图形显示服务，需要先在本地运行X Server接收转发的图形内容，再配置PuTTY转发规则：

• 安装Windows平台X Server程序，可选VcXsrv或者Xming，安装完成后启动X Server，启动参数保持默认即可，注意在Windows防火墙弹窗时允许本地回环访问权限。
• 打开PuTTY配置面板，加载你要连接的服务器会话配置，找到左侧菜单Connection > SSH > X11，勾选Enable X11 forwarding选项，X display location输入框填localhost:0，其余项保持默认。
• 回到会话页正常发起连接，输入账号密码登录服务器即可。

3. 有效性验证 #

登录成功后先在SSH终端执行echo $DISPLAY，正常会返回类似localhost:10.0的输出，说明X11转发通道已经建立。
此时进入Python交互环境执行测试代码：

import tkinter
tkinter._test()

Tkinter测试窗口会直接弹出在Windows本地桌面，不会再抛出DISPLAY相关错误。

• 如果执行echo $DISPLAY返回空值，先检查服务端sshd配置修改后是否重启，PuTTY的X11转发选项是否在当前连接的配置里勾选并保存。
• 如果提示X Server连接被拒绝，检查本地X Server是否正常运行，Windows防火墙是否拦截了本地回环地址对X Server的访问。
• 不要手动在SSH会话里执行export设置DISPLAY变量为服务器本地显示值，X11转发建立时会自动分配正确的DISPLAY地址，手动设置会导致转发失效。

内容的提问来源于stack exchange，提问作者mdavidjohnson