跳转到内容
Multilogin帮助中心

在 Linux 中配置 agent 的无头模式和自动启动

在 Ubuntu 中,可以创建两个 systemd 服务,让 Multilogin agent 以无头模式自动启动:一个用于 Xvfb,另一个用于 Multilogin agent。Xvfb 提供 agent 所需的虚拟显示器,systemd 则在服务器开机时自动启动两个服务。

请注意,本文以 Ubuntu 为例。其他发行版不在官方支持范围内。

第 1 步:设置 Xvfb

Xvfb(X Virtual Framebuffer)是一个显示服务器,通过在内存中创建虚拟屏幕,让图形应用在没有物理显示器的环境中运行。agent 需要它才能正常工作。

  1. 打开 Terminal
  2. 输入以下命令,创建 Xvfb 服务文件:
    sudo nano /etc/systemd/system/xvfb.service
  3. 向服务文件添加内容(记得将YOUR_USERNAME替换为你的 Linux 操作系统用户名):
    [Unit]
    Description=MLX XVFB
    After=network.target
    
    [Service]
    Type=simple
    User=YOUR_USERNAME
    ExecStart=/usr/bin/Xvfb :99 -screen 0 1920x1080x24
    Restart=always
    
    [Install]
    WantedBy=multi-user.target

    在 ExecStart 中,配置 Xvfb 的分辨率、显示器数量和目录。

  4. 按 CTRL+X,再按 Y 和 Enter,关闭并保存

第 2 步:设置 agent 自动启动

  1. 打开 Terminal
  2. 输入以下命令,创建 Xvfb 服务文件:
    sudo nano /etc/systemd/system/mlx.service
  3. 向服务文件添加内容(记得将YOUR_USERNAME替换为你的 Linux 操作系统用户名):
    [Unit]
    Description=MLX Agent
    After=xvfb.service
    Requires=xvfb.service
    
    [Service]
    Type=simple
    User=YOUR_USERNAME
    Environment=HOME=/home/YOUR_USERNAME
    Environment=DISPLAY=:99
    ExecStartPre=-/usr/bin/pkill -9 -f mlx
    ExecStartPre=-/bin/rm -f /home/YOUR_USERNAME/mlx/agent.lock /home/YOUR_USERNAME/mlx/profiles.lock /home/YOUR_USERNAME/mlx/launcher.lock
    ExecStart=/usr/bin/mlx
    Restart=on-failure
    RestartSec=5
    
    [Install]
    WantedBy=multi-user.target

    看看这个服务做了什么:

    在 [Unit] 中,等待 Xvfbservice,避免显示错误。
    在 [Service] 中,设置用户、home 变量和 display 变量。display 变量设在 agent 服务中,而不是 Xvfb 中,否则 agent 无法使用它。
    然后,通过 ExecStartPre 结束残留的 agent 进程,并删除 .lock 文件,这在服务重启时很有用。
    ExectStart 是 Linux 中 agent 二进制文件的路径。

  4. 按 CTRL+X,再按 Y 和 Enter,关闭并保存

第 3 步:启用并加载服务

  1. 重新加载 daemon(负责加载其他服务的后台服务):
    sudo systemctl daemon-reload
  2. 将 Xvfb 和 Multilogin agent 都启用为服务:
    sudo systemctl enable xvfb.service mlx.service
  3. 使用 systemctl(管理系统服务的实用工具)启动服务:
    sudo systemctl start xvfb.service
    sudo systemctl start mlx.service
    完成!现在,agent 和 Xvfb 都会随操作系统启动。

如何用 systemctl 管理服务

使用 systemctl 工具检查服务状态,也可以获取日志并排查问题。

检查服务状态

通过以下命令获取服务状态:

sudo systemctl status xvfb.service

你会看到 Xvfb 服务的操作。如果服务名称不同,也可以将 xvfb.service 替换为你的服务名称。

获取日志

通过 journalctl 服务获取服务日志:

journalctl -u mlx.service

还可以按行数限制日志。此命令最多显示 100 行:

journalctl -u mlx.service -n 100

也可以按时间范围限制服务日志。以下命令只显示最近 30 分钟的日志:

journalctl -u mlx.service --since "30 minutes ago"

-f 用于实时显示日志:

journalctl -u mlx.service -f

随时掌握最新动态

获取最新动态,交流经验,了解实际使用场景。

获取产品更新Telegram频道向其他用户提问Telegram聊天查看使用场景Discord社区