
Linux XFCE 桌面Chromium虚拟键盘配置指南一、环境说明系统Ubuntu/Debian 系列桌面XFCE用户root全程 root 权限操作核心需求浏览器自启、虚拟键盘适配、开机无手动操作二、前期准备必做确保系统已安装 XFCE 桌面环境若未安装执行以下命令aptupdateaptinstall-yxfce4 lightdm# 开启 root 自动登录nano/etc/lightdm/lightdm.conf# 添加/修改autologin-userrootsource/etc/lightdm/lightdm.confreboot三、第一部分安装虚拟键盘Onboard 开机自启1. 安装虚拟键盘aptupdateaptinstall-yonboard2. 测试虚拟键盘onboard# 弹出键盘即为安装成功3. 配置虚拟键盘开机自启# 创建自启文件vi~/.config/autostart/onboard.desktop写入以下内容保存退出CtrlO保存CtrlX退出[Desktop Entry] TypeApplication NameOnboard Execonboard Hiddenfalse NoDisplayfalse X-GNOME-Autostart-enabledtrue4. 赋予权限chmodx ~/.config/autostart/onboard.desktop# 解决 root 图形权限问题echoxhost local:root/etc/profilesource/etc/profile四、第二部分安装 Chromium 浏览器 开机自启固定页面1. 安装 Chromiumaptupdateaptinstall-ychromium-browser2. 配置浏览器开机自启固定目标页面vi~/.config/autostart/chromium.desktop写入以下内容[Desktop Entry] TypeApplication NameChromium Execbash -c sleep 2; chromium-browser --no-sandbox --no-first-run --disable-restore-session-state --disable-infobars https://doc.yztiot.com/docs/yzt_A133_v17_public Hiddenfalse NoDisplayfalse X-GNOME-Autostart-enabledtrue3. 赋予权限chmodx ~/.config/autostart/chromium.desktop五、第三部分替换开机 logo可选1. 准备 logo 文件格式32 位 BMP 格式尺寸适配设备屏幕7寸/10.1寸均为 1024x6002. 替换操作示例 logo_update bootlogo.bmpreboot六、第四部分官方文档访问A133/TS 系列1. 文档地址https://doc.yztiot.com/docs/yzt_A133_v17_public2. 访问密码yzt1233. 注意事项访问文档时若提示“解析失败”刷新页面重新输入密码即可确保浏览器已启动虚拟键盘可正常输入密码七、常见问题排查1. 报错 “cannot open display”xhost local:root# 临时生效# 永久生效echoxhost local:root/etc/profilesource/etc/profile2. 浏览器/虚拟键盘自启失败检查自启文件权限chmod x 文件名确认自启文件路径~/.config/autostart/3. logo 替换后不显示确认 logo 为 32 位 BMP 格式执行update-initramfs -u后重启八、总结虚拟键盘Onboard开机自启自动弹出/隐藏适配触摸屏输入Chromium开机自启固定打开指定页面无多余弹窗开机 logo替换后重启生效适配设备屏幕官方文档输入密码即可正常访问适配 A133/TS 系列设备