EasyPi R2 基于iStoreNext的HDMI本地桌面及XRDP远程桌面配置手册

6666 · 2026 年4 月 22 日 11:42

EasyPi R2 基于iStoreNext的HDMI本地桌面及XRDP远程桌面配置手册

心心念念的EasyPi R2终于到了，RK3588的GPU和VPU这么强，默认的debian没预装桌面怎么行？折腾了好久，把最终可实现的步骤做成操作手册。大家可以下载下面这个html手册文件，手册文件支持一键替换代码的默认用户名 fk ，然后复制粘贴代码一步步操作即可：

EasyPi R2 基于iStoreNext的HDMI本地桌面及XRDP远程桌面配置手册.html

iStoreNext 保持为默认 TTY 启动，同时为用户 fk 配置手动 startx 进入 XFCE、XRDP 远程桌面、中文界面、Fcitx5 中文输入法，以及本地 HDMI / 远程桌面音频基础环境。

这份教程偏向实操记录，适合和我一样想把 EasyPi R2 当成轻量桌面 / 远程 Linux 小主机使用的朋友参考。

最终效果

开机默认 TTY
本地 HDMI 进入 XFCE
鼠标键盘可用
XRDP 远程桌面
中文与拼音输入法

使用说明

最终使用方式

开机进入 TTY，使用 fk 登录后输入 startx 进入 XFCE；注销后回到 TTY。

远程访问方式

XRDP 走 3389 端口。

阶段 1：创建用户与权限
阶段 2：安装桌面、音频、远程桌面组件
阶段 3：保持 TTY 启动并配置 Xorg 输入
阶段 4：中文系统环境
阶段 5：配置本地 XFCE 会话
阶段 6：配置 XRDP 远程桌面
阶段 7：最终检查与验证
阶段 8：常用桌面软件安装指引
常见问题

阶段 1：创建用户与权限

创建普通用户 fk，并加入 sudo、音频、视频、输入设备等必要权限组。

1：用户与权限组

保证 fk 能管理系统、访问 HDMI、声音、GPU、键盘鼠标等设备。

提示： 如果用户 fk 已经存在，命令会自动跳过创建用户，只补齐权限组。

id fk >/dev/null 2>&1 || adduser fk

apt update
apt install -y sudo

usermod -aG sudo,audio,video,render,input,plugdev fk

阶段 2：安装桌面、音频、远程桌面组件

安装 XFCE、Xorg、PipeWire、XRDP、输入设备驱动、中文字体和中文输入法。VNC 改为可选模块，后面单独安装。

2：安装软件包

轻量 XFCE 桌面 + XRDP + PipeWire + Fcitx5；VNC 如需备用访问再单独启用。

注意： 如果某个包提示找不到，不要慌，先执行剩余安装。尤其是 pipewire-module-xrdp 在不同源里可能名称或可用性不一致。

apt update && apt upgrade -y

apt install -y --no-install-recommends \
  xserver-xorg \
  xinit \
  xauth \
  dbus-x11 \
  xfce4 \
  xfce4-terminal \
  thunar \
  fonts-noto-cjk \
  fonts-wqy-zenhei \
  fonts-wqy-microhei \
  mesa-utils \
  pipewire \
  pipewire-audio \
  pipewire-pulse \
  pipewire-alsa \
  wireplumber \
  pavucontrol \
  pulseaudio-utils \
  alsa-utils \
  xrdp \
  xorgxrdp \
  libpipewire-0.3-modules-xrdp \
  pipewire-module-xrdp \
  xserver-xorg-input-libinput \
  xserver-xorg-input-evdev \
  libinput-tools \
  xinput \
  xserver-xorg-legacy \
  udev \
  fcitx5 \
  fcitx5-chinese-addons \
  fcitx5-frontend-gtk2 \
  fcitx5-frontend-gtk3 \
  fcitx5-frontend-gtk4 \
  fcitx5-frontend-qt5 \
  fcitx5-config-qt \
  im-config

如果 pipewire-module-xrdp 报错，可单独保留下面这个包：

apt install -y libpipewire-0.3-modules-xrdp

阶段 3：保持 TTY 启动并配置 Xorg 输入

目标是开机仍然进入 TTY，本地用户 fk 手动输入 startx 进入 XFCE。

3：TTY 与 Xorg 权限

避免安装桌面后自动进入图形登录，同时解决 startx 后键鼠不可用问题。

systemctl set-default multi-user.target
systemctl disable --now display-manager.service 2>/dev/null || true
systemctl disable --now lightdm gdm3 sddm xdm 2>/dev/null || true

cat > /etc/X11/Xwrapper.config <<'EOF'
allowed_users=console
needs_root_rights=yes
EOF

mkdir -p /etc/X11/xorg.conf.d

cat > /etc/X11/xorg.conf.d/40-libinput.conf <<'EOF'
Section "InputClass"
        Identifier "libinput keyboard catchall"
        MatchIsKeyboard "on"
        MatchDevicePath "/dev/input/event*"
        Driver "libinput"
EndSection

Section "InputClass"
        Identifier "libinput pointer catchall"
        MatchIsPointer "on"
        MatchDevicePath "/dev/input/event*"
        Driver "libinput"
EndSection

Section "InputClass"
        Identifier "libinput touchpad catchall"
        MatchIsTouchpad "on"
        MatchDevicePath "/dev/input/event*"
        Driver "libinput"
EndSection
EOF

阶段 4：中文系统环境

生成中文 UTF-8 locale，让 XFCE 菜单、文件管理器等界面使用中文。

4：Locale 与系统中文

字体只负责显示中文，LANG / LANGUAGE 才决定界面语言。

sed -i 's/^# *zh_CN.UTF-8 UTF-8/zh_CN.UTF-8 UTF-8/' /etc/locale.gen
sed -i 's/^# *en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/' /etc/locale.gen
locale-gen

cat > /etc/default/locale <<'EOF'
LANG=zh_CN.UTF-8
LANGUAGE=zh_CN:zh
LC_CTYPE=zh_CN.UTF-8
LC_MESSAGES=zh_CN.UTF-8
LC_ALL=
EOF

阶段 5：配置本地 XFCE 会话

配置 fk 的 startx 入口，并同时加载中文环境和 Fcitx5 输入法。

5：本地 HDMI：TTY → startx → XFCE

注销 XFCE 后自动回到 TTY。

USER_HOME=$(getent passwd fk | cut -d: -f6)

cat > "$USER_HOME/.xinputrc" <<'EOF'
run_im fcitx5
EOF

cat > "$USER_HOME/.xinitrc" <<'EOF'
#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS

export LANG=zh_CN.UTF-8
export LANGUAGE=zh_CN:zh
export LC_CTYPE=zh_CN.UTF-8
export LC_MESSAGES=zh_CN.UTF-8

export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx
export INPUT_METHOD=fcitx

exec dbus-run-session sh -c 'fcitx5 -d >/tmp/fcitx5-$USER.log 2>&1; exec startxfce4'
EOF

chown fk:fk "$USER_HOME/.xinputrc" "$USER_HOME/.xinitrc"
chmod +x "$USER_HOME/.xinitrc"

本地 HDMI 使用流程：开机 → TTY 登录 fk → 输入 startx → 进入 XFCE。
退出 XFCE：在桌面里注销，系统会回到 TTY。
首次进入 XFCE 后，可运行 fcitx5-config-qt 添加拼音输入法。

阶段 6：配置 XRDP 远程桌面

XRDP 用于远程登录 fk 的 XFCE 桌面，并优先承担远程音频重定向。

6：XRDP：3389 端口

Windows、macOS、Android、iPadOS 上的 RDP 客户端均可连接。

USER_HOME=$(getent passwd fk | cut -d: -f6)

cat > "$USER_HOME/.xsession" <<'EOF'
#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS

export LANG=zh_CN.UTF-8
export LANGUAGE=zh_CN:zh
export LC_CTYPE=zh_CN.UTF-8
export LC_MESSAGES=zh_CN.UTF-8

export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx
export INPUT_METHOD=fcitx

exec dbus-run-session sh -c 'fcitx5 -d >/tmp/fcitx5-$USER.log 2>&1; exec startxfce4'
EOF

chown fk:fk "$USER_HOME/.xsession"
chmod +x "$USER_HOME/.xsession"

adduser xrdp ssl-cert 2>/dev/null || true
systemctl enable --now xrdp
systemctl restart xrdp

完成后： 连接方式：远程桌面客户端 → 设备 IP:3389 → 用户名 fk → 输入 fk 的系统密码。

阶段7：最终检查与验证

确认 TTY、用户组、XRDP、中文环境和本地桌面都正常；

7：检查命令

配置完成后建议逐项执行。

# 默认启动目标，应为 multi-user.target
systemctl get-default

# fk 应包含 sudo audio video render input plugdev
groups fk

# XRDP 状态与端口
systemctl status xrdp --no-pager
ss -lntp | grep 3389


# 中文环境
su - fk -c 'locale'

# Fcitx5 诊断
su - fk -c 'fcitx5-diagnose'

阶段 8：常用桌面软件安装指引

下面这些属于桌面环境装好后的可选软件。Chromium、Firefox、Telegram、VLC 可直接用 apt 安装；WPS、QQ、微信建议从官方页面下载对应架构的 Deb 包。

8A：APT 直接安装的软件

浏览器、Telegram、VLC，适合 Debian / Ubuntu 系。

分类： 浏览器 / 影音播放 / 即时通讯

# 安装 Chromium
sudo apt install chromium chromium-l10n -y

# 安装火狐 ESR 中文版
sudo apt install firefox-esr firefox-esr-l10n-zh-cn -y

# 安装 Telegram
sudo apt install telegram-desktop -y

# 安装 VLC
sudo apt install vlc -y

提示： 如果提示找不到 chromium，可能是当前 Debian / iStoreNext 源里包名不同或未启用对应仓库，可先用 apt search chromium 查看实际包名。

8B：WPS、QQ、微信 Linux Deb 下载链接

EasyPi R2 / RK3588 是 ARM64 / aarch64，下载时优先选择 ARM / arm64 / aarch64 的 Deb 包。

注意： 重要：先执行 dpkg --print-architecture。如果输出 arm64，QQ / 微信要选 ARM 或 arm64 Deb；不要下载 amd64 / x86_64 包。

WPS Office Linux 官方下载页：页面内选择 Deb。当前个人版页面主要公开 X64；ARM 等架构按页面提示前往 WPS 365。
WPS 365 官方下载页：用于查找更多 CPU 架构包，例如 ARM / 信创架构等。
QQ Linux 官方下载页：选择 ARM版下载 → deb；Debian / Ubuntu 系用 .deb。
微信 Linux 官方下载页：选择 Linux → ARM → deb；如页面打不开，可试下面的腾讯 CDN 直链。
微信 ARM64 Deb 直链：腾讯 CDN：WeChatLinux_arm64.deb。直链可能随官方发布调整，优先以官网页面为准。

# 查看当前系统架构
dpkg --print-architecture

# 假设已经把 deb 包下载到当前目录，使用下面命令安装
sudo apt install ./wps-office*.deb -y
sudo apt install ./linuxqq*.deb -y
sudo apt install ./WeChatLinux*.deb -y

# 如果缺依赖，通常再执行一次
sudo apt -f install -y

常见问题

遇到问题时，先按下面几项排查。

进入 XFCE 后鼠标键盘不可用

通常是 Xorg 输入驱动或权限问题。

apt install -y xserver-xorg-input-libinput xserver-xorg-input-evdev xserver-xorg-legacy
usermod -aG input,video,render,audio,plugdev fk

cat > /etc/X11/Xwrapper.config <<'EOF'
allowed_users=console
needs_root_rights=yes
EOF

reboot

中文输入法没有出来

进入 XFCE 后手动打开配置工具添加拼音。

fcitx5-config-qt

在配置界面点击“+”，取消“只显示当前语言”，搜索并添加 Pinyin / 拼音。常见切换键为 Ctrl + Space。

XRDP 能连但没有声音

优先确认 RDP 客户端开启了远程音频播放。

Windows 远程桌面：本地资源 → 远程音频 → 在此计算机上播放。
进入 XRDP 桌面后执行 wpctl status，查看是否出现 XRDP 相关音频输出。
本地 HDMI 声音建议在 XFCE 中打开 pavucontrol 选择 HDMI 输出设备。

wpctl status
pavucontrol
speaker-test -c 2 -t wav