【Ubuntu22】【XRDP】无头模式部署Jetson Orin Nano：远程桌面配置与排错指南

1. 为什么选择XRDP来远程控制你的Jetson Orin Nano？

如果你和我一样，手头有一块Jetson Orin Nano，想把它当作一个24小时运行的小型服务器或者开发机，但又不想一直给它接个笨重的显示器，那你肯定在琢磨远程控制的事儿。我试过好几种方案，VNC、TeamViewer，甚至一些Web方案，最后发现，在Ubuntu 22.04这种主流的桌面环境下，XRDP真的是一个被低估的宝藏。它最大的好处就是“开箱即用”感很强，特别是对于从Windows环境过来的朋友，直接用系统自带的“远程桌面连接”（mstsc）就能连上，那种无缝切换的感觉，比折腾一堆第三方客户端要舒服多了。

你可能听说过“无头模式”（Headless Mode），听起来挺唬人，其实就是让设备在没有物理显示器的情况下也能正常工作。对于Jetson Orin Nano这种嵌入式开发板，无头部署太常见了，我们把它塞进机器人、无人机或者边缘计算盒子里，哪有地方放显示器？这时候，一个稳定、低延迟的远程桌面就成了我们和板子“对话”的窗口。我选择XRDP，就是看中了它的协议成熟（基于RDP）、网络传输效率高，而且在Ubuntu上的集成度越来越好。实测下来，在局域网内操作流畅度非常接近本地，写代码、调界面基本感觉不到延迟。

当然，这条路也不是一帆风顺的。原始文章里提到的闪退、界面元素缺失，我都踩过坑。这篇文章，我就把我从零开始，在一块全新的Jetson Orin Nano（系统是Ubuntu 22.04 LTS，桌面环境是GNOME）上配置XRDP的完整过程，以及遇到的那些“坑”和解决办法，原原本本地分享给你。我的目标是，你跟着做一遍，就能获得一个稳定可用的远程桌面环境，把Orin Nano变成你口袋里随时可以掏出来的强大算力。

2. 基础安装与环境检查：迈出第一步

万事开头难，但安装XRDP本身其实简单得超乎想象。不过，在动手之前，我们得先确保环境是干净的，避免一些常见的“底楼”问题。

2.1 安装XRDP与初次状态检查

首先，通过SSH连接到你的Jetson Orin Nano。确保系统已经更新到最新，这是一个好习惯。

sudo apt update sudo apt upgrade -y

然后，就是安装XRDP的核心命令，一行搞定：

sudo apt install xrdp -y

安装过程很快，通常一两分钟就结束了。安装完成后，XRDP服务会自动启动。我们第一时间要确认它是否真的跑起来了：

sudo systemctl status xrdp

这个命令你会看到类似下面的输出，重点看active (running)这个状态：

● xrdp.service - xrdp daemon Loaded: loaded (/lib/systemd/system/xrdp.service; enabled; vendor preset: enabled) Active: active (running) since Tue 2023-10-10 09:00:00 UTC; 1min 30s ago Docs: man:xrdp(8) man:xrdp.ini(5) Main PID: 1234 (xrdp) Tasks: 1 (limit: 4915) Memory: 5.2M CPU: 120ms CGroup: /system.slice/xrdp.service └─1234 /usr/sbin/xrdp

如果看到绿色的active (running)，那么恭喜你，服务启动正常。但很多时候，我们第一次检查就会遇到问题，最常见的就是一个刺眼的红色failed字样。

2.2 解决端口冲突：与系统“远程桌面”功能的博弈

如果status命令显示失败，别慌，十有八九是端口冲突。Ubuntu 22.04 GNOME桌面自带了一个“远程桌面”共享功能（在“设置”->“共享”里），它默认也使用3389端口，而XRDP同样钟情于这个端口。一山不容二虎，所以我们必须做出选择。

我个人的建议是关闭系统自带的远程桌面共享，专心使用XRDP。原因很简单，系统自带的功能更偏向于简单的屏幕共享，在无头模式、长期后台服务方面，XRDP更专业、更稳定。

操作步骤如下：

1. 如果你当前有图形界面，直接进入“设置” -> “共享” -> “远程桌面”，将开关关闭。
2. 如果你已经是无头模式，通过SSH连接，可以用命令行禁用这个服务：

gsettings set org.gnome.desktop.remote-desktop.vnc enabled false

关闭系统远程桌面后，我们需要重启XRDP服务来让它重新绑定端口：

sudo systemctl restart xrdp sudo systemctl status xrdp

这次，你应该就能看到令人安心的active (running)状态了。

2.3 防火墙配置：为远程连接打开大门

解决了端口冲突，下一个拦路虎可能是防火墙。Ubuntu默认的防火墙工具是ufw（Uncomplicated Firewall）。默认情况下，它可能是关闭的，但有些定制镜像或出于安全考虑，它会被启用。

检查防火墙状态：

sudo ufw status

如果状态是inactive，那就不用管它。如果是active，并且有一堆规则，那么我们需要确保3389端口是开放的。

最直接的方法（适合开发环境）：允许3389端口通过。

sudo ufw allow 3389

或者，如果你在绝对安全的内部网络（比如家里的局域网）进行测试，想暂时排除防火墙干扰，可以临时关闭它（生产环境不推荐）：

sudo ufw disable

完成端口放行或关闭防火墙后，务必再次重启xrdp服务，让配置生效：

sudo systemctl restart xrdp

走到这一步，你的XRDP服务端在理论上已经准备就绪了。你可以在同一局域网下的另一台Windows电脑上，打开“远程桌面连接”，输入Jetson Orin Nano的IP地址，点击连接。如果运气好，你会看到一个登录界面。但根据我的经验，更大的挑战还在后面，特别是使用GNOME桌面时。

3. 攻克GNOME桌面连接闪退的顽疾

当你兴冲冲地用Windows远程桌面客户端连上去，输入用户名和密码，点击“确定”后，屏幕一闪，又回到了连接界面——这就是经典的“闪退”问题。这个问题在Ubuntu 22.04 + GNOME + XRDP的组合里几乎百分百会遇到。别担心，根源在于GNOME桌面环境的一些会话配置和XRDP不太兼容，我们有明确的解决办法。

3.1 诊断问题：查看错误日志

首先，我们需要知道闪退的具体原因。通过SSH回到Jetson Orin Nano，查看当前用户目录下的一个关键错误日志文件：

cat ~/.xsession-errors

你会看到一大堆输出，仔细找找，很可能在末尾附近会发现类似这样的错误信息：

/etc/X11/Xsession: 83: /home/your-username/.xsessionrc: Syntax error: "(" unexpected (expecting “fi”)

这条错误信息指向了一个文件：~/.xsessionrc。这个文件是用户级别的X会话启动脚本，XRDP在启动桌面时会读取它。问题就出在GNOME环境下，这个文件里可能包含了一些语法上不太兼容的Bash数组写法。

3.2 修复.xsessionrc文件

我们需要编辑这个~/.xsessionrc文件。如果它不存在，XRDP可能会自动创建一个有问题的版本；如果存在，我们就修改它。

用你喜欢的文本编辑器打开它，比如nano：

nano ~/.xsessionrc

原始文章里提到了一个来自国外社区的经典修复方案。这个方案的核心是修改GNOME的“收藏应用”列表，移除一些可能引起冲突的默认应用（如Thunderbird, Rhythmbox等），但其代码中的数组写法()在某些Shell环境下会报错。

你需要将文件中可能导致问题的部分，替换为以下更兼容的代码块：

if [ -e "/usr/bin/gnome-shell" ]; then remove_apps="thunderbird rhythmbox libreoffice-writer" favorite_apps="$(gsettings get org.gnome.shell favorite-apps)" for app in $remove_apps; do favorite_apps="$(echo "${favorite_apps}" | sed -e "s/'${app}.desktop', //g" -e "s/, '${app}.desktop' / /g")" done gsettings set org.gnome.shell favorite-apps "${favorite_apps}" fi

注意：这段代码的作用是循环移除“收藏夹”里的指定应用。如果你根本不用这些应用，直接移除没问题。但如果你希望保留（比如你真用LibreOffice），可以从remove_apps变量里删掉对应的应用名。

3.3 启用现代GNOME风格界面（关键步骤！）

仅仅修复语法错误可能还不够。很多朋友修复后能登录了，但进去发现桌面环境非常古老，像是回到了十年前的GNOME 2，而不是Ubuntu 22.04那个漂亮的现代界面。这是因为XRDP默认启动的会话类型可能不对。

为了让XRDP使用Ubuntu 22.04默认的GNOME Shell（也就是带侧边栏、活动概述的现代界面），我们需要在~/.xsessionrc文件的末尾，在最后一个fi之前，添加至关重要的环境变量：

export GNOME_SHELL_SESSION_MODE=ubuntu export XDG_CURRENT_DESKTOP=ubuntu:GNOME export XDG_CONFIG_DIRS=/etc/xdg/xdg-ubuntu:/etc/xdg

添加完成后，你的~/.xsessionrc文件看起来应该是这样的：

if [ -e "/usr/bin/gnome-shell" ]; then remove_apps="thunderbird rhythmbox libreoffice-writer" favorite_apps="$(gsettings get org.gnome.shell favorite-apps)" for app in $remove_apps; do favorite_apps="$(echo "${favorite_apps}" | sed -e "s/'${app}.desktop', //g" -e "s/, '${app}.desktop' / /g")" done gsettings set org.gnome.shell favorite-apps "${favorite_apps}" fi export GNOME_SHELL_SESSION_MODE=ubuntu export XDG_CURRENT_DESKTOP=ubuntu:GNOME export XDG_CONFIG_DIRS=/etc/xdg/xdg-ubuntu:/etc/xdg

保存并退出编辑器（在nano中是按Ctrl+X，然后按Y确认，再按回车）。

重要提示：在进行远程连接测试前，请确保你已经在Jetson Orin Nano的本地图形界面（如果有的话）上注销了当前用户。XRDP和本地图形会话同时占用一个用户会导致冲突。通过SSH操作不受影响。

现在，再次尝试用远程桌面客户端连接。你应该能顺利看到Ubuntu 22.04的登录界面，输入密码后，就能进入熟悉的现代GNOME桌面了。

4. 完善桌面体验：找回缺失的界面元素

成功登录是一个巨大的胜利，但你可能马上会遇到第二个问题：桌面空空如也。只有壁纸和顶部的状态栏，没有左侧的Dash（程序坞），右键点击桌面也没有“新建文件夹”、“打开终端”等菜单，桌面图标也不显示。这感觉就像进了个毛坯房。别急，这只是缺少了必要的GNOME Shell扩展。

4.1 安装GNOME Shell扩展包

这个问题解决起来非常简单，只需要安装一个软件包：

sudo apt install gnome-shell-extensions -y

这个命令会安装一系列基础的GNOME Shell扩展，其中就包含了管理桌面图标、提供完整桌面功能所必需的组件。安装完成后，你不需要重启XRDP服务，也不需要重启电脑。

你需要做的仅仅是：断开当前的远程桌面连接，然后重新连接一次。

重新登录后，奇迹就发生了：左侧的程序坞出现了，桌面右键菜单丰富了，如果你的~/Desktop文件夹里有文件，图标也会显示在桌面上了。整个桌面环境变得完整可用。

4.2 可选优化：安装图形化扩展管理工具

如果你希望对GNOME Shell扩展进行更细致的管理，比如安装一些第三方扩展来增强功能（例如显示网速、天气等），可以安装一个图形化管理工具：

sudo apt install gnome-shell-extension-manager -y

安装后，你可以在远程桌面的“应用程序”菜单里找到“Extension Manager”，用它来浏览、安装、启用或禁用扩展。这对于个性化你的远程开发环境非常有用。

5. 高级排错与性能优化指南

基础功能都搞定后，我们可以追求更稳定、更流畅的体验了。下面这些是我在长期使用中总结出来的技巧和排错方法。

5.1 检查与确保用户自动登录已关闭

这是一个非常关键但容易被忽略的设置。如果你的Ubuntu系统设置了用户自动登录（即开机不输入密码直接进入桌面），那么XRDP将无法为该用户创建新的桌面会话，导致连接失败或异常。

检查与关闭方法：

1. 图形界面（如果有）：进入“设置” -> “用户” -> “自动登录”，确保它是关闭的。
2. 命令行（推荐）：通过SSH执行以下命令来禁用自动登录。这里假设你的用户名是orin，请替换为你自己的用户名。

   sudo -H gsettings set org.gnome.login-screen automatic-login false sudo -H gsettings set org.gnome.login-screen automatic-login-user ''

   第一条命令关闭自动登录功能，第二条命令清空自动登录的用户名。

5.2 调整XRDP配置以提升性能

XRDP的配置文件位于/etc/xrdp/xrdp.ini。我们可以进行一些微调来适应不同的网络环境。

sudo nano /etc/xrdp/xrdp.ini

找到[globals]部分，你可以关注或修改以下参数：

• port=3389: 默认端口，如果冲突可以修改。
• crypt_level=high: 加密级别，high是默认值，安全性好。在极其安全的内部网络，如果你追求极致性能且不担心安全问题，可以改为low或none（强烈不推荐用于任何有风险的网络）。
• max_bpp=32: 每个像素的最大位数，32位色深提供最好画质。如果网络慢，可以尝试改为24或16来减少数据量。

更重要的配置在/etc/xrdp/sesman.ini，它控制会话管理：

sudo nano /etc/xrdp/sesman.ini

• 在[Xorg]部分，可以指定不同的分辨率。例如，添加一行param=-screen 1920x1080可以设置默认分辨率。但更灵活的做法是在远程桌面客户端连接时设置。

修改任何配置后，都需要重启XRDP服务：

sudo systemctl restart xrdp

5.3 客户端连接优化（Windows/macOS/Linux）

• Windows 远程桌面客户端：点击“显示选项”，在“显示”标签页可以调整远程会话的分辨率。在“体验”标签页，根据你的网络情况选择“连接速度”，例如“局域网（10 Mbps或更高）”会启用更多视觉特效，而“低带宽”则会禁用大部分特效以提升流畅度。
• macOS/Linux 客户端：可以使用Remmina或FreeRDP等开源客户端。在Remmina中，创建连接时可以在“高级”设置里调整色彩深度、禁用壁纸/字体平滑等来优化性能。

5.4 常见问题快速排查清单

如果你在按照上述步骤操作后仍然遇到问题，可以顺着这个清单检查一遍：

1. 连接被拒绝：检查Jetson Orin Nano的IP地址是否正确；确认客户端和开发板在同一个网络；用ping命令测试网络连通性。
2. 输入密码后无限循环或黑屏：这是最经典的.xsessionrc或会话配置问题。请再次仔细检查~/.xsessionrc文件的语法，确保没有多余的空格或格式错误。可以尝试暂时重命名该文件（mv ~/.xsessionrc ~/.xsessionrc.bak）然后重启xrdp，看是否能进入一个基础的桌面环境（这可以帮你判断问题是否出在这个文件）。
3. 画面卡顿、延迟高：首先确认网络状况；其次在客户端调整连接体验设置为“低带宽”；最后可以尝试在XRDP配置中降低色彩深度（max_bpp）。
4. 声音无法从远程传输到客户端：XRDP默认不转发声音。如果需要，可以安装pulseaudio模块并配置。但对于无头服务器，通常不需要音频。
5. 剪贴板共享或文件传输问题：基础的XRDP配置可能不包含这些高级功能。如果需要，可以研究安装xrdp-pulseaudio-installer和配置thinlinc等更复杂的方案，但这超出了本文基础指南的范围。

经过这一系列配置和优化，你的Jetson Orin Nano应该已经成为一个非常称职的无头工作站了。我自己的Orin Nano现在常年放在角落，只有一根电源线和一根网线，通过XRDP远程访问，进行ROS 2开发、模型训练和编译工作，稳定运行了几个月，再也没有出现过闪退或者界面异常的问题。这种随时可以调用强大算力，又无需操心外设的感觉，对于嵌入式开发者来说，效率提升是实实在在的。