Chromium以Kiosk模式作为Systemd服务运行时摄像头权限异常

问题核心 #

手动运行脚本时摄像头正常，但Systemd服务启动时摄像头空白、无权限请求，本质是Systemd服务运行在非桌面会话环境，缺少X11权限上下文、媒体服务（PulseAudio/PipeWire）访问权限，且Chromium的权限配置未被正确加载。

1. 重构Systemd用户级服务配置 #

将服务改为用户级会话服务，绑定桌面会话环境，而非系统级目标：

[Unit]
Description=Chromium Kiosk Mode Launcher
# 适配桌面环境：Gnome用gnome-session.target，KDE用plasma-session.target
After=gnome-session.target
PartOf=gnome-session.target

[Service]
ExecStart=/home/EB/EBSYNC/EcoTouch_Flask_API/chromium.sh
Restart=on-failure
# 继承用户会话环境变量
Environment="DISPLAY=:0"
Environment="XDG_RUNTIME_DIR=/run/user/1000"
Environment="PULSE_RUNTIME_PATH=/run/user/1000/pulse"
User=EB
Group=EB
Type=simple
# 预授权用户访问X11显示
ExecStartPre=/bin/xhost +si:localuser:EB

[Install]
WantedBy=gnome-session.target

配置要点 #

• 将文件保存到~/.config/systemd/user/chromium-kiosk.service（用户级路径，而非/etc/systemd/system/）
• 根据桌面环境调整gnome-session.target，不确定则用graphical-session.target

2. 修改Chromium启动参数，确保权限加载 #

去掉--incognito（隐身模式不读取用户权限配置），指定固定数据目录并强制媒体权限：

#!/bin/bash 

launch_browser() {
    echo "🌍 Launching Chromium in kiosk mode..."
    chromium-browser http://localhost:3000 \
        --kiosk \
        --start-fullscreen \
        --disable-infobars \
        --noerrdialogs \
        --disable-cursor \
        --overscroll-history-navigation=0 \
        --disable-features="TouchpadOverscrollHistoryNavigation" \
        --use-fake-ui-for-media-stream \
        # 指定专属数据目录，保存权限配置
        --user-data-dir=/home/EB/.config/chromium-kiosk \
        # 授权localhost为安全源，避免权限限制
        --unsafely-treat-insecure-origin-as-secure=http://localhost:3000
}

launch_browser

初始化权限 #

手动运行一次修改后的脚本，在Chromium中手动授权localhost:3000访问摄像头，配置会自动保存到--user-data-dir指定的目录，后续Systemd启动时将直接读取。

3. 补全用户权限 #

执行以下命令确保用户具备摄像头和X11访问权限：

# 将用户加入视频组，获取摄像头访问权限
sudo usermod -aG video EB
# 临时授权用户访问X11（服务启动时会自动执行此步骤）
xhost +si:localuser:EB

4. 服务操作与调试 #

# 重载用户级Systemd配置
systemctl --user daemon-reload
# 启用并启动服务
systemctl --user enable --now chromium-kiosk.service
# 实时查看服务日志
journalctl --user -u chromium-kiosk.service -f

如果问题仍存在，在脚本中添加日志重定向：

chromium-browser ... 2>> /home/EB/chromium-kiosk-error.log &

查看日志中的权限相关报错（如Permission denied、Failed to open /dev/video0）。

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