Flask应用以systemd服务运行时无法启动Chromium浏览器的问题求助及优化方案咨询

嗨，各位大神，我碰到了一个棘手的问题，想请大家帮忙看看：

我给树莓派3做了一个Flask Web应用，界面上有个简单的输入框，用来输入URL。应用的逻辑是用os.system调用Chromium浏览器，以kiosk模式打开这个URL。

本地用bash用户模式运行的时候一切正常，但把它做成systemd服务运行后，浏览器完全没反应，也看不到任何错误提示。

我的最终目标是实现通过手机或平板输入URL，让树莓派的浏览器以kiosk模式打开对应的页面，如果有更优的实现思路，也欢迎大家给我建议！

我的Flask代码： #

from flask import Flask, render_template, request
import os

app = Flask(__name__)

@app.route('/')
def index():
    return render_template('index.html')

@app.route('/open', methods=['POST'])
def open_url():
    url = request.form.get('url')
    if url:
        os.system(f"chromium-browser --kiosk {url} &")
        return f"<h1>Opening {url} in fullscreen mode</h1>"
    else:
        return "<h1>No URL provided</h1>"

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

我的systemd服务配置： #

Description=Flask Web App Service
After=network.target

[Service]
ExecStart=python3 webapp.py
WorkingDirectory=/home/scoreboard/
Restart=always
User=scoreboard
Environment="FLASK_APP=webapp.py"
Environment="PYTHONUNBUFFERED=1"

[Install]
WantedBy=multi-user.target

我已经试过几种方法了：换成root用户运行服务、调整命令后的&后台运行标记，但都没效果。

针对这个问题的分析与解决方案 #

问题根源

systemd服务默认运行在multi-user.target下，这个目标是没有图形环境上下文的——也就是说，服务进程无法访问X服务器（树莓派的图形界面），缺少DISPLAY和XAUTHORITY这两个关键环境变量，所以Chromium根本无法启动图形窗口。另外，即使指定了用户，服务进程也没有关联到当前用户的图形会话权限。

具体解决步骤

1. 修改systemd服务配置
   调整服务文件，让它依赖图形界面启动，同时添加图形环境的环境变量：

   Description=Flask Web App Service
   After=network.target graphical.target  # 依赖图形界面启动
   
   [Service]
   ExecStart=python3 webapp.py
   WorkingDirectory=/home/scoreboard/
   Restart=always
   User=scoreboard
   Environment="FLASK_APP=webapp.py"
   Environment="PYTHONUNBUFFERED=1"
   Environment="DISPLAY=:0"  # 指定X服务器的显示端口，树莓派默认是:0
   Environment="XAUTHORITY=/home/scoreboard/.Xauthority"  # 指定用户的X认证文件路径
   
   [Install]
   WantedBy=graphical.target  # 让服务在图形界面目标下启动
   

   修改完成后，执行以下命令生效：

   sudo systemctl daemon-reload
   sudo systemctl restart your-service-name.service  # 替换成你的服务名
   

2. 优化Flask中的浏览器调用逻辑
   不要用os.system，改用subprocess模块，这样可以捕获命令的错误输出，方便调试和排查问题：

   from flask import Flask, render_template, request
   import subprocess
   
   app = Flask(__name__)
   
   @app.route('/')
   def index():
       return render_template('index.html')
   
   @app.route('/open', methods=['POST'])
   def open_url():
       url = request.form.get('url')
       if url:
           # 先关闭已运行的Chromium实例，避免多窗口冲突
           subprocess.run(["pkill", "chromium-browser"], capture_output=True)
           # 启动kiosk模式的Chromium，并捕获输出
           result = subprocess.run(
               ["chromium-browser", "--kiosk", url],
               capture_output=True,
               text=True
           )
           # 如果启动失败，返回错误信息
           if result.returncode != 0:
               return f"<h1>Failed to open URL: {result.stderr}</h1>"
           return f"<h1>Opening {url} in fullscreen mode</h1>"
       else:
           return "<h1>No URL provided</h1>"
   
   if __name__ == '__main__':
       app.run(host='0.0.0.0', port=5000)
   

3. 确保用户有权限访问X服务器
   可以临时执行命令赋予scoreboard用户访问X服务器的权限：

   xhost +local:scoreboard
   

   如果要永久生效，可以把这条命令添加到/home/scoreboard/.profile文件中，这样用户每次登录图形界面都会自动获取权限。

替代方案建议

如果只是要实现“移动设备控制树莓派打开指定URL的kiosk模式”，还有这些更轻量的思路：

• MQTT协议方案：树莓派上运行一个MQTT客户端，监听指定主题；移动设备通过MQTT发送URL，客户端收到后启动Chromium。这种方式不需要Web服务，延迟更低。
• Chromium远程调试：启用Chromium的远程调试接口，通过HTTP请求控制浏览器打开URL，但配置相对复杂。
• 现成工具集成：比如用Node-RED搭建可视化流，快速实现移动设备到树莓派的命令转发，不需要自己写Flask代码。

备注：内容来源于stack exchange，提问作者Rainer Zwicklhuber