根本原因是xrdp不支持Wayland且GNOME会话启动失败;需禁用Wayland、切换为LightDM、修改startwm.sh脚本并设置用户级.xsession文件。

Ubuntu安装XRDP后远程连接成功但桌面一片漆黑,根本原因是xrdp无法正确加载图形会话——它卡在了显示协议、环境变量或桌面启动流程的某个环节,而不是网络不通或服务没起来。
确认并强制使用X11显示协议
Ubuntu 22.04+ 默认启用Wayland,而xrdp只支持Xorg;若系统仍在用Wayland,远程会话根本无法初始化图形输出。
执行 sudo nano /etc/gdm3/custom.conf 打开GDM3配置文件。
找到 [daemon] 区块,在其下方添加或取消注释这一行:
【WaylandEnable=false】
按 Ctrl+O → 回车保存,Ctrl+X 退出。然后执行 sudo systemctl restart gdm3 重启显示管理器——这步必须做,仅改配置不重启无效。
切换显示管理器为LightDM(推荐)
GDM3与xrdp存在已知兼容性冲突,尤其在多用户或自动登录场景下极易触发黑屏。LightDM更轻量、更稳定,且对xrdp会话调度更友好。
方法一:安装并设为默认
运行 sudo apt install lightdm → 安装过程中会弹出交互式菜单,用方向键选中 lightdm → 按 Tab 切换到 OK → 回车确认。
方法二:命令行重置默认项
执行 sudo dpkg-reconfigure lightdm → 同样选择 lightdm 并确认。
完成后重启系统:sudo reboot。重启后终端中运行 cat /etc/X11/default-display-manager,应输出 /usr/sbin/lightdm。
修复xrdp会话启动脚本
/etc/xrdp/startwm.sh 是xrdp创建桌面会话的实际入口,GNOME环境在此脚本中常因变量缺失或检测逻辑失败而静默退出,导致黑屏。
第一步:备份原文件sudo cp /etc/xrdp/startwm.sh /etc/xrdp/startwm.sh.bak
第二步:编辑脚本sudo nano /etc/xrdp/startwm.sh
在 test -x /etc/X11/Xsession 这一行之前,插入以下三行(顺序不能错):unset DBUS_SESSION_BUS_ADDRESSunset XDG_RUNTIME_DIRexport GNOME_SHELL_SESSION_MODE=ubuntu
第三步:定位到以 exec 开头的最后一段(通常形如 exec /etc/X11/Xsession),将其整行替换为:exec /etc/X11/Xsession → 如果你装的是XFCE,则改为 exec xfce4-session;若坚持用GNOME,保留原 exec 行但确保上面三行已插入。
设置用户级会话控制文件
仅靠系统级脚本还不够,xrdp实际以当前用户身份启动桌面,需明确告知它该跑什么会话。
在你将用于远程登录的**主用户家目录**下创建 .xsession 文件:echo 'gnome-session' > ~/.xsession(GNOME用户)
或echo 'xfce4-session' > ~/.xsession(XFCE用户)
立即赋予可读权限:chmod 644 ~/.xsession —— 【权限不对会导致xrdp完全忽略该文件】
这一步不能跳过,也不能用 sudo 创建在 root 家目录下——xrdp读取的是远程登录用户的家目录。
重启xrdp服务并验证
依次执行:sudo systemctl daemon-reload → sudo systemctl restart xrdp → sudo systemctl restart xrdp-sesman
检查状态:systemctl status xrdp 应显示 active (running),且无红色 failed 提示。
此时从Windows远程桌面(mstsc)重新连接,输入Ubuntu主机IP,使用对应用户账号密码登录。











