玩客云Armbian Kiosk信息看板配置教程

2026.10.14

研究背景 Background

玩客云（S805 芯片，1GB 内存，8GB eMMC）是一款低成本 ARM 盒子，刷入 Armbian 后可配置为开机自动全屏显示 Home Assistant 网页的 Kiosk 信息看板。本文记录从刷机到 Kiosk 模式配置的完整过程，包含刷机、网络、图形界面、浏览器配置、中文字体及常见问题处理。

The OneCloud (S805 chip, 1GB RAM, 8GB eMMC) is a low-cost ARM box. After flashing Armbian, it can be configured as a Kiosk information display that automatically shows a Home Assistant web page in fullscreen on boot. This article documents the complete process from flashing to Kiosk mode configuration, including flashing, networking, graphical interface, browser setup, Chinese fonts, and common issues.

参考资料 References

• hzyitc/armbian-onecloud Releases
• Armbian 官方文档
• Linux Mirrors 一键换源
• Firefox ESR Kiosk 模式

技术总结 Technical Summary

通过 USB Burning Tool 将 Armbian minimal 线刷包刷入玩客云 eMMC，系统初始化后安装 Xorg + Openbox 图形界面和 Firefox ESR 浏览器，配置 LightDM 自动登录和 Openbox 自启动脚本实现开机全屏 Kiosk 模式。玩客云性能有限（1GB 内存），需注意散热和进程优化，视频流建议使用子码流降低解码压力。

细节 Details

一、硬件准备

二、刷入 Armbian

2.1 下载镜像

从 hzyitc/armbian-onecloud 的 Releases 页面下载 minimal 线刷包，文件名类似：

1

Armbian-unofficial_24.5.0-trunk_Onecloud_bookworm_edge_6.7.9_minimal.burn.img.xz

下载后解压得到 .img 文件。

2.2 使用 USB Burning Tool 刷机

1. 安装 USB Burning Tool v2.1.6.8（或更高版本）。
2. 打开软件，导入解压后的 .img 文件。
3. 取消勾选”擦除 flash”和”擦除 bootloader”（如果失败可尝试勾选）。
4. 用 USB 公对公线连接电脑和玩客云靠近 HDMI 的 USB 口。
5. 让玩客云进入刷机模式：
   • V1.3：用镊子短接主板触点，再通电。
   • V1.0：按住复位键，再通电。
6. 电脑识别后点击”开始”，等待进度到 100%，点击”停止”，拔线。

   常见错误 0x10102002（初始化 DDR 失败）通常是线材或 USB 口问题，换线、换后置 USB 2.0 口重试。

2.3 首次启动

刷完后插入网线和电源，等待启动。在路由器后台找到玩客云 IP，用 SSH 连接：

1
2

ssh root@<IP>
# 默认密码：1234，首次登录会要求改密码

三、系统初始化

3.1 换源

使用一键脚本切换为国内镜像：

1

bash <(curl -sSL https://linuxmirrors.cn/main.sh)

选择清华大学或中科大源。如果遇到 Armbian 源 GPG 错误，手动添加公钥：

1
2
3

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://mirrors.nju.edu.cn/armbian/armbian.key -o armbian.key
cat armbian.key | sudo gpg --dearmor -o /etc/apt/keyrings/armbian.gpg

编辑 /etc/apt/sources.list.d/armbian.list，在 deb 后加上：

1

[signed-by=/etc/apt/keyrings/armbian.gpg]

3.2 更新系统

1

sudo apt update && sudo apt upgrade -y

四、连接 WiFi

插入小米随身 WiFi（MT7601U），系统通常免驱识别。

使用 nmtui（推荐）：

1

sudo nmtui

选择 Activate a connection → 找到 WiFi → 输入密码 → 连接。

或使用 nmcli：

1

sudo nmcli dev wifi connect "你的WiFi名称"

连接成功后用 ip a 查看 wlan0 是否获得 IP。如果 IP 经常变，可在路由器后台将玩客云 MAC 绑定固定 IP。

五、安装图形界面

5.1 安装 Xorg 和 Openbox

1

sudo apt install xorg openbox -y

5.2 允许普通用户启动 X

编辑 /etc/X11/Xwrapper.config，将 allowed_users=console 改为：

1

allowed_users=anybody

5.3 测试启动

1

startx

看到灰色屏幕 + 鼠标说明成功。

六、安装浏览器并配置 Kiosk 模式

6.1 安装 Firefox ESR

1

sudo apt install firefox-esr -y

Falkon 在 ARM 上问题较多，推荐 Firefox ESR。

6.2 配置 Openbox 自动启动

1
2

mkdir -p ~/.config/openbox
nano ~/.config/openbox/autostart

写入：

1
2
3
4
5

#!/bin/bash
xset -dpms &
xset s off &
sleep 10
firefox-esr --kiosk "http://YOUR_HA_IP:8123" &

赋予执行权限：

1

chmod +x ~/.config/openbox/autostart

6.3 配置 LightDM 自动登录

1

sudo nano /etc/lightdm/lightdm.conf

添加：

1
2
3

[Seat:*]
autologin-user=YOUR_USERNAME
autologin-user-timeout=0

6.4 重启验证

1

sudo reboot

重启后应自动登录并全屏显示 HA 页面。

七、中文字体配置

1
2

sudo apt install fonts-wqy-zenhei fonts-wqy-microhei fonts-noto-cjk -y
sudo fc-cache -fv

在 Firefox 地址栏输入 about:preferences，在字体中将默认字体设为 WenQuanYi Micro Hei 或 Noto Sans CJK SC。

八、常见问题与解决

8.1 视频流无法播放

Firefox ESR 默认缺少 H.264 解码器，安装 ffmpeg：

1

sudo apt install ffmpeg -y

重启 Firefox。若仍不行，在 HA 中将摄像头流改为子码流（如 stream2），降低分辨率。

8.2 系统卡顿、CPU 温度高

• 关闭 VNC 等不必要服务
• 降低显示分辨率：xrandr --output HDMI-1 --mode 1280x720
• 在 Firefox about:config 中减少进程数：dom.ipc.processCount 设为 2
• 加装散热片或小风扇

8.3 VNC 远程控制（可选）

1
2

sudo apt install x11vnc -y
sudo x11vnc -storepasswd /etc/x11vnc.pwd

创建 systemd 服务，ExecStart 中加入 -auth /var/run/lightdm/root/:0，用 VNC 客户端连接 IP:5900。

九、关键命令速查

1
2
3
4
5
6
7
8
9
10
11
12

# 启动浏览器
DISPLAY=:0 firefox-esr --kiosk "http://YOUR_HA_IP:8123" &

# 查看网络
ip -br a
nmcli device status

# 查看温度
armbianmonitor -m

# 重启图形界面
sudo systemctl restart lightdm