Skip to Content
ドキュメントリファレンストラブルシューティングウェイランド

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=wayland

X.org セッションが必要な場合

Ubuntu 26.04 以降、デフォルトの Ubuntu デスクトップ (GNOME) セッションは Wayland のみ: ログイン画面には「GNOME on Xorg」オプションが提供されなくなりました。 WaylandEnable=false の /etc/gdm3/custom.conf は無効になります。アプリケーションをネイティブ X.org サーバー上で実行する必要がある場合、次の 2 つのオプションがあります。

オプション 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 設定など) を使用する必要があります。

Note

ほとんどの 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 XWayland

GNOME で、「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ネイティブサポート—
GIMPXWayland正常に動作します
VLCネイティブサポート—
OBS スタジオネイティブサポートPipeWire キャプチャを使用します
SteamXWayland通常動作します
Wine/ProtonXWayland通常動作します
権限デュアルブート修復