nexus/wiki/concepts/GDM3.md

title, type, tags, last_updated

title	type	tags	last_updated
GDM3	concept	显示管理器 GNOME Ubuntu	2026-04-14

GDM3

GNOME Display Manager 3，是 Ubuntu 桌面环境默认的登录管理器，负责用户认证、会话选择和显示协议切换。

基本信息

• 类型：显示管理器（Display Manager）
• 所属项目：GNOME
• 配置文件：/etc/gdm3/custom.conf
• 官网：https://wiki.gnome.org/Projects/GDM

核心功能

• 用户认证：显示登录界面，验证用户凭据
• 会话选择：允许用户选择桌面环境（GNOME/XFCE/KDE等）
• 显示协议：控制使用 Wayland 或 X11
• 会话启动：调用用户选择的桌面环境

与 Wayland/X11 的关系

GDM3 是连接显示协议和用户会话的桥梁：

硬件 → Kernel → Mesa/DRI → X11/Wayland → GDM3 → GNOME Shell → 用户应用

配置显示协议

编辑 /etc/gdm3/custom.conf：

sudo nano /etc/gdm3/custom.conf

配置	效果
WaylandEnable=true（默认）	GDM 和会话都使用 Wayland
WaylandEnable=false	强制 GDM 和会话使用 X11

完整配置示例

[daemon]
# 取消注释以禁用 Wayland，强制使用 X11
WaylandEnable=false

# 自动登录（可选）
AutomaticLogin=username
AutomaticLoginEnable=True

# Timed 登录（可选）
TimedLogin=username
TimedLoginEnable=True
TimedLoginDelay=5

重启 GDM3 服务

修改配置后需要重启 GDM：

# 方法1：重启 GDM 服务（不中断其他用户）
sudo systemctl restart gdm3

# 方法2：完全重启（会中断所有会话）
sudo reboot

故障排查

GDM 无法启动

# 查看 GDM 日志
sudo journalctl -u gdm3 -n 50

# 检查 X11 日志
cat /var/log/Xorg.0.log

切换后黑屏

通常是显卡驱动问题，尝试：

# 查看当前显卡
lspci | grep -i vga

# 安装推荐驱动
sudo ubuntu-drivers autoinstall

相关概念

• Wayland — 默认显示协议（Ubuntu 24.04）
• X11 — 传统显示协议（通过 WaylandEnable=false 启用）
• RustDesk — 受 GDM Wayland 配置影响的远程桌面软件
• GNOME — 使用 GDM3 的桌面环境