Clash Verge
问题排查 · v2.5.5
Wayland 下 Clash Verge 打不开或显示异常怎么办
说明 Wayland 会话下客户端显示异常的原因、常用环境变量的作用，以及 Linux 需要图形界面的前提条件。
适用版本：v2.5.5
更新日期：2026-09-23
来源：官方 Releases、文档与公开 issue
前提条件
Clash Verge 基于 Webview 渲染界面，Linux 上需要图形化环境，纯命令行环境无法运行。这是安装前必须确认的第一项。
Wayland 下的常见问题
表现为窗口无法弹出、托盘图标缺失或界面闪烁。多数与 Webview 在 Wayland 会话下的兼容性有关，通过设置环境变量切换到兼容模式通常可解决。
处理顺序
先确认会话类型（Wayland 还是 X11），再尝试用环境变量切换渲染后端，最后检查依赖库是否齐全。按这个顺序能避免无目的地改配置。
常见问题
无图形界面的服务器能用吗？
不能。客户端基于 Webview 渲染，需要图形化环境。服务器上通常直接使用内核而不是图形客户端。
设置了环境变量仍不行？
检查依赖库是否完整，以及是否为非 root 运行导致权限不足。必要时导出日志查看具体报错。