Wayland 호환성 문제
Wayland 개요
Ubuntu 26.04은 기본적으로 Wayland 디스플레이 프로토콜을 사용합니다. Wayland은 X11보다 더 안전하고 효율적이지만 일부 오래된 애플리케이션에는 호환성 문제가 있을 수 있습니다.
# Confirm the current session type
echo $XDG_SESSION_TYPE
# wayland or x11일반적인 호환성 문제
응용 프로그램 창이 흐릿하거나 크기 조정이 비정상적입니다.
일부 X11 응용 프로그램은 XWayland에서 흐리게 나타날 수 있습니다(특히 높은 DPI 화면에서).
# Force an application to use native Wayland (if supported)
GDK_BACKEND=wayland APP_NAME
# Force X11 (through XWayland)
GDK_BACKEND=x11 APP_NAME
# Qt applications
QT_QPA_PLATFORM=wayland APP_NAME
QT_QPA_PLATFORM=xcb APP_NAME # Force X11화면 공유/녹화를 사용할 수 없습니다.
Wayland은 애플리케이션이 화면 콘텐츠에 직접 액세스하는 것을 제한합니다. 화면 공유는 xdg-desktop-portal을 거쳐야 합니다.
# Confirm the portal service is running
systemctl --user status xdg-desktop-portal
systemctl --user status xdg-desktop-portal-gnome
# Restart the portal service
systemctl --user restart xdg-desktop-portal브라우저에서 화면 공유 시 반드시 PipeWire(Firefox, Chrome 모두 지원)을 지원하는 브라우저를 사용하세요.
원격 데스크톱 도구가 작동하지 않습니다
일부 원격 데스크톱 도구(예: TeamViewer, AnyDesk)에는 Wayland에서 문제가 있을 수 있습니다.
# Use GNOME built-in remote desktop
# Settings > System > Remote Desktop
# Or install Wayland-compatible VNC
sudo apt install gnome-remote-desktop글로벌 단축키가 작동하지 않습니다
Wayland은 애플리케이션이 전역 키보드 이벤트를 수신하는 것을 허용하지 않습니다(보안 제한).
솔루션:
- GNOME 설정에서 키보드 단축키 구성을 사용하세요.
- 일부 애플리케이션(예: Flameshot)은 D-Bus/포털 인터페이스를 통해 단축키를 등록해야 합니다.
클립보드 문제
클립보드는 Wayland의 다른 응용 프로그램에서 작동하지 않을 수 있습니다.
# Install wl-clipboard tools
sudo apt install wl-clipboard
# Copy
echo "content" | wl-copy
# Paste
wl-paste입력 방법 문제
# Confirm the input method framework
# Fcitx5 (recommended)
sudo apt install fcitx5 fcitx5-chinese-addons
# Set environment variables
# Add to /etc/environment:
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx
XMODIFIERS=@im=fcitx전자 응용
많은 Electron 애플리케이션(VS Code, Slack 등)은 Wayland 지원을 활성화해야 합니다.
# Add launch parameters
code --enable-features=UseOzonePlatform --ozone-platform=wayland
# Or modify the Exec line in the .desktop file
# Add --ozone-platform=waylandX.org 세션이 필요한 경우
Ubuntu 26.04부터 기본 Ubuntu 데스크톱(GNOME) 세션은 Wayland 전용입니다. 로그인 화면은 더 이상 “Xorg의 GNOME” 옵션을 제공하지 않습니다. WaylandEnable=false의 /etc/gdm3/custom.conf은 더 이상 적용되지 않습니다. 애플리케이션이 실제로 기본 X.org 서버에서 실행되어야 하는 경우 두 가지 옵션이 있습니다.
옵션 1: X.org 세션을 제공하는 다른 데스크탑 설치
KDE Plasma, Xfce, MATE, i3 및 유사한 데스크탑은 여전히 X.org 세션을 제공합니다. 설치한 후 로그인 화면 오른쪽 하단에 있는 기어 메뉴에서 X.org 세션을 선택하세요.
# Choose one
sudo apt install kubuntu-desktop # KDE Plasma (includes Plasma on X11)
sudo apt install xubuntu-desktop # Xfce (X.org session)
sudo apt install ubuntu-mate-desktop옵션 2: 해당 데스크톱 세션 내에서 X11 사용
위의 X.org 세션 중 하나에 로그인하면 xrandr, xdotool 및 xclip와 같은 X11 도구가 정상적으로 작동합니다. GNOME 세션에서는 대신 기본 Wayland 도구(wl-clipboard, ydotool, GNOME 설정 등)를 사용해야 합니다.
대부분의 X11 애플리케이션에는 세션 전환이 전혀 필요하지 않습니다. Wayland에서는 XWayland를 통해 자동으로 실행됩니다. X.org 서버 기능(글로벌 단축키, 레거시 화면 녹화 인터페이스)에 의존하는 소수의 경우에만 X.org 세션이 필요합니다.
XWayland
XWayland은 Wayland 아래의 X11 호환성 레이어입니다. 대부분의 X11 애플리케이션은 XWayland를 통해 자동으로 실행됩니다.
# Check if a window is running through XWayland
# Install xprop
sudo apt install x11-utils
xprop | grep -i xwayland
# If you can select the window, it is running on XWaylandGNOME에서 Alt+F2을 누르고 lg(Looking Glass)을 입력합니다. Windows 탭에서 각 창이 XWayland를 사용하고 있는지 확인할 수 있습니다.
NVIDIA 및 Wayland
NVIDIA GPU 사용자는 다음을 확인해야 합니다.
# Driver version 535 or higher
nvidia-smi | grep "Driver Version"
# Confirm GBM backend is enabled
ls /usr/lib/x86_64-linux-gnu/libnvidia-egl-gbm.so*
# Add to /etc/environment (if needed)
# GBM_BACKEND=nvidia-drm
# __GLX_VENDOR_LIBRARY_NAME=nvidia애플리케이션 호환성 빠른 참조
| 애플리케이션 | Wayland 지원 | 메모 |
|---|---|---|
| Firefox | 기본 지원 | 기본적으로 Wayland |
| Chrome/크롬 | 기본 지원 | 시작 매개변수가 필요합니다. |
| VS Code | 지원됨 | 오존 매개변수가 필요합니다. |
| LibreOffice | 기본 지원 | — |
| GIMP | XWayland | 잘 작동해요 |
| VLC | 기본 지원 | — |
| OBS 스튜디오 | 기본 지원 | PipeWire 캡처를 사용합니다. |
| Steam | XWayland | 일반적으로 작동 |
| Wine/Proton | XWayland | 일반적으로 작동 |