☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Linux版Codex GUI启动失败，根本原因不是程序本身出错，而是X11转发链路断裂或桌面环境缺失——当你在远程Linux服务器上执行codex-gui却只看到Cannot open display或黑窗口时，说明X Server未就绪、SSH未透传图形协议，或系统压根没装GUI运行时依赖。
确认本地X Server已就绪（Windows端）
Windows上必须运行一个X Server，且配置必须关闭访问控制；VcXsrv比Xming更稳定，推荐首选。
启动XLaunch向导 → 选择Multiple windows → 勾选Disable access control → 取消勾选Native opengl → Display number保持0 → 完成后右下角出现蓝色X图标才算真正就绪。
【关键提醒】如果跳过“Disable access control”，远程Linux将被拒绝连接，报错No protocol specified，此时所有GUI程序均无法显示。
检查并修正SSH双向X11配置
仅在VSCode里点Remote-SSH连接远远不够，X11转发必须在客户端和服务端同时显式启用。
Windows客户端（PowerShell管理员运行）：编辑$env:ProgramData\ssh\ssh_config，追加以下三行：
Host *
ForwardX11 yes
ForwardX11Trusted yes
XAuthLocation /usr/bin/xauth
Linux服务端：编辑/etc/ssh/sshd_config，确保这三行未被注释且值正确：
X11Forwarding yes
X11UseLocalhost no
AllowTcpForwarding yes
改完必须执行sudo systemctl restart sshd，否则配置完全不生效。
【致命陷阱】X11UseLocalhost no是Windows环境下唯一能打通VcXsrv与远程Linux的开关——OpenSSH默认绑定localhost，而VcXsrv监听0.0通配地址，不设为no会导致连接被静默拒绝。
验证DISPLAY变量与xauth认证凭证
方法一：登录远程Linux后，手动检查DISPLAY是否自动注入
执行echo $DISPLAY，正常应返回localhost:10.0或localhost:11.0（注意不是localhost:0.0）。
方法二：若DISPLAY为空或错误，需手动设置
执行export DISPLAY=localhost:10.0，再运行codex-gui测试。
方法三：检查.xauthority文件权限是否崩溃
执行ls -l ~/.Xauthority，若所有者不是当前用户或权限不是600，立即修复：chown $USER:$USER ~/.Xauthority && chmod 600 ~/.Xauthority。
补全GUI运行时依赖（无桌面环境也能跑）
第一步：安装X11认证工具
Ubuntu/Debian：sudo apt-get install xauth
CentOS/RHEL：sudo yum install xorg-x11-xauth
第二步：安装基础字体支持（避免中文乱码或空白框）
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
第三步：验证X11转发通道是否真实畅通
执行ssh -X $USER@your-server xeyes，若弹出一对跟随鼠标转动的眼睛，说明X11转发链路完整可用；若失败，则问题仍在前三个环节。
