如何实现树莓派开机自动全屏启动Web应用（街机机柜项目）

针对Raspberry Pi 4B/3B运行Raspberry Pi OS的场景，按以下步骤操作即可实现需求：

1. 配置自动登录（跳过系统认证） #

方式1：用raspi-config图形化配置（推荐） #

• 终端执行命令：sudo raspi-config
• 依次选择 System Options → Boot / Auto Login
• 选择 Desktop Autologin（需依赖桌面环境运行浏览器），按提示完成配置后重启树莓派

方式2：手动修改配置文件 #

• 编辑lightdm配置：sudo nano /etc/lightdm/lightdm.conf
• 找到[Seat:*]段，修改为：

  autologin-user=pi
  autologin-user-timeout=0
  

  （若你的用户名不是pi，替换成实际用户名）
• 按Ctrl+O保存，Ctrl+X退出，重启生效

2. 设置开机自动全屏启动浏览器 #

以系统自带的Chromium为例，配置桌面自启动：

• 创建自启动目录（若不存在）：mkdir -p ~/.config/autostart
• 创建自启动配置文件：nano ~/.config/autostart/chromium-kiosk.desktop
• 写入以下内容，替换http://your-web-app-url为你的Web应用地址：

  [Desktop Entry]
  Type=Application
  Name=Chromium Kiosk
  Exec=chromium-browser --kiosk --start-fullscreen --noerrdialogs --disable-infobars --disable-session-crashed-bubble --disable-features=TranslateUI http://your-web-app-url
  Hidden=false
  NoDisplay=false
  X-GNOME-Autostart-enabled=true
  

• 保存退出后重启，树莓派会自动全屏打开指定Web应用

3. 街机场景优化 #

• 禁用屏幕休眠：执行sudo raspi-config，选择 Display Options → Screen Blanking，设置为Disable
• 隐藏鼠标指针：安装工具sudo apt install unclutter，然后在自启动目录新建unclutter.desktop文件，写入：

  [Desktop Entry]
  Type=Application
  Name=Unclutter
  Exec=unclutter -idle 0.1 -root
  X-GNOME-Autostart-enabled=true
  

• 本地Web应用服务自启：如果Web应用在树莓派本地运行（如Nginx、Flask服务），执行sudo systemctl enable [服务名]设置开机自启（例如Nginx：sudo systemctl enable nginx）

内容的提问来源于stack exchange，提问作者ThrowsError