Light OS中Arch安装XRDP教学文档

本文适用于：

• Light OS安装的Arch Linux
• 部署时勾选XFCE桌面环境

1. 先搞清楚 XRDP 是什么

xrdp 可以让 Linux 提供 RDP 远程桌面服务。

简单理解：

• 你的 Linux 机器是“被控端”
• 你的 Windows / macOS / 另一台 Linux 是“控制端”
• 控制端通过 RDP 协议连接到 Linux 机器

2. 安装前准备

先确认几件事：

1. 你能通过 SSH 登录这台 Linux 机器
2. 你知道这个普通用户的密码
3. 这个普通用户可以执行 sudo
4. 网络上能访问这台机器的 3389 端口

说明：

• xrdp 默认监听 3389

3. 为什么推荐 XFCE

原因很简单：

• XFCE 轻量
• 跟 xrdp 兼容性好
• 出问题时比 GNOME / Wayland 更容易排查

4. 小白安装步骤

下面的命令，默认都是在 SSH 终端里执行。

注意：

• 不要用 root 账号直接跑 makepkg
• 用普通用户登录，然后在需要权限时加 sudo

第一步：连接到Light OS里的arch,并安装基础工具

# 执行：
sudo pacman -S --needed base-devel git gnupg

这些包的作用：

• base-devel：编译 AUR 软件时需要
• git：从 AUR 拉取源码
• gnupg：验证签名时需要

第二步：安装 XFCE 桌面和编译依赖

# 执行:
sudo pacman -S --needed xfce4 xorg-xinit xorg-server-devel jack2

说明：

• xfce4：桌面环境
• xorg-xinit：提供 .xinitrc 使用环境
• xorg-server-devel：编译 xorgxrdp 时需要
• jack2：提前装好，避免 AUR 构建时出现音频依赖二选一提示

如果你还没装图形环境，这一步时间会比较久，正常。

第三步：编译安装 xrdp

进入临时目录：

cd /tmp
git clone https://aur.archlinux.org/xrdp.git
cd xrdp
makepkg -si

说明：

• 第一次执行会下载源码并编译
• 过程中会多次提示输入 sudo 密码，正常输入即可
• 安装完成后会自动生成 /etc/xrdp/rsakeys.ini
• 编译会用时较久，lc02用时7分钟左右，请作参考

第四步：导入 xorgxrdp 的 GPG 公钥

先执行下面的命令导入公钥才能拉取到下面git仓库内容：

gpg --keyserver hkps://keyserver.ubuntu.com --recv-keys 03993B4065E7193B

第五步：编译安装 xorgxrdp

继续执行：

cd /tmp
git clone https://aur.archlinux.org/xorgxrdp.git
cd xorgxrdp
makepkg -si

如果 /tmp/xorgxrdp 已经存在，可以先删掉旧目录，或者直接进入旧目录重新执行。

第六步：设置远程登录后启动 XFCE

分别执行：

echo "exec startxfce4" > ~/.xinitrc
ln -sf ~/.xinitrc ~/.xsession

这一步的作用是：

• 告诉 xrdp 登录后启动 XFCE
• 让 ~/.xsession 指向同样的配置

第七步：启动并设置开机自启

执行：

sudo systemctl enable --now xrdp
sudo systemctl enable --now xrdp-sesman

第八步：检查服务是否正常

执行：

systemctl status xrdp --no-pager
systemctl status xrdp-sesman --no-pager
ss -lnt | rg 3389

如果正常，你应该看到：

• xrdp 是 active (running)
• xrdp-sesman 是 active (running)
• 3389 端口处于监听状态

5. 客户端怎么连接

Windows

按 Win + R，输入：

mstsc

然后：

1. 在“计算机”里输入 Linux 机器的 IP
2. 点击连接
3. 输入 Linux 用户名和密码
4. 登录后应进入 XFCE 桌面

macOS / Linux

可以使用下面任意一个 RDP 客户端：

• mac安装"Windows App"
• Remmina
• FreeRDP

连接时填写：

• 地址：Linux 机器 IP 或域名
• 端口：3389
• 用户名：你的 Linux 普通用户
• 密码：该用户密码

# mac安装及连接代码段
brew install --cask xquartz     # X11 图形支持，安装后需重启 Mac
brew install freerdp            # RDP 客户端
重启Mac
xfreerdp /v:192.168.xx.xxx /u:用户名 /p:199337 /w:1440 /h:900 /cert:ignore /t:60

# arch linux安装及连接代码段:
sudo pacman -S freerdp          # RDP 客户端
xfreerdp3 /v:192.168.xx.xxx /u:用户名 /p:199337 /w:1440 /h:900 /cert:ignore /t:60

6. 常见问题排查

1. 安装 xorgxrdp 时提示缺少 xorg-server-devel

先补装：

sudo pacman -S --needed xorg-server-devel

再重新安装 xorgxrdp。

2. 安装 xorgxrdp 时提示找不到 xrdp

这通常说明 xrdp 还没有真正安装成功。

先回到 xrdp 目录重新执行：

cd /tmp/xrdp
makepkg -si

确认 xrdp 装好以后，再装 xorgxrdp。

3. 能连上，但黑屏或闪退

优先检查这几项：

1. ~/.xinitrc 是否是 exec startxfce4
2. ~/.xsession 是否已经链接到 ~/.xinitrc
3. xfce4 是否真的安装了
4. 服务是否正常运行

检查命令：

cat ~/.xinitrc
ls -l ~/.xsession
pacman -Q xfce4
systemctl status xrdp xrdp-sesman --no-pager

4. 远程连不上

依次检查：

ss -lnt | grep 3389
systemctl status xrdp --no-pager
systemctl status xrdp-sesman --no-pager

如果服务正常，但客户端还是连不上，就去检查：

• 机器 IP 是否正确
• 防火墙是否放行 3389
• 路由器或云安全组是否放行 3389

5. 查看日志

最常用的排查命令：

journalctl -u xrdp -u xrdp-sesman -b --no-pager

如果想看最新 100 行：

journalctl -u xrdp -u xrdp-sesman -b --no-pager | tail -n 100