树莓派开启Chromium-kiosk模式

### 一、准备工作
1. **系统要求**：
   - 使用 **Raspberry Pi OS with Desktop**（推荐最新版 **Bookworm**）。
   - 硬件建议：树莓派 3B+ / 4 / 5（性能更好，避免卡顿）。
2. **连接外设**：显示器、键盘、鼠标（首次配置需要）。

---

### 二、安装与配置 Chromium Kiosk 模式

#### 1. 更新系统并安装 Chromium
```bash
sudo apt update && sudo apt upgrade -y
sudo apt install chromium-browser -y
```
> 注：新版 Raspberry Pi OS 已预装 Chromium，若已存在可跳过。

#### 2. 创建自动启动脚本
编辑 `~/.config/autostart/chromium-kiosk.desktop` 文件（若目录不存在则创建）：
```bash
mkdir -p ~/.config/autostart
nano ~/.config/autostart/chromium-kiosk.desktop
```
填入以下内容（替换 `YOUR_URL` 为你的目标网页）：
```ini
[Desktop Entry]
Type=Application
Exec=/usr/bin/chromium-browser --kiosk --disable-dev-shm-usage --disk-cache-size=104857600 --no-first-run --enable-logging --v=1 YOUR_URL
Hidden=false
NoDisplay=false
X-GNOME-Autostart-enabled=true
Name=Chromium Kiosk
Comment=Start Chromium in Kiosk Mode
```
> **参数说明**：
> - `--kiosk`：全屏无地址栏模式。
> - `--disable-dev-shm-usage`：解决共享内存限制（避免崩溃）。
> - `--disk-cache-size=104857600`：设置磁盘缓存为 100MB。
> - `--no-first-run`：跳过首次运行向导。

#### 3. 禁用屏幕保护与休眠
防止屏幕自动关闭或进入休眠：
```bash
# 禁用屏幕保护
xset s off
xset -dpms
xset s noblank

# 永久生效：编辑 ~/.xprofile
echo "xset s off" >> ~/.xprofile
echo "xset -dpms" >> ~/.xprofile
echo "xset s noblank" >> ~/.xprofile
```

#### 4. 隐藏鼠标指针（可选）
安装 `unclutter` 隐藏空闲鼠标：
```bash
sudo apt install unclutter -y
echo "unclutter -idle 1" >> ~/.xprofile
```

---

### 三、开机自动启动优化（针对 Bookworm 系统）
若上述方法无效（Bookworm 使用 Wayland 而非 X11），需改用 **systemd 服务**：
1. 创建服务文件：
   ```bash
   sudo nano /etc/systemd/system/kiosk.service
   ```
2. 填入内容（替换 `YOUR_URL` 和用户 `pi`）：
   ```ini
   [Unit]
   Description=Chromium Kiosk
   Wants=graphical.target
   After=graphical.target

[Service]
   User=pi
   Environment=DISPLAY=:0
   Environment=XAUTHORITY=/home/pi/.Xauthority
   ExecStart=/usr/bin/chromium-browser --kiosk --disable-dev-shm-usage YOUR_URL
   Restart=on-failure

[Install]
   WantedBy=graphical.target
   ```
3. 启用服务：
   ```bash
   sudo systemctl enable kiosk.service
   sudo systemctl start kiosk.service
   ```

---

### 四、中文输入支持（如需交互）
若 Kiosk 需用户输入中文：
1. 安装拼音输入法：
   ```bash
   sudo apt install fcitx fcitx-pinyin -y
   im-config -n fcitx
   ```
2. 重启后按 `Ctrl+Space` 切换输入法。

---

### 五、安全与维护建议
- **禁用快捷键**：通过 `--disable-component-update --disable-translate` 等参数限制用户操作。
- **看门狗重启**：添加 systemd 监控脚本，检测到浏览器崩溃时自动重启。
- **远程管理**：开启 SSH，便于后续更新 URL 或调试。

---

### 验证步骤
1. 重启树莓派：`sudo reboot`。
2. 观察是否自动全屏打开指定网页。
3. 测试触摸/键盘交互（如需）。

> **提示**：若使用非官方镜像（如 **Chilipie-Kiosk**），可直接烧录预制系统，简化配置流程。