在 Linux 中配置 agent 的无头模式和自动启动
在 Ubuntu 中,可以创建两个 systemd 服务,让 Multilogin agent 以无头模式自动启动:一个用于 Xvfb,另一个用于 Multilogin agent。Xvfb 提供 agent 所需的虚拟显示器,systemd 则在服务器开机时自动启动两个服务。
请注意,本文以 Ubuntu 为例。其他发行版不在官方支持范围内。
第 1 步:设置 Xvfb
Xvfb(X Virtual Framebuffer)是一个显示服务器,通过在内存中创建虚拟屏幕,让图形应用在没有物理显示器的环境中运行。agent 需要它才能正常工作。
- 打开 Terminal
- 输入以下命令,创建 Xvfb 服务文件:
sudo nano /etc/systemd/system/xvfb.service - 向服务文件添加内容(记得将
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 的分辨率、显示器数量和目录。
- 按 CTRL+X,再按 Y 和 Enter,关闭并保存
第 2 步:设置 agent 自动启动
- 打开 Terminal
- 输入以下命令,创建 Xvfb 服务文件:
sudo nano /etc/systemd/system/mlx.service - 向服务文件添加内容(记得将
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 二进制文件的路径。 - 按 CTRL+X,再按 Y 和 Enter,关闭并保存
第 3 步:启用并加载服务
- 重新加载 daemon(负责加载其他服务的后台服务):
sudo systemctl daemon-reload - 将 Xvfb 和 Multilogin agent 都启用为服务:
sudo systemctl enable xvfb.service mlx.service - 使用
systemctl(管理系统服务的实用工具)启动服务:完成!现在,agent 和 Xvfb 都会随操作系统启动。sudo systemctl start xvfb.service sudo systemctl start mlx.service
如何用 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