在 reComputer RK3576 上使用 RustDesk 实现无人值守远程访问
#介绍
RustDesk 是一款开源远程桌面软件,可用于通过网络访问和控制远程设备。在边缘 AI 和 AIoT 应用中,设备可能部署在无人值守的现场。通过 RustDesk,开发者可以远程查看 reComputer RK3576 的图形桌面、调整应用配置、检查设备运行状态,而无需每次都到现场操作。
本文介绍如何在 reComputer RK3576 上安装 RustDesk,并配置 X11 图形登录环境,实现以下远程访问场景:
- 设备已登录桌面时,远程查看和控制图形界面;
- 设备锁屏后,使用固定密码重新连接,无需现场确认;
- 设备注销或重启后,在 GDM 登录界面进行无人值守远程连接,并远程登录系统。
适用环境:reComputer RK3576、Armbian(Debian 12 Bookworm)、GNOME 43 / GDM3、RustDesk 1.2.3(ARM64),GDM 登录界面使用 X11。其他系统版本的配置方式可能不同。
#开始使用
在开始之前,请准备以下硬件、软件和网络条件。
#硬件准备
- reComputer RK3576 一台;
- 一台用于发起远程连接的 Windows 电脑;
- RK3576 与 Windows 电脑的网络连接(可访问 RustDesk 所需服务);
- 建议准备 HDMI 显示器及键盘,用于首次配置和测试;本文验证的是无人值守访问。
#软件准备
| 设备 | 软件/系统 | 本文使用的版本 |
|---|---|---|
| reComputer RK3576 | Armbian / Debian 12 Bookworm | Debian 12,ARM64 |
| reComputer RK3576 | GNOME + GDM3 + Xorg | GNOME 43 / GDM3 |
| reComputer RK3576 | RustDesk Linux ARM64 .deb | 1.2.3 |
| Windows 电脑 | RustDesk Windows 客户端 | 官方 Windows x86-64 安装包 |
本文使用 RustDesk 1.2.3,是为了保持与实机验证环境一致。其他版本可参考 RustDesk 官方发布页,但应重新验证其登录前访问行为。
官方资源:
#安装步骤
#步骤 1:在 RK3576 上下载 RustDesk ARM64 安装包
先通过 SSH 登录 RK3576,确认系统架构:
cat /etc/os-release
dpkg --print-architecture本次测试平台架构为 arm64,因此需要 Linux / Ubuntu / Debian 对应的 AArch64 (ARM64) .deb 安装包,而不是 Windows EXE 或 x86-64 包。
从 RustDesk 1.2.3 官方发布页面 获取 rustdesk-1.2.3-aarch64.deb,也可以在 RK3576 终端直接执行:
cd ~
wget https://github.com/rustdesk/rustdesk/releases/download/1.2.3/rustdesk-1.2.3-aarch64.deb检查下载结果:
ls -lh rustdesk-1.2.3-aarch64.deb
dpkg-deb --info rustdesk-1.2.3-aarch64.deb#步骤 2:安装并启动 RustDesk 系统服务
在安装包所在目录执行:
sudo apt update
sudo apt install ./rustdesk-1.2.3-aarch64.deb安装完成后启用并启动 RustDesk 服务:
sudo systemctl enable --now rustdesk
systemctl status rustdesk --no-pager正常情况下,应看到:
Loaded: loaded (.../rustdesk.service; enabled; ...)
Active: active (running)也可以检查安装的版本:
dpkg -l | grep rustdesk注意:RustDesk 的系统服务正常运行,只说明软件后台服务已启动;能否在锁屏或登录界面远程操作,还需要完成后面的 X11 配置与连接测试。
#步骤 3:将 GDM 登录界面配置为 X11
RustDesk 官方 Linux 文档说明,访问重启或注销后的登录界面需要使用 X11 登录屏幕。本次实测使用 Debian 12 的 GDM3,配置文件为 /etc/gdm3/daemon.conf。
首先确认设备具有 Xorg 会话:
ls /usr/share/xsessions/在本次验证的系统中,可以看到 gnome-xorg.desktop。如该目录不存在,请勿直接照搬本步骤,应先确认镜像是否提供 X11 图形会话。
备份并编辑 GDM 配置文件:
sudo cp /etc/gdm3/daemon.conf /etc/gdm3/daemon.conf.bak
sudo nano /etc/gdm3/daemon.conf在 [daemon] 部分,将:
#WaylandEnable=false修改为:
WaylandEnable=false保存后确认配置:
grep '^WaylandEnable' /etc/gdm3/daemon.conf应输出:
WaylandEnable=false然后重启设备:
sudo reboot重新通过 SSH 登录,查询图形登录会话:
loginctl list-sessions找到 Debian-gdm 对应的 Session ID,再执行(将 <SESSION_ID> 替换为实际编号):
loginctl show-session <SESSION_ID> -p Name -p Type -p Class -p State本次验证成功时输出如下:
Name=Debian-gdm
Type=x11
Class=greeter
State=active这表示 GDM 登录界面已运行在 X11。Session ID 每次启动后可能变化,请以实际输出为准。
注意:如果设备切换后无法进入图形桌面,但 SSH 仍可连接,可使用
sudo cp /etc/gdm3/daemon.conf.bak /etc/gdm3/daemon.conf恢复配置并重启。本文步骤仅适用于已确认存在 Xorg 会话的 Debian 12 测试环境。
#步骤 4:获取 RK3576 的 RustDesk ID 并设置固定密码
通过 SSH 在 RK3576 上获取设备 ID:
sudo rustdesk --get-id命令将返回设备 ID。随后设置用于无人值守连接的永久密码。
如果已登录图形桌面,可以在 RustDesk 界面进入 Settings → Security → Password → Use permanent password 进行设置。
也可通过 SSH 设置密码(请使用独立的强密码):
read -rsp 'New RustDesk password: ' RD_PASSWORD; echo
sudo rustdesk --password "$RD_PASSWORD"
unset RD_PASSWORD成功后,命令会显示 Done!。上述写法避免将明文密码直接写入 Shell 历史记录,但执行期间命令行参数仍可能被具备相应权限的本地进程短暂读取;正式部署应按设备管理安全规范配置凭据。
安全提醒:请勿在公开截图中展示真实设备 ID、永久密码或客户账号信息;演示截图建议遮挡设备 ID。不要使用弱密码,也不要与 Linux 系统登录密码共用密码。
#步骤 5:在 Windows 上安装 RustDesk 客户端并连接
在 Windows 电脑访问 RustDesk 官网 或 GitHub Releases,下载与 Windows 处理器架构对应的安装包。
对于常见的 Intel/AMD 64 位 Windows 电脑,选择 x86-64 (64-bit) → Windows → EXE。注意不要选择 ARM64 的 Windows 安装包,除非电脑本身运行 Windows on ARM。
运行 Windows 版 RustDesk:
- 在远程设备 ID 输入框中输入 RK3576 的 RustDesk ID;
- 点击 Connect(连接);
- 输入步骤 4 设置的永久密码;
- 连接成功后,应能查看和操作 RK3576 的图形桌面,无需在 RK3576 本地点击确认。
#验证无人值守远程访问
本文在 RK3576 上分别验证了以下三种场景。
#1. 已登录桌面远程控制
保持 RK3576 已登录 GNOME 桌面,使用 Windows RustDesk 输入设备 ID 和永久密码连接。验证鼠标、键盘是否可以远程操作。
#2. 锁屏后重新连接
在 RK3576 图形桌面中锁屏,断开 Windows 端 RustDesk 连接,再使用相同 ID 与永久密码重新连接。验证无需本地确认即可看到锁屏页面,并能够输入 Linux 用户密码解锁。
#3. 注销或重启后访问 GDM 登录界面
通过 GNOME 系统菜单选择 Log Out(注销),或在设备上运行:
sudo reboot待系统返回 GDM 登录界面后,不要在设备本地登录,也不要点击任何本地确认提示。直接从 Windows 版 RustDesk 使用设备 ID 与永久密码建立连接,观察是否可以看到 GDM 登录界面,并远程输入 Linux 用户密码完成登录。
注意:**Log Out(注销)**与 **Power Off(关机)**不同。关机会停止操作系统和 RustDesk 服务,不能在设备断电时通过 RustDesk 连接。本步骤验证的是设备正常开机、网络连接可用、RustDesk 服务运行时的无人值守访问。
在上述 Debian 12 / X11 测试环境中,已确认能够通过 RustDesk 直接访问 GDM 登录界面,无需本地确认,并能够完成远程登录。
#常见问题
1. 通过 SSH 执行 rustdesk 时提示 Gtk-WARNING: cannot open display
SSH 文本会话没有图形显示环境时,直接启动 RustDesk GUI 可能出现该提示。这不代表 RustDesk 后台服务安装失败。可先通过 systemctl status rustdesk --no-pager 检查服务状态,并通过命令行获取 ID、配置密码。
2. GDM 登录界面无法远程访问
确认重启后 Debian-gdm 会话的 Type 为 x11。只看到 Xwayland 进程并不等同于 GDM 已运行在 X11。对于本文 Debian 12 环境,应检查 /etc/gdm3/daemon.conf 中的 WaylandEnable=false 是否已启用。
3. RustDesk 报告设备离线
检查 RK3576 是否已启动并连接网络,使用 SSH 检查 rustdesk.service 状态,并确认设备 ID。设备刚重启时可等待网络与 RustDesk 服务恢复后再连接。
4. 安装时提示 Unsupported file ./rustdesk-...deb given on commandline
通常应先检查当前目录是否存在安装包、文件是否完整。使用 ls -lh 和 dpkg-deb --info 核对后,再执行 sudo apt install ./rustdesk-...deb。
#总结
通过以上配置,reComputer RK3576 能够在已验证的 Debian 12 / GDM X11 环境中实现 RustDesk 无人值守远程访问:包括桌面远程控制、锁屏后重新连接,以及重启后访问 GDM 登录界面。该功能可以用于远程维护部署在商店、实验室或其他现场的 Edge AI / AIoT 设备,减少日常运维时对本地显示器和键盘操作的依赖。
#参考资料
#技术支持与产品讨论
感谢您选择 Seeed Studio 产品。如果您在使用 reComputer RK3576 时遇到问题,可通过 Seeed Studio 官方 Wiki 查找相关文档与支持资源。