一直以来，Cloudflare 推出的 WARP 客户端在 Linux 上都是没有图形化界面的，直至 5 月 11 日他们推送了新版本 2026.4.1350.0，引入了全新的 GUI 界面，由此便在我的 Fedora 上引起了一系列问题。本篇文章正是我查阅了社区帖子并亲身实践后，为遇到同样问题的用户准备的修复教程。
在这个新版本的依赖项中出现了一位“稀客”：webkit2gtk3。这是一个已经被弃用了很久的软件包，并且在较新版本的 Fedora 中已经很难再安装（我不明白为什么贵公司还要用这种老古董）。为了继续正常使用客户端的命令行界面，社区提出两种方案，它们都可行：
手动下载旧版的 RPM 软件包。比如上一个版本 2026.3.846.0。下载地址
自己制作一个空的 webkit2gtk3 来骗过包管理器。先创建一个 dummy.spec 文件，内容是：
Name: webkit2gtk3-dummy
Version: 1.0
Release: 1
Summary: Dummy package to satisfy cloudflare-warp dependencies
Provides: webkit2gtk3
Provides: libwebkit2gtk-4.0.so.37()(64bit)
License: MIT
%description
Fake package to bypass GUI dependencies for headless WARP.
%files
然后去构建这个软件包：
rpmbuild -bb dummy.spec
此时会生成一个新文件 ~/rpmbuild/RPMS/x86_64/webkit2gtk3-dummy-1.0-1.x86_64.rpm，安装它就会让系统认为你已经拥有了 webkit2gtk3 依赖，也就能正常更新了。
要注意的是更新后的新版 GUI 是无法使用的，但是命令行还能照常用。
这篇教程到这里本来应该结束了，但 Cloudflare 又整了波大的。
如果你重启了系统，会发现再回来会卡在登录界面无限循环（好像旧版本客户端也会出现，可能是系统更新带来的）。这是由于 GNOME shell 被搞崩了。在文件中搜索一个叫 warp-desktop-svc.service 文件（它应该会在 .config 目录下）并删掉它。问题就解决了。
期望官方能尽快修复这个问题，最好是把客户端的 GUI 和 CLI 分成两个包，毕竟不是所有用户都需要 GUI。