如何为Python的rich库绑定新终端并以systemd服务运行

问题背景 #

• 在Linux环境下使用Rich库实现实时任务进度的控制台UI
• 需要从Python内部启动新终端，并将该终端上下文提供给Rich，让Rich能直接更新终端内容
• 直接运行Python脚本时布局可正常渲染，但作为systemd服务运行时，终端上下文传递出现问题
• 当前通过以下命令启动，但完全失去对GUI应用的控制权：

  gnome-terminal --window --maximize -- sudo bash -c 'export PYTHONPATH="<path to project>" && /usr/bin/python3 -m station_gui.station_gui'
  

核心解决方案思路 #

让Python进程直接关联到新启动终端的TTY设备，同时确保systemd服务能正确传递桌面环境依赖，避免权限和上下文丢失。

具体实现步骤 #

1. 启动终端时传递TTY路径给Python脚本 #

修改gnome-terminal启动命令，先获取当前终端的TTY路径，再作为参数传给Python脚本：

gnome-terminal --window --maximize -- sudo bash -c 'export TERM_TTY=$(tty); export PYTHONPATH="<path to project>" && /usr/bin/python3 -m station_gui.station_gui $TERM_TTY'

2. Python中绑定Rich到指定TTY #

在station_gui.py中接收TTY参数，创建Rich Console对象时指定该TTY作为输出目标：

import sys
from rich.console import Console
from rich.progress import Progress

def main():
    # 处理TTY参数，无参数时 fallback到当前终端
    if len(sys.argv) >= 2:
        tty_path = sys.argv[1]
        with open(tty_path, 'r+') as tty_file:
            console = Console(file=tty_file)
    else:
        console = Console()

    # 测试Rich渲染
    console.print("[bold blue]任务进度控制台已启动[/bold blue]")
    with Progress(console=console) as progress:
        task = progress.add_task("[green]处理中...", total=100)
        while not progress.finished:
            progress.update(task, advance=1)
            # 模拟任务延迟
            import time
            time.sleep(0.1)

if __name__ == "__main__":
    main()

3. 调整Systemd服务配置 #

确保systemd服务能访问桌面环境的DISPLAY和Xauthority，否则gnome-terminal无法启动。创建或修改服务文件（如/etc/systemd/system/station-gui.service）：

[Unit]
Description=Station GUI Progress Service
After=graphical.target

[Service]
User=your_username
Group=your_usergroup
Environment=DISPLAY=:0
Environment=XAUTHORITY=/home/your_username/.Xauthority
ExecStart=/bin/bash -c 'gnome-terminal --window --maximize -- sudo bash -c "export TERM_TTY=$(tty); export PYTHONPATH=\"/path/to/your/project\" && /usr/bin/python3 -m station_gui.station_gui $TERM_TTY"'
Restart=on-failure

[Install]
WantedBy=graphical.target

替换your_username、your_usergroup和/path/to/your/project为实际值。

4. 优化权限与控制权 #

避免用sudo包装整个bash命令，通过visudo给Python进程单独授权，减少权限层级：

1. 创建sudoers配置文件：

   sudo visudo -f /etc/sudoers.d/station-gui
   

2. 添加规则：

   your_username ALL=(ALL) NOPASSWD: /usr/bin/python3 -m station_gui.station_gui *
   

3. 修改systemd服务的ExecStart：

   ExecStart=/bin/bash -c 'gnome-terminal --window --maximize -- /usr/bin/sudo /usr/bin/python3 -m station_gui.station_gui $(tty)'
   

   这样可以通过Python进程PID直接发送信号（如SIGTERM）来控制服务，恢复控制权。

进阶控制方案：用pexpect实现终端交互 #

如果需要更精细的进程控制（如实时捕获输出、发送指令），可以使用pexpect库直接管理终端进程：

1. 安装依赖：

   sudo apt install python3-pexpect
   

2. Python代码示例：

   import pexpect
   
   # 启动终端并执行Python脚本
   child = pexpect.spawn('gnome-terminal --window --maximize -- bash -c "tty; exec /usr/bin/python3 -m station_gui.station_gui"')
   # 捕获TTY路径
   child.expect(r'/dev/pts/\d+')
   tty_path = child.match.group(0).decode('utf-8')
   print(f"绑定终端TTY：{tty_path}")
   
   # 示例：发送终止信号
   # child.send_signal(signal.SIGTERM)
   

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