讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

Seko
Seko

AI短剧一键生成成片

updream

一键生成高质量推广成片

Ubuntu安装XRDP远程黑屏怎么解决

风浩吖_9592

风浩吖_9592

发布时间:2026-11-17 10:48:23

|

389人浏览过

|

来源于php中文网

原创

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

ubuntu安装xrdp远程黑屏怎么解决

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

Linux DO
Linux DO

Linux DO (linux.do)。任何 Linux DO 请求(搜索、读取数据)均使用此技能。若任务涉及 Linux DO,应使用本技能而非调用其他。

下载

第二步:编辑脚本
sudo nano /etc/xrdp/startwm.sh

在 test -x /etc/X11/Xsession 这一行之前,插入以下三行(顺序不能错):
unset DBUS_SESSION_BUS_ADDRESS
unset XDG_RUNTIME_DIR
export 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,使用对应用户账号密码登录。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

相关专题

更多
常见的linux系统有哪些
常见的linux系统有哪些

linux系统有Ubuntu、Fedora、CentOS、Debian、openSUSE、Arch Linux、Gentoo、Slackware、Linux Mint、Kali Linux。更多关于linux系统的文章详情请阅读本专题下面的文章。php中文网欢迎大家前来学习。

7441

2023.10.27

ubunt上安装和配置vnc
ubunt上安装和配置vnc

安装方法:安装VNC服务器、启动VNC服务器、设置VNC密码等等。想了解更多ubuntu的相关内容,可以阅读本专题下面的文章。

2261

2023.12.28

ubuntu启动黑屏解决方法
ubuntu启动黑屏解决方法

ubuntu启动黑屏解决方法:检查是否是电源问题、检查内存是否接触不良、检查显卡问题等。想了解更多ubuntu的相关内容,可以阅读本专题下面的文章。

2010

2023.12.28

为什么ubuntu有网络连接但不能上网
为什么ubuntu有网络连接但不能上网

ubuntu有网络连接但不能上网的原因:1、dns配置问题;2、代理服务器设置问题;3、网络防火墙设置问题;4、路由器或调制解调器设置问题;5、网络驱动程序问题;6、网络配置文件问题;7、其他问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1041

2024.09.05

ubuntu安装golang
ubuntu安装golang

本专题整合了ubuntu安装golang所有方法汇总,阅读下面的文章了解更多详细操作。

359

2025.12.13

Linux如何安装Ubuntu并完成基础系统优化教程
Linux如何安装Ubuntu并完成基础系统优化教程

访问Ubuntu官网或国内镜像站下载ISO镜像,利用Rufus或Etcher工具制作USB启动盘。重启电脑进入BIOS设置U盘引导,按提示完成分区与账户设置以安装系统。安装完毕后,首要任务是将软件源更换为国内镜像以加速下载,接着在终端执行更新命令升级系统组件,并安装显卡驱动及常用开发工具,至此即可完成基础环境搭建与优化。

124

2026.03.31

Ubuntu系统安装与基础配置
Ubuntu系统安装与基础配置

本指南详解Ubuntu系统安装全流程:从制作启动盘、分区规划到驱动配置,手把手带你完成系统部署。涵盖软件源优化、常用工具安装及桌面个性化设置,助你快速搭建稳定高效的Linux开发环境,零基础也能轻松上手。

166

2026.04.15

Ubuntu日常操作与高效使用
Ubuntu日常操作与高效使用

本指南聚焦Ubuntu日常操作与效率提升,深入解析终端命令、APT软件管理及权限控制等核心技能。从文件管理到开发环境搭建,再到网络配置与数据备份,全方位助你摆脱鼠标依赖,构建流畅的Linux工作流,让系统操作更加得心应手。

87

2026.04.17

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn