许多开发者在远程 Linux 服务器上满怀期待地输入 codex-gui，却只得到一句冰冷的 Cannot open display 或者一个毫无反应的黑窗口。先别急着怀疑程序本身，问题大概率出在其他环节。
本质上，这是一个信号传递失败的典型场景：你本地的 Windows 电脑未能成功为远程服务器的图形程序提供「显示终端」。这通常意味着以下三件事中至少一件没有做对：本地 X Server 未准备就绪、SSH 连接的图形隧道（X11 转发）未打通，或者服务器上连最基本的图形运行时依赖都没有安装。
确认本地 X Server 已正常运行（Windows 端）
要在 Windows 上流畅显示 Linux 的图形界面，首先你得在本地运行一个“翻译官”——也就是 X Server。在众多选择中，VcXsrv 以其稳定性和易用性赢得了良好口碑，比老牌的 Xming 更值得推荐。
安装好 VcXsrv 后，通过 XLaunch 向导启动，有几个步骤至关重要：
- 显示设置：选择“Multiple windows”（多窗口模式）。
- 最关键的一步：务必勾选“Disable access control”（禁用访问控制）。如果遗漏这一步，后续一切都会卡死。
- 性能优化：建议取消勾选“Native opengl”，这样可以减少潜在的兼容性问题。
- 显示编号：Display number 通常保持默认的“0”即可。
这里有一个高频踩坑点：如果上面提到的“禁用访问控制”没有做，远程连接时将被无情拒绝，并抛出 No protocol specified 错误，所有 GUI 程序都会石沉大海。
检查并修正 SSH 双向 X11 配置
很多人以为用 VS Code 的 Remote-SSH 连上服务器就万事大吉了，其实远远不够。图形转发需要客户端和服务器端的 SSH 配置双管齐下，同时开启。
Windows 客户端配置：
以管理员身份打开 PowerShell，编辑 SSH 的全局配置文件：
$env:ProgramData\ssh\ssh_config
在文件末尾，确保添加或包含以下配置：
Host *
ForwardX11 yes
ForwardX11Trusted yes
XAuthLocation /usr/bin/xauth
Linux 服务器端配置：
编辑 SSH 守护进程的配置文件：
/etc/ssh/sshd_config
找到并确认以下三行没有被注释（#），且值设置正确：
X11Forwarding yes X11UseLocalhost no AllowTcpForwarding yes
修改后，务必执行 sudo systemctl restart sshd 重启 SSH 服务，否则配置不会生效。
这里有一个堪称“致命”的细节：X11UseLocalhost no 这个选项。在 Windows 环境下，它是打通 VcXsrv 和远程 Linux 的关键开关。OpenSSH 默认绑定到 localhost，而 VcXsrv 通常监听在所有网络接口（0.0.0.0）上。如果不把这个值设为 no，连接会被静默拒绝，让你查无可查。
验证 DISPLAY 变量与 xauth 认证凭证
配置都改好了，SSH 也重连了，还是不行？别慌，登上服务器检查几个关键状态。
第一步：检查 DISPLAY 变量
登录服务器后，先执行 echo $DISPLAY。正常情况下，你应该会看到类似 localhost:10.0 或 localhost:11.0 的输出。注意，这里一般是 10.0 或 11.0，如果显示的是 localhost:0.0，那可能还是本地服务器的显示，说明转发没有成功。
第二步：手动指定 DISPLAY
如果上一步输出为空或明显不对，可以尝试手动指定。假设你的 X Server 显示编号是 10：
export DISPLAY=localhost:10.0
然后再运行 codex-gui 试试看。
第三步：检查 X 认证文件
X11 转发依赖一个隐藏的认证文件 ~/.Xauthority。有时它的权限或归属会出现问题。
执行 ls -l ~/.Xauthority 查看，它的所有者应该是当前用户，且权限应为 600（即仅用户可读写）。如果不是，用下面命令修复：
chown $USER:$USER ~/.Xauthority && chmod 600 ~/.Xauthority
补全 GUI 运行时依赖（无桌面环境也能跑）
很多用作开发的 Linux 服务器是精简安装，默认没有图形桌面环境（如 GNOME、KDE），但这不代表不能运行单个 GUI 程序。你只需要补上最基础的运行时库。
1. 安装 X11 认证工具（xauth）
这是 X11 转发的核心认证组件，必须安装。
Ubuntu/Debian: sudo apt-get install xauth
CentOS/RHEL: sudo yum install xorg-x11-xauth
2. 安装基础字体（避免乱码或空白）
没有字体支持，程序可能启动失败或显示一堆方块。
Ubuntu/Debian: sudo apt-get install fonts-wqy-zenhei xfonts-100dpi
CentOS/RHEL: sudo yum install wqy-zenhei-fonts.noarch xorg-x11-fonts-100dpi.noarch
3. 终极验证：用 xeyes 测试
全部配置完成后，怎么知道链路真的通了？一个经典的方法是使用 xeyes 这个小程序测试。
在你的本地电脑的终端（不是 VS Code）里，直接执行：
ssh -X 用户名@你的服务器地址 xeyes
如果一切完美，你会看到一对可爱又有点魔性的“眼睛”窗口弹出来，并且眼珠会跟着你的鼠标指针转动。如果这个能成功，那运行 codex-gui 基本就妥了。如果失败，说明问题还得回到前面三个环节去排查。