WSL 安装及远程桌面（XRDP）问题解决总结

WSL 安装及远程桌面（XRDP）问题解决总结

一、WSL 基础账号相关操作

1. 查看当前用户

whoami

2. 修改/设置账号密码

passwd

输入当前密码后，设置新密码（输入无回显为正常现象）。

3. 新增用户

# 创建新用户

sudo adduser 用户名



# 赋予 sudo 管理员权限

sudo usermod -aG sudo 用户名



# 切换用户

su - 用户名

二、WSL 远程桌面 XRDP 关键问题及最终解决方案

问题现象

• 远程连接后黑屏

• 输入账号密码登录后直接闪退

核心原因

1. 同一用户在 WSLg 与 XRDP 会话冲突

2. startwm.sh 未正确配置桌面启动项

3. 缺少必要环境变量，导致桌面无法正常启动

4. 权限与服务未正常运行

最终有效解决方案

1. 彻底关闭 WSL 避免会话冲突

   在 Windows PowerShell 执行：

   
   wsl --shutdown
   
   

2. 启动必要服务

   
   sudo service dbus start
   
   sudo service xrdp restart
   
   

3. 修改 XRDP 启动脚本（关键）

   
   sudo nano /etc/xrdp/startwm.sh
   
   

   在文件最开头添加：

   
   unset DBUS_SESSION_BUS_ADDRESS
   
   unset XDG_RUNTIME_DIR
   
   

   注释文件末尾原有两行：

   
   # test -x /etc/X11/Xsession && exec /etc/X11/Xsession
   
   # exec /bin/sh /etc/X11/Xsession
   
   

   末尾添加桌面启动命令（以 XFCE 为例）：

   
   startxfce4
   
   

4. 配置用户会话文件

   
   echo "startxfce4" > ~/.xsession
   
   chmod +x ~/.xsession
   
   

5. 修复 XRDP 权限

   
   sudo adduser xrdp ssl-cert
   
   

6. 重启 XRDP 服务

   
   sudo service xrdp restart
   
   

三、WSL 内 Node.js 环境安装

安装 n 版本管理工具

sudo npm install -g n

常用 n 命令

# 安装最新 LTS 版本

sudo n lts



# 安装指定版本

sudo n 20



# 切换已安装版本

sudo n

四、总结

1. WSL 账号密码独立于 Windows，使用 passwd 管理，不可查看明文密码。

2. XRDP 黑屏/闪退核心：关闭 WSLg 会话 + 正确配置 startwm.sh + 清理环境变量。

3. 优先使用 XFCE 桌面，兼容性远高于 GNOME，可避免绝大多数启动异常问题。

4. Node 版本管理使用 n 工具，轻量且切换版本便捷。