If NymVPN opens with a blank or empty window on Linux, the cause is almost always graphics related: either an NVIDIA graphics card interacting badly with the display backend, or a known issue with the AppImage build of the app. The fixes below cover these cases.
NVIDIA graphics on X11
该问题在大多数的情况下都可以检测到并且系统内部会自动处理。 However, if you are still encountering a blank screen, try launching the app with the following command:
GDK_BACKEND=x11 WEBKIT_DISABLE_DMABUF_RENDERER=1 nym-vpn-appNVIDIA graphics on Wayland
We have received some reports of similar blank screen issues when using Wayland with NVIDIA graphics. 和 X11 不同的是该问题并没有一个自带的的修复方案。 If you are using Wayland and experience a blank screen:
- Try switching to an X11 session as a temporary workaround.
- Or contact the NymVPN support team and let us know your system setup so we can help troubleshoot.
We are actively looking into better long-term support for Wayland and NVIDIA setups.
Blank screen with the AppImage version
Some users launching the AppImage version of the NymVPN client may encounter a blank window regardless of graphics card. If the following message appears in the app logs, this is the cause:
Could not create default EGL display: EGL_BAD_PARAMETER. Aborting...This is an upstream graphics compatibility issue related to how the AppImage was generated using Tauri. There is no fix available at this time; it is tracked on GitHub as Issue #2985.
Workaround: use an installation method that is not affected by the EGL error:
- Deb or AUR packages (if available for your distro)
- Flatpak package
Rebuild the font cache
On some Linux distributions a stale or incomplete font cache can leave the app rendering a blank window even when your graphics setup is fine. This was reported on Zorin OS, but the step is safe to try on any distribution. Rebuild the font cache with this command in a terminal, then relaunch NymVPN:
fc-cache -fvStill seeing a blank screen?
Contact Nym Support with your distro, desktop environment, display server (X11 or Wayland), graphics card, installation method, and logs. 您可以参阅文章 NymVPN 的应用程序和守护进程日志在哪里？
相关问题
How do I check whether I am on X11 or Wayland?
Run echo $XDG_SESSION_TYPE in a terminal. It prints x11 or wayland on most distros.
How do I switch installation method?
Uninstall the AppImage version, then install from the download page using a different package. 参阅文章如何卸载 NymVPN Linux 版？